配置小程序

1. 全局配置

app.json 文件用来对小程序进行全局配置，页面路径、窗口表现、设置网络超时时间、设置 tabbar 等；如果页面内存在的json文件，配置同样的选项，则会覆盖全局的配置（页面内的json 文件只能配置部分选项，具体可参看页面内的配置）；

以下是示例配置文件 app.json：

{
  "pages": [
    "pages/index/index",
    "pages/my/my"
  ],
  "window": {
    "navigationBarTitleText": "凡泰小程序 Demo",
    "navigationBarHideCloseButton": true, // 隐藏胶囊关闭按钮
    "navigationBarHideMoreButton": true, // 隐藏胶囊更多按钮
    "navigationStyle": "default/custom/hide"
  },
  "tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首页"
    }, {
      "pagePath": "pages/my/my",
      "text": "个人中心"
    }]
  },
  "networkTimeout": {
    "request": 10000,
  },
  "debug": true
}

1.1 app.json 配置项列表

1.2 window 全局窗口表现

用于设置小程序全局的状态栏、标题、窗口表现等。

注意

navigationStyle 只在 app.json 中生效，请勿在页面的json中配置。

示例代码

{
  "window":{
    "navigationBarBackgroundColor": "#ffffff",
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "小程序接口功能演示",
    "backgroundColor": "#eeeeee",
    "backgroundTextStyle": "light"
  }
}

1.3 tabBar tab 栏表现

tabBar 用来配置小程序底部或者顶部的 tab 导航栏的样式以及跳转的页面等。

详细配置项如下：

其中 list 是数组类型，只能配置最少2个、最多5个 tab。tab 按数组的顺序排序，每个项都是一个独立的对象，其可配置值如下：

​

1.4 networkTimeout 网络超时时间

网络请求的超时时间，单位均为毫秒。

1.5 debug

布尔类型，当配置为true时，扫码后，小程序中会增加一个信息查看按钮，可以查看 Page 的注册，页面

2. 页面配置

用于指定小程序由哪些页面组成，每一项都对应一个页面的 路径+文件名 信息，pages 数组的第一项代表小程序的首页，增加或减少页面，都需要对 pages 数组进行手动增加或减少，值得注意的是，pages 数组中的项目不能重复。

如开发目录为：

├── app.js
├── app.json
├── app.ftss
├── pages
│   │── index
│   │   ├── index.fxml
│   │   ├── index.js
│   │   ├── index.json
│   │   └── index.ftss
│   └── my
│       ├── my.fxml
│       └── my.js

则需要在 app.json 中写

{
  "pages":[
    "pages/index/index",
    "pages/my/my"
  ]
}

3. sitemap 配置

凡泰现已开放小程序内搜索，开发者可以通过 sitemap.json 配置，当用户的搜索词条触发该索引时，小程序的页面将可能展示在搜索结果中。

3.1 sitemap 配置

小程序根目录下的 sitemap.json 文件用于配置小程序及其页面是否允许被凡泰索引，文件内容为一个 JSON 对象，如果没有 sitemap.json ，则默认为所有页面都允许被索引；

sitemap.json 有以下配置项

3.2 rules 配置项

rules 配置项指定了索引规则，每项规则为一个JSON对象，属性如下所示：

matching 取值说明

3.3 配置示例

3.3.1 示例1

{
  "rules":[{
    "action": "allow",
    "page": "path/to/page",
    "params": ["a", "b"],
    "matching": "exact"
  }, {
    "action": "disallow",
    "page": "path/to/page"
  }]
}

• path/to/page?a=1&b=2 => 优先索引
• path/to/page => 不被索引
• path/to/page?a=1 => 不被索引
• path/to/page?a=1&b=2&c=3 => 不被索引
• 其他页面都会被索引

3.3.2 示例2

{
  "rules":[{
    "action": "allow",
    "page": "path/to/page",
    "params": ["a", "b"],
    "matching": "inclusive"
  }, {
    "action": "disallow",
    "page": "path/to/page"
  }]
}

• path/to/page?a=1&b=2 => 优先索引
• path/to/page?a=1&b=2&c=3 => 优先索引
• path/to/page => 不被索引
• path/to/page?a=1 => 不被索引
• 其他页面都会被索引

3.3.3 示例3

{
  "rules":[{
    "action": "allow",
    "page": "path/to/page",
    "params": ["a", "b"],
    "matching": "exclusive"
  }, {
    "action": "disallow",
    "page": "path/to/page"
  }]
}

• path/to/page => 优先索引
• path/to/page?c=3 => 优先索引
• path/to/page?a=1 => 不被索引
• path/to/page?a=1&b=2 => 不被索引
• 其他页面都会被索引

3.3.4 示例4

{
  "rules":[{
    "action": "allow",
    "page": "path/to/page",
    "params": ["a", "b"],
    "matching": "partial"
  }, {
    "action": "disallow",
    "page": "path/to/page"
  }]
}

• path/to/page?a=1 => 优先索引
• path/to/page?a=1&b=2 => 优先索引
• path/to/page => 不被索引
• path/to/page?c=3 => 不被索引
• 其他页面都会被索引

注意

• 没有 sitemap.json 则默认所有页面都能被索引
• {"action": "allow", "page": "*"} 是优先级最低的默认规则，未显式指明 "disallow" 的都默认被索引