Files
persionalBrand/docs/adr/0013-template-package-build-architecture.md

938 B

0013 模板包与构建期生成

Context

视觉模板可能扩展到数百个。将每个模板直接写入 apps/miniapp 会造成主工程膨胀、依赖耦合和无法独立回归。

Decision

每个视觉模板是独立 pnpm workspace/npm package。模板包声明 runtime contract、页面入口、导航和能力依赖。构建期由 template-compiler 选择一个模板包,生成微信小程序目录;运行时不下载或执行模板代码。

Consequences

  • 单次小程序构建只包含一个模板包,控制包体和维护范围。
  • 本地开发使用 pnpm workspace,不需要先发布私服。
  • CI/生产构建使用锁定的模板包版本。
  • Runtime Contract 必须版本化,破坏性变更进入新主版本。

Migration plan

先迁移林境和阿成,再删除 apps/miniapp 中模板专属 renderer;公共 runtime 保留在 shell 包中,模板包只消费 Runtime Workspace。