用途:这是 Ignite UI for Angular 仓库核心库及相关包的构建速查参考,用于在开发、验证和本地消费场景下执行正确的构建命令。
前置条件:执行任何构建命令前,需先在仓库根目录运行 npm install。
完整构建:npm run build,按顺序运行所有子构建(库、elements、schematics、migrations、i18n、extras),适用于需要完整可发布产物或在本地运行完整 CI 流程前。具体顺序以 package.json 为准。
库构建(最常用):npm run build:lib,包含两步:ng build igniteui-angular --configuration production(使用 ng-packagr 与 Angular Package Format,采用 ng-package.prod.json 生产配置)以及 npm run build:styles(运行 node scripts/build-styles.mjs 将 Sass 主题编译打包为可分发的 CSS)。输出目录为 dist/igniteui-angular/。适用于实现功能或修复后验证编译、检查新公开符号是否正确导出,以及供其他项目消费本地构建。
部分构建:build:styles 仅编译 Sass 主题(已包含在 build:lib 中);build:extras 构建 extras 包并运行其迁移;build:schematics 复制并编译 ng add schematics;build:migrations 复制并编译 ng update 迁移 schematics,运行 test:schematics 前必需;build:i18n 编译 i18n 包;build:elements 构建 Angular Elements 包并打包、复制样式;build:docs 生成 TypeDoc 与 SassDoc 文档。
关键路径:projects/igniteui-angular/ 为库源码根;ng-package.prod.json 为生产 ng-packagr 配置;ng-package.json 为开发配置(保留 dest);dist/igniteui-angular/ 为构建输出;scripts/build-styles.mjs 为 Sass 主题编译脚本。
限制:资料未提供各命令的耗时、依赖版本要求或失败排查说明。