看一個基于 Angular 的 SAP Spartacus 項目里 angular.json 的例子：

• version: The configuration-file version.

• newProjectRoot: Path where new projects are created. Absolute or relative to the workspace folder.

• defaultProject: Default project name to use in commands, where not provided as an argument. When you use ng new to create a new app in a new workspace, that app is the default project for the workspace until you change it here.

• schematics : A set of schematics that customize the ng generate sub-command option defaults for this workspace. See Generation schematics below.

• projects : Contains a subsection for each project (library or application) in the workspace, with the per-project configuration options.

Angular generation schematics are instructions for modifying a project by adding files or modifying existing files.

Angular 生成原理圖是一系列指令，用于通過添加新文件或者修改已有文件的方式來修改一個項目。

Individual schematics for the default Angular CLI ng generate sub-commands are collected in the package @schematics/angular.

ng generate 子命令各自的原理圖，在 @schematics/angular 包里維護。

Specify the schematic name for a subcommand in the format schematic-package:schematic-name; for example, the schematic for generating a component is @schematics/angular:component.

給子命令指定原理圖的語法：schematic-package + 冒號 + schematic-name，例如 @schematics/angular:component，用于生成一個 Component.

什么是 architect

Architect is the tool that the CLI uses to perform complex tasks, such as compilation and test running.

Architect 是 CLI 使用的工具，用來執行復雜任務，比如編譯代碼和運行測試。

Architect is a shell that runs a specified builder to perform a given task, according to a target configuration.

Architect 是一個 shell，運行一個特定的 builder，根據一個 target 配置來執行某種任務。

Default Architect builders and targets

Angular defines default builders for use with specific CLI commands, or with the general ng run command.

Angular 為特定的 CLI 命令定義默認 builder.

The JSON schemas that define the options and defaults for each of these default builders are collected in the
@angular-devkit/build-angular
package.

每個默認 builder 的 options 定義的 JSON schemas，定義在 @angular-devkit/build-angular 開發包里:

比如 ng serve, 執行的 builder 是 @angular-devkit/build-angular:dev-server：A development server that provides live reloading.

什么是 builder

A function that uses the Architect API to perform a complex process such as “build” or “test”. The builder code is defined in an npm package.

Builder 是一種 function，使用 Architect API 來執行復雜的流程，比如 build 或者 test. Builder 代碼定義在 npm 包里。

For example, BrowserBuilder runs a webpack build for a browser target and KarmaBuilder starts the Karma server and runs a webpack build for unit tests.

例如，BrowserBuilder 為一個 browser target 運行一個 webpack build.

The schemas configure options for the following builders.

• app-shell
• browser
• dev-server
• extract-i18n
• karma
• protractor
• server
• tslint

The architect section of angular.json contains a set of Architect targets.

angular.json 的 architect 區域包含了一系列 Architect targets.

Each target object specifies the builder for that target, which is the npm package for the tool that Architect runs.

每個 target 都指定一個 builder，該 builder 為該 target 服務。builder 的實現位于一個 npm package 里。

The npm package for the build tool used to create this target. The default builder for an application (ng build myApp) is @angular-devkit/build-angular:browser, which uses the webpack package bundler.

默認使用 webpack 的 package bundler 來完成 ng build.

Note that a different builder is used for building a library (ng build myLib).

The architect/extract-i18n section configures defaults for options of the ng extract-i18n command, which extracts marked message strings from source code and outputs translation files.

生成可供翻譯的 translation files.

The architect/server section configures defaults for creating a Universal app with server-side rendering, using the ng run :server command.

生成支持服務器端渲染的 SSR 應用。

The architect/app-shell section configures defaults for creating an app shell for a progressive web app (PWA), using the ng run :app-shell command.

創建一個用于 PWA 應用的 app shell.

assets 配置

Each build target configuration can include an assets array that lists files or folders you want to copy as-is when building your project. By default, the src/assets/ folder and src/favicon.ico are copied over.

靜態資源文件。

assets 里的通配符

• glob: A node-glob using input as base directory.
• input: A path relative to the workspace root.
• output: A path relative to outDir (default is dist/project-name). Because of the security implications, the CLI never writes files outside of the project output path.

由于安全考慮，CLI 絕對不會在項目 output path 之外寫入文件。

• ignore: A list of globs to exclude.
• followSymlinks: Allow glob patterns to follow symlink directories. This allows subdirectories of the symlink to be searched. Defaults to false.

可以用 glob 的這個功能，從項目文件夾之外的位置拷貝文件到 outdir 去。

例如：

"assets": [{"glob": "**/*","input": "./node_modules/some-package/images","output": "/some-package/"} ]

效果：

The contents of node_modules/some-package/images/ will be available in dist/some-package/.

budgets

Default size-budget type and threshholds for all or parts of your app. You can configure the builder to report a warning or an error when the output reaches or exceeds a threshold size.

例子：

2021-7-13 Tuesday

SAP Spartacus 的一個例子：

工作區是若干項目的集合。一個工作區只有一個全局的 angular.json 文件：

里面能看到這個工作區里所有包含的項目，其類型為 application 或者 library：

更多Jerry的原創文章，盡在：“汪子熙”:

更多Jerry的原創文章，盡在：“汪子熙”:

2022-1-4 更新

ng run project:target[:configuration]

project: 項目名稱，定義在 angular.json 的 name 字段里。

target 定義在 angular.json 的 architect 區域。

ng run command runs an Architect target with an optional custom builder configuration defined in angular.json in your project. Here project is the name of the application as defined in angular.json.

上述配置會更新 dist 文件夾下 lazyload 的 server 和 browser 文件夾：

更多Jerry的原創文章，盡在：“汪子熙”:

總結

以上是生活随笔為你收集整理的Angular 项目里 angular.json 文件内容的学习笔记的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。