3

我的 Angular monorepo 项目中有几个应用程序。此外,我还编写了大约 5 个库以供跨应用程序使用。

我想知道的是如何更好地构建/架构这些库

ins如下:

  1. 库仅供内部使用(意味着不发布或在其他应用程序中使用,但projects文件夹中的应用程序)
  2. 库具有不同的依赖项,例如lodashRxJs
  3. 一个库可以在其内部导入另一个库

到目前为止我所做的:

  1. umdModuleIds在每个库的ng-package.json.
  2. peerDependencies在外部库上指定,例如lodashRxJs
  3. 设置我的应用程序构建,其中包含通过“&&”组合prebuild的大约 5 个命令ng build lib-name
  4. 我用下一种方式导入 Lodashimport { cloneDeep } from 'lodash'

现在我看到我的main.js块比将一些服务/组件/功能提取到外部库之前要大得多。现在main.js产品构建的大小是 2.1 Mb,在我看来太大了。

另外,我不确定是否值得为每个库(UMD、FESM2015、FESM5)制作 3 个不同的版本。

我按照文档中的建议从 dist 文件夹导入库,遵循下一个表单import { LibService } from 'lib'

4

2 回答 2

9

Nrwl工具由 Angular 核心贡献者开发,专门研究企业架构,包括单声道存储库。

Nrwl nx-examples是一个很好的入门资源。

我开始使用nx构建一个新项目。最后,我的项目结构如下:

platform-directory/
  |
  ---apps/
  |  |
  |  ---app1/
  |  |
  |  ---app2/
  |
  ---library1/
  |  |
  |  ---src/
  |
  ---library2/
  |  |
  |  ---src/
  |
  ---angular.json
  |
  ---package.json
  |
  ---README.md
  |
  ---tsconfig.json

tsconfig.json

顶层tsconfig.json应包含应用程序和库的大部分全局配置以及paths需要时的快捷方式。

路径快捷方式可以配置如下:

{
  "compileOnSave": false,
  "compilerOptions": {
    "outDir": "./dist/out-tsc",
    "baseUrl": "./",
    "declaration": false,
    "downlevelIteration": true,
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "importHelpers": true,
    "module": "esnext",
    "moduleResolution": "node",
    "sourceMap": true,
    "target": "es6",
    "lib": [
      "es2018",
      "dom"
    ],
    "paths": {
      "@app1*": [
        "./apps/app1/src/app*"
      ],
      "@lib1/package1": [
        "./lib1/src/package1/public_api.ts"
      ],
      "@lib1/package2": [
        "./lib1/src/package2/public_api.ts"
      ],
     ...
}

库导入

在应用程序中,库代码可以直接从库源中导入,例如:

import { MyLibraryComponent } from '@lib1/package1'

由于您没有发布库,因此无需构建它们。当您在应用程序代码上运行 Angular 编译器时,库代码将自动包含并根据需要进行优化。

重要提示:在每个库中,不要使用路径快捷方式导入文件,因为这会导致难以调试的循环依赖关系。例如,可以在lib2其中使用:

import { MyLibraryComponent } from '@lib1/package1'

但是,如果在 中使用此导入lib1,则会创建循环依赖。

tsconfig.app.json附带说明一下,每个应用程序都将具有tsconfig.spec.json如下内容:

{
  "extends": "../../tsconfig.json",
  "compilerOptions": {
    "outDir": "../../dist/out-tsc/apps/app1"
  },
  "include": [
    "src/**/*.ts"
  ],
  "exclude": [
    "test.ts",
    "**/*.spec.ts"
  ]
}
于 2019-07-23T19:46:42.693 回答
0

特别是关于您对捆绑包大小的关注:我怀疑 Lodash 是其中的罪魁祸首。尝试lodash-es改用,并仅从您需要的包中导入。例如

import cloneDeep from 'lodash-es/cloneDeep';

这应该会大大减少lodash捆绑包中的数量,但它仍然不会像大多数用例那样小。为此,我专门制作了一个库,名为micro-dash. 例如,它包括cloneDeep,正如文档所说,它添加397 bytes到您的包中(大致 - 它取决于多个因素),而 lodash 版本添加12,289 bytes.

不过,最终,要对超大包进行故障排除,您应该确切地看到每个库添加了多少。那是境界source-map-explorer。绝对在您的最终产品包上运行它,并首先解决最严重的违规者!

于 2020-09-16T01:21:01.943 回答