Files
persionalBrand/packages/template-contract/README.md
T
que01andClaude Opus 5.5 a97cc860cf feat: 补齐模板编译扩展性门禁与演练模板
- 新增第二行业演练模板 drill-consultant,验证新增行业无需修改编译器和运行���
- 补充 override 冲突与显式覆盖测试,产物校验覆盖 wxss
- 修复 --template-dir 模板被误判引用其他模板组件的问题
- 修复运行时排除规则误删 TDesign 深层 src 目录,增加 miniprogram_npm 完整性回归
- 模板目录校验统一复用 template-contract,新增 template:check 并接入 pnpm check
- tabBar 配色归属模板包,清理编译器过期排除项和旧 fixture
- ADR 0015 明确对 0005/0008/0009 的替换范围

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-27 06:55:56 +08:00

1.2 KiB

Template Contract

模板包是构建期输入。模板必须声明 runtime contract、页面入口、导航、行业兼容性和能力依赖;不得在模板包中实现数据库访问、鉴权或业务状态机。

新增模板

  1. 在 packages/template-<key>/ 创建 template.json 和 miniapp/。
  2. 在 manifest 中声明 entrypoints、pages、navigation、requiredCapabilities、数据槽位、媒体槽位和面向管理员的 admin.sections。
  3. 将模板自己的页面、组件、tab 图标和 miniapp/app.json 放入模板包。页面必须提供 .js、.json、.wxml、.wxss 四个文件。
  4. 如果需要替换运行时或能力包页面,必须在 overrides 中声明目录;未声明的同路径文件会被 compiler 拒绝。
  5. 执行 pnpm generate:template-catalog --write 和 pnpm template:check。

最小可编译模板可参考 packages/template-compiler/test/fixtures/template-drill-consultant。

使用 pnpm template:dev <key> --brand <slug> 生成微信开发者工具项目。生产构建还必须提供 --appid 和 HTTPS --api。模板在构建时选择,运行时不会下载或解释模板代码。