微信小程序分包(subPackages)
将 src/pages.json 中的页面从主包拆分到子包,减小主包体积。
操作步骤
- 从
pages数组中移除要拆包的页面 - 在
subPackages数组中添加子包配置(若数组不存在则创建) - 对所有移入
subPackages的页面, 都需要把页面路径改成相对root的路径:去掉目录前缀,只保留文件名
格式说明
// 拆包前 - pages 数组中
{
"path": "pages/agreement/UserAgreement",
"style": { "navigationBarTitleText": "用户协议" }
}
// 拆包后 - subPackages 数组中
{
"root": "pages/agreement", // 子包根目录
"name": "agreement", // 子包名称(取目录名)
"pages": [
{
"path": "UserAgreement", // 仅文件名,不含目录前缀
"style": { "navigationBarTitleText": "用户协议" }
}
]
}
规则
- 子包配置字段:
root为子包根目录,即pages/{目录名};name取目录名;path为相对于root的页面路径(即只保留文件名部分) - 页面归组方式:同一目录下的多个页面归入同一个子包
- 必须留在主包的页面:tabBar 页面不能放入子包;首页(
pages数组第一项)不能放入子包