Agent Skills: 微信小程序分包(subPackages)

微信小程序分包(subPackages)配置。需要将页面拆分到子包时使用

UncategorizedID: sail-sail/nest/sub-package

Install this agent skill to your local

pnpm dlx add-skill https://github.com/sail-sail/nest/tree/HEAD/uni/.agents/skills/sub-package

Skill Files

Browse the full folder contents for sub-package.

Download Skill

Loading file tree…

uni/.agents/skills/sub-package/SKILL.md

Skill Metadata

Name
sub-package
Description
微信小程序分包(subPackages)配置。需要将页面拆分到子包时使用

微信小程序分包(subPackages)

src/pages.json 中的页面从主包拆分到子包,减小主包体积。

操作步骤

  1. pages 数组中移除要拆包的页面
  2. subPackages 数组中添加子包配置(若数组不存在则创建)
  3. 对所有移入 subPackages 的页面, 都需要把页面路径改成相对 root 的路径:去掉目录前缀,只保留文件名

格式说明

// 拆包前 - pages 数组中
{
  "path": "pages/agreement/UserAgreement",
  "style": { "navigationBarTitleText": "用户协议" }
}

// 拆包后 - subPackages 数组中
{
  "root": "pages/agreement",   // 子包根目录
  "name": "agreement",         // 子包名称(取目录名)
  "pages": [
    {
      "path": "UserAgreement", // 仅文件名,不含目录前缀
      "style": { "navigationBarTitleText": "用户协议" }
    }
  ]
}

规则

  1. 子包配置字段:root 为子包根目录,即 pages/{目录名}name 取目录名;path 为相对于 root 的页面路径(即只保留文件名部分)
  2. 页面归组方式:同一目录下的多个页面归入同一个子包
  3. 必须留在主包的页面:tabBar 页面不能放入子包;首页(pages 数组第一项)不能放入子包