无需Nx等monorepo工具,如何为Angular CLI生成的库配置自定义路径
实现可行性说明
完全可以在不引入Nx或其他第三方monorepo工具的前提下,仅通过Angular CLI原生配置能力,实现目标目录结构:自定义库存放在libs目录、可独立运行的应用存放在projects目录。
具体操作步骤
1. 初始化目标目录结构
在项目根目录下提前创建两个独立的顶级目录:
- 新建
libs文件夹,作为所有自定义库的统一存放位置 - 保留原有的
projects文件夹,作为所有可运行应用的统一存放位置
2. 调整库生成的默认路径规则
打开项目根目录下的angular.json配置文件,定位到根运行项目(即执行ng serve启动的主项目)的schematics配置块,新增针对Angular官方库生成schematic的自定义路径规则:
"@schematics/angular:library": { "path": "libs" }
这个配置的作用是,后续执行ng generate library <库名>命令时,CLI不会按照默认规则将库生成到projects/<库名>路径下,而是直接将库生成到libs/<库名>路径中。
3. 存量库迁移(如果此前已在projects目录下创建过库)
如果之前已经在projects目录中存放了已开发完成的自定义库,需要手动完成以下迁移操作:
- 将对应库的整个文件夹从
projects/<库名>剪切到libs/<库名>路径下 - 修改
angular.json中对应该库的项目配置,将root字段从原路径projects/<库名>调整为libs/<库名>,同步将sourceRoot字段调整为libs/<库名>/src - 修改对应库根目录下的
ng-package.json配置,确保打包输出路径与新的库目录位置匹配 - 同步修改
tsconfig.json中的路径映射配置,将原有指向旧projects/<库名>位置的映射规则,替换为指向新libs/<库名>的实际路径
4. 验证目录生成逻辑
完成配置后依次执行生成命令验证效果:
- 执行
ng generate library ui-button,确认库文件自动生成在libs/ui-button路径下 - 执行
ng generate application admin,确认应用项目自动生成在projects/admin路径下
CLI会自动为新生成的库补全tsconfig.json中的路径映射规则,无需手动逐项目修改。
关键注意事项
- 上述配置仅调整了库生成schematic的默认路径,应用生成schematic仍保留原有默认路径规则,刚好匹配目标目录结构
- 不要在配置中给
@schematics/angular:applicationschematic也设置libs路径,否则新建的应用也会被错误生成到libs目录下 - 所有操作均基于Angular CLI原生能力完成,未引入任何第三方monorepo依赖
内容的提问来源于stack exchange,提问作者Dmitry
相关产品推荐
相关产品推荐

