小程序的配置

全局配置

小程序根目录下 app.json 文件对小程序进行全局配置

属性	类型	必填	描述	最低版本
entryPagePath	string	n	设置默认启动首页页面路径
pages	string[]	y	页面路径列表
window	Object	n	全局默认窗口样式
tabBar	Object	n	底部tab栏样式
networkTimeout	Object	n	网络超时时间
debug	boolean	n	是否开启debug模式
functionalPages	boolean	n	开启插件功能页功能	2.1.0
subpackages	Object[]	n	分包结构配置	1.7.3

分包加载

微信客户端 6.6.0，基础库 1.7.3 及以上版本开始支持。

将小程序划分成不同的子包，在构建时打包成不同的分包，用户在使用时按需进行加载。

构建小程序分包项目时，构建会输出一个或多个分包。每个使用分包小程序必定含有一个主包。所谓的主包，即放置默认启动页面/TabBar 页面，以及一些所有分包都需用到公共资源/JS 脚本的包；而分包则是根据开发者的配置进行划分。

    在小程序启动时，默认会下载主包并启动主包内页面，当用户进入分包内某个页面时，
        客户端会把对应分包下载下来，下载完成后再进行展示。

目前小程序分包大小有以下限制：

• 整个小程序所有分包大小不超过 20M
• 单个分包/主包大小不能超过 2M
• 对小程序进行分包，可以优化小程序首次启动的下载时间，以及在多团队共同开发时可以更好的解耦协作。

分包配置

文件结构：

├── app.js
├── app.json
├── app.wxss
├── packageA
│   └── pages
│       ├── cat
│       └── dog
├── packageB
│   └── pages
│       ├── apple
│       └── banana
├── pages
│   ├── index
│   └── logs
└── utils
packageA 无法 require packageB JS 文件，但可以 require app、自己 package 内的 JS 文件；
          使用 分包异步化 时不受此条限制
packageA 无法 import packageB 的 template，但可以 require app、自己 package 内的 template
packageA 无法使用 packageB 的资源，但可以使用 app、自己 package 内的资源

对应的app.json中的subpackages字段的配置：

{
  "pages":[
    "pages/index",
    "pages/logs"
  ],
  
  "subpackages": [
    {
      "root": "packageA",
      "pages": [
        "pages/cat",
        "pages/dog"
      ]
    }, {
      "root": "packageB",
      "name": "pack2",
      "pages": [
        "pages/apple",
        "pages/banana"
      ]
    }
  ]
  
}

    每个分包中的配置：

{
      "root": "packageB",//声明该分包的根目录名
      "name": "pack2",//设置分包的别名,**分包预下载**时使用
      "pages": [   // 分包的页面路径，相对于分包的根目录
        "pages/apple",
        "pages/banana"
      ]
      independent: true,//是否是**独立分包**：不依赖于主页面，可以单独运行
    }
    **分包预下载**
        预下载分包行为在进入某个页面时触发，通过在 app.json 增加 preloadRule 配置来控制。
{
  "pages": ["pages/index"],
  "subpackages": [
    {
      "root": "important",
      "pages": ["index"],
    },
    {
      "root": "sub1",
      "pages": ["index"],
    },
    {
      "name": "hello",
      "root": "path/to",
      "pages": ["index"]
    },
    {
      "root": "sub3",
      "pages": ["index"]
    },
    {
      "root": "indep",
      "pages": ["index"],
      "independent": true
    }
  ],
  "preloadRule": {
    "pages/index"//页面路径: {
      "network": "all",//all:不限制网络环境;wifi: 仅在wifi下预下载
      "packages": ["important"]//进入页面后对应预下载的分包root或name值；特殊：__APP__ 表示主包
    }//预下载配置
    限制
同一个分包中的页面享有共同的预下载大小限额 2M，限额会在工具中打包时校验。
如，页面 A 和 B 都在同一个分包中，A 中预下载总大小 0.5M 的分包，
B中最多只能预下载总大小 1.5M 的分包。
    ,
    "sub1/index": {
      "packages": ["hello", "sub3"]
    },
    "sub3/index": {
      "packages": ["path/to"]
    },
    "indep/index": {
      "packages": ["__APP__"]
    }
  }
}
preloadRule 中，key 是页面路径，value 是进入此页面的预下载配置，每个配置有以下几项

    **独立分包**
    限制：1、独立分包中不能依赖主包和其他分包中的文件和样式。2、不能定义App。3、不支持使用插件
    4、基础库 2.2.4 版本开始 getApp 支持 [allowDefault] 参数，在 App 未定义时返回一个默认实现。
    当主包加载，App 被注册时，默认实现中定义的属性会被覆盖合并到真正的 App 中。
    如：
    const app = getApp({allowDefault: true}) // {}
    于独立分包中无法定义 App，小程序生命周期的监听可以使用 wx.onAppShow，wx.onAppHide 完成。
    App 上的其他事件可以使用 wx.onError，wx.onPageNotFound 监听。
    在低于 6.7.2 版本的微信中运行时，独立分包视为普通分包处理，不具备独立运行的特性。

属性	类型	必填	描述	最低版本
workers	string	n	Worker代码放置的目录	1.9.90
requiredBackgroundModes	string[]	n	需要在后台使用的能力【后台音乐、定位】
plugins	Object	n	使用到的插件	1.9.6
resizable	boolean	n	是否允许pc小程序改变窗口大小或ipad旋转屏幕	2.3.0

workers

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

属性	类型	必填	描述	最低版本
usingComponents	Object	n	在组件的json文件中声明是否为组件	开发1.02.1810190