小程序根目录下 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 脚本的包;而分包则是根据开发者的配置进行划分。
在小程序启动时,默认会下载主包并启动主包内页面,当用户进入分包内某个页面时, 客户端会把对应分包下载下来,下载完成后再进行展示。
目前小程序分包大小有以下限制:
文件结构:
├── 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 |
使用Worker做多线程任务时设置Worker代码放置的目录
属性 | 类型 | 必填 | 描述 | 最低版本 |
---|---|---|---|---|
usingComponents | Object | n | 在组件的json文件中声明是否为组件 | 开发1.02.1810190 |