看一個基於 Angular 的 SAP Spartacus 專案裡 angular.json 的例子：

![](https://img-blog.csdnimg.cn/img_convert/8ecd6059895401bc6b3a4232d3b67c8b.png)

* 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.

![](https://img-blog.csdnimg.cn/img_convert/b8cf59881c50bb3f328c2a314e7f9be5.png)

> 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 開發包裡:

![](https://img-blog.csdnimg.cn/img_convert/62b8a21760acab29fe0f34101399874d.png)

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

![](https://img-blog.csdnimg.cn/img_convert/3c7b51779c0679e9165eee7c1d35f688.png)

# 什麼是 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.

![](https://img-blog.csdnimg.cn/img_convert/ff251daaa4f41ce299ff16796c6a3730.png)

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.

![](https://img-blog.csdnimg.cn/img_convert/fdce78cd197d7328adf7170c8b7ec7ff.png)

> 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 裡。

![](https://img-blog.csdnimg.cn/img_convert/79ce401f35c065c440939b930357eddf.png)

> 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 <project>: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 <project>: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 裡的萬用字元

![](https://img-blog.csdnimg.cn/img_convert/6ecd9e9b0b59b5244e1badb3350a13d8.png)

* 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 去。

例如：

```json
"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.

例子：

![](https://img-blog.csdnimg.cn/img_convert/781878c98257f03ceb2f7fdc5aa3c97b.png)</project></project>

Angular 專案裡 angular.json 檔案內容的學習筆記

相關文章