构建选项

angular-miniprogram:application 的选项表由 @angular/build:application 生成， 只保留本构建器真正落地的字段，其余一律拒绝（配置后会报校验错误，不会静默无效）。 从 1.x 升级时遇到被删除的字段见 构建选项迁移。

必填

{
  "main": "src/main.ts", // app 入口（上游叫 browser）
  "tsConfig": "src/tsconfig.app.json",
  "outputPath": "dist/my-mp",
}

tsConfig 的 files / include 必须覆盖所有入口文件与组件文件——构建器要从 编译单元中读取组件声明。未覆盖时会报「不在 tsconfig 的编译范围里」。

本包独有的选项

选项	作用
platform	目标平台，见 多平台与条件编译
pages	页面入口的 glob，见 入口
subpackages	分包入口，output 就是分包 root
customTabbar	自定义 tabBar 的源文件位置，产物目录由平台决定
appJson	结构化 app 配置源文件，见 配置文件
projectConfig	结构化 project 配置源文件
appJsonValidate	error（默认）/ warn / off
deriveCondition	按页面生成开发者工具的调试启动项，默认关
nativeComponentsDir	原生自定义组件目录，见 使用原生自定义组件
viteConfig	获取最终 vite 配置并自行修改，见 自定义 vite 配置
tagNameClass	是否为元素补充 tag-name-<原标签>，见下文
dedupe	强制单实例的包，透传 Vite resolve.dedupe
format	产物模块格式，默认 cjs；只有确认宿主支持 ESM 才改 es

与上游同名，但默认值不同

以下默认值是刻意调整的，不应按 @angular/build 的默认值推断：

选项	本构建器默认值	说明
optimization	false	开发流程依赖开发者工具查看产物目录，默认输出可读代码。需要压缩时显式设为 true 或使用 production configuration
outputHashing	none	小程序没有 HTTP 缓存，hash 只会使路径变长。需要原有行为时配置 "bundles"
sourceMap	—	对象写法（{ "scripts": true, "hidden": true }）生效，hidden 表示内嵌 map 不产 .map 文件

已支持的上游选项

assets styles stylePreprocessorOptions inlineStyleLanguage fileReplacements polyfills watch define conditions externalDependencies deleteOutputPath preserveSymlinks budgets statsJson。

以下几项具有小程序语境下的含义：

polyfills —— 每条都会被 import 进 polyfills 入口，包名与本地文件均可， 也支持字符串写法。多语言必须写全 @angular/localize/init：

"polyfills": ["@angular/localize/init"]

只写 @angular/localize 时构建可以通过，运行时报 $localize is not a function。

budgets —— 判定逻辑复用 @angular/build，口径按小程序语境解释： initial = 所有入口 JS 之和，all = 全部产物（≈ 主包体积），any = 单个文件， bundle + name = 指定 chunk。超 maximumError 构建失败。

define —— 用户常量，与平台内置 define（wx / window / ngDevMode / __MP_WX__ 等）合并，同名时平台优先，不应覆盖这些内置常量。

fileReplacements —— 两侧文件都会校验是否存在，路径错误会直接导致构建失败。 旧的 src / replaceWith 写法同样支持。

stylePreprocessorOptions —— 含上游的 sass 子项 （fatalDeprecations / silenceDeprecations / futureDeprecations），直接透传给 sass。

tagNameClass

模板中书写 div，wxml 中已是 view，样式中的 div {} 选择器因此无法命中。 构建器可以为元素补充一个 tag-name-div 的 class 作为辅助：

值	行为
mapped（默认）	仅为映射改写了标签的元素补充
all	为每个元素补充
off	不补充

该标记是编译期写入 wxml 的字面量，不占用数据通道。没有其他 class 来源的元素， 最终只有 class="tag-name-div"。

完整示例

{
  "projects": {
    "my-mp": {
      "projectType": "application",
      "root": "",
      "sourceRoot": "src",
      "architect": {
        "build": {
          "builder": "angular-miniprogram:application",
          "options": {
            "platform": "wx",
            "outputPath": "dist/my-mp",
            "main": "src/main.ts",
            "tsConfig": "src/tsconfig.app.json",
            "inlineStyleLanguage": "scss",
            "polyfills": ["@angular/localize/init"],
            "styles": ["src/styles.scss"],
            "assets": [
              {
                "glob": "project.config.json",
                "input": "./src",
                "output": "./",
              },
            ],
            "appJson": "src/app.config.json",
            "pages": [
              {
                "glob": "**/*.entry.ts",
                "input": "./src/pages",
                "output": "pages",
              },
            ],
            "subpackages": [
              {
                "glob": "**/*.entry.ts",
                "input": "./src/packageA",
                "output": "packageA",
              },
            ],
          },
          "configurations": {
            "production": {
              "optimization": true,
              "outputHashing": "none",
              "sourceMap": false,
              "budgets": [{ "type": "all", "maximumError": "2mb" }],
            },
            "development": { "optimization": false, "sourceMap": true },
          },
          "defaultConfiguration": "development",
        },
      },
    },
  },
}