uniapp命令行分包

uniapp 命令行分包操作指南

在 uniapp 项目中，可以通过命令行工具实现分包操作，以优化应用体积和加载速度。以下是具体方法：

修改 manifest.json 配置

在项目根目录的 manifest.json 文件中，添加或修改 subPackages 配置项，定义分包结构：

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

运行命令行分包

通过 cli 工具执行分包构建，以下为常见命令：

# 开发环境分包构建（微信小程序）
npm run dev:mp-weixin -- --subpackages

# 生产环境分包构建（微信小程序）
npm run build:mp-weixin -- --subpackages

验证分包结果

构建完成后，检查 dist/dev/mp-weixin 或 dist/build/mp-weixin 目录，确认 subpackages 文件夹是否生成。分包文件应包含在独立的子目录中，例如：

dist/
  └── build/
      └── mp-weixin/
          ├── subpackageA/
          ├── subpackageB/
          └── main/ (主包)

分包加载测试

在开发者工具中运行分包构建后的项目，通过路由跳转测试分包页面加载是否正常：

uni.navigateTo({
  url: '/subpackageA/pages/page1'
});

注意事项

• 分包路径需在 pages.json 中正确配置，否则可能导致路由失败。
• 主包大小需控制在平台限制内（如微信小程序主包不超过 2MB）。
• 静态资源需根据分包路径调整引用方式，避免路径错误。

通过以上步骤，可完成 uniapp 项目的命令行分包操作。