uniapp 项目分包

uniapp 项目分包方法

分包概念
在 uniapp 中，分包是一种优化手段，将项目代码拆分为多个子包，按需加载。主包包含核心资源和公共代码，子包则承载特定功能模块，减少首次加载时间。

配置分包
在 manifest.json 中配置分包信息，示例如下：

{
  "subPackages": [
    {
      "root": "subpackageA",
      "pages": [
        "pages/page1",
        "pages/page2"
      ]
    },
    {
      "root": "subpackageB",
      "pages": [
        "pages/page3"
      ]
    }
  ]
}

• root 指定子包根目录。
• pages 列出子包中的页面路径。

分包加载规则

• 主包必须包含 app.vue 和 pages.json。
• 分包路径不能与主包重复。
• 分包之间不能相互嵌套。

分包预加载
在 pages.json 中配置预加载规则，提升用户体验：

{
  "preloadRule": {
    "pages/index/index": {
      "network": "all",
      "packages": ["subpackageA"]
    }
  }
}

注意事项

• 分包大小限制：主包不超过 2MB，单个分包不超过 2MB（微信小程序限制）。
• 静态资源需放在分包目录内，否则会被打包到主包。
• 跨分包跳转需使用绝对路径，如 /subpackageA/pages/page1。

分包优化建议

• 将非首屏页面放入分包。
• 公共组件和工具库尽量放在主包。
• 使用条件编译处理平台差异代码。