# 全局配置

小程序根目录下的 app.json 文件用来对 QQ 小程序进行全局配置，决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。

# 配置示例

以下是一个包含了部分常用配置选项的 app.json ：

{
  "pages": ["pages/index/index", "pages/logs/index"],
  "window": {
    "navigationBarTitleText": "Demo"
  "tabBar": {
    "list": [
        "pagePath": "pages/index/index",
        "text": "首页"
        "pagePath": "pages/logs/logs",
        "text": "日志"
  "networkTimeout": {
    "request": 10000,
    "downloadFile": 10000
  "debug": true,
  "navigateToMiniProgramAppIdList": ["qqe5f52902cf4de896"],
  "groupIdList": ["123456", "34356576", "457658769"]

# app.json 配置项列表

# pages

用于指定小程序由哪些页面组成，每一项都对应一个页面的 路径+文件名 信息。文件名不需要写文件后缀，框架会自动去寻找对于位置的 .json , .js , .qml , .qss 四个文件进行处理。

数组的第一项代表小程序的初始页面（首页）。小程序中新增/减少页面，都需要对 pages 数组进行修改。

如开发目录为：

├── app.js
├── app.json
├── app.qss
├── pages
│   │── index
│   │   ├── index.qml
│   │   ├── index.js
│   │   ├── index.json
│   │   └── index.qss
│   └── logs
│       ├── logs.qml
│       ├── logs.json
│       └── logs.js
└── utils

则需要在 app.json 中写

{
  "pages": ["pages/index/index", "pages/logs/logs"]

# window

用于设置小程序的状态栏、导航条、标题、窗口背景色。

• 注 1：HexColor（十六进制颜色值），如"#ff00ff"
• 注 2：关于 navigationStyle

如 app.json ：

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

# tabBar

如果小程序是一个多 tab 应用（客户端窗口的底部或顶部有 tab 栏可以切换页面），可以通过 tabBar 配置项指定 tab 栏的表现，以及 tab 切换时显示的对应页面。

其中 list 接受一个数组， 只能配置最少 2 个、最多 5 个 tab 。tab 按数组的顺序排序，每个项都是一个对象，其属性值如下：

# networkTimeout

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

# debug

可以在开发者工具中开启 debug 模式，在开发者工具的控制台面板，调试信息以 info 的形式给出，其信息有 Page 的注册，页面路由，数据更新，事件触发等。可以帮助开发者快速定位一些常见的问题。

# subpackages

启用 分包加载 时，声明项目分包结构。

写成 subPackages 也支持。

# workers

使用 Worker 处理多线程任务时，设置 Worker 代码放置的目录

# requiredBackgroundModes

申明需要后台运行的能力，类型为数组。目前支持以下项目：

• audio : 后台音乐播放

如：

{
  "pages": ["pages/index/index"],
  "requiredBackgroundModes": ["audio"]

注：在此处申明了后台运行的接口，开发版和体验版上可以直接生效，正式版还需通过审核。

# preloadRule

声明 分包预下载 的规则。

# navigateToMiniProgramAppIdList

当小程序需要使用 qq.navigateToMiniProgram 接口跳转到其他小程序时，需要先在配置文件中声明需要跳转的小程序 appId 列表，最多允许填写 10 个。

# groupIdList

当小程序中使用 button 组件打开群资料卡时使用，需要先在配置文件中声明需要跳转的小程序 groupId 列表，最多允许填写 10 个。

# permission

小程序 接口权限 相关设置。字段类型为 Object ，结构为：

PermissionObject 结构

如：

{
  "pages": ["pages/index/index"],
  "permission": {
    "scope.userLocation": {
      "desc": "你的位置信息将用于小程序位置接口的效果展示"