angular.json的内容
我在angular-cli 7.1.2上进行了确认。
这是关于通过ng new命令生成的项目中angular.json文件的常用项目调查。
根对象
-
- $schema
-
- このファイルに関するJSON Schemaの定義ファイル
-
- ”./node_modules/@angular/cli/lib/config/schema.json”
-
- 固定
-
- https://github.com/angular/angular-cli/blob/master/packages/angular/cli/lib/config/schema.json
-
- version
-
- ”1″ 固定
-
- cli
-
- 生成時にはない。
-
- ngコマンド全般に対するデフォルトオプションを設定できる。
-
- schematics
-
- 生成時にはない。
-
- generate系のコマンドライン引数のデフォルトを設定できる。
-
- また、ngコマンドで生成するものを拡張していける(自作可)。
-
- newProjectRoot
-
- ”projects”
-
- ng generate libraryした際の保存先フォルダ
-
- defaultProject
-
- 複数のprojectがある場合のデフォルトを指定する
-
- ng generateやng buildする際にproject名を指定していない場合に利用される
-
- projects
- プロジェクト名をキーにした各プロジェクトの詳細設定がある。
cli的内容
項目名説明defaultCollectionschematicsのデフォルトを設定するpackageManager”npm”, “cnpm”, “yarn”からパッケージマネージャーを設定するwarnings※1
※1 警告的具体内容
項目名説明versionMismatchグローバルとローカルのバージョン違いの警告を表示するtypescriptMismatchtypescriptのバージョンの警告を表示する
项目的内容
項目名説明cliルートオブジェクトと同様schematicsルートオブジェクトと同様prefixgenerateするものに対してつくprefixrootプロジェクトのrootになるフォルダsourceRootassetsやindex.htmlがあるソースのフォルダprojectType”application”, “library”から選択するarchitect名称をキーにした詳細設定 ※2targets名称をキーにした詳細設定 ※2
※2 建筑师和目标只能选择一个。默认情况下仅选择建筑师。
※2 建筑师和目标的内容
項目名説明builderbuilderの設定。
@angular-devkit/build-angular:app-shell
@angular-devkit/build-angular:browser
@angular-devkit/build-angular:dev-server
@angular-devkit/build-angular:extract-i18n
@angular-devkit/build-angular:karma
@angular-devkit/build-angular:protractor
@angular-devkit/build-angular:server
@angular-devkit/build-angular:tslintoptionsbuilderに対するoption設定configurationscliで実行時に切り替えするoption設定
@angular-devkit/build-angular:app-shell
@angular-devkit/build-angular:browser
@angular-devkit/build-angular:dev-server
@angular-devkit/build-angular:extract-i18n
@angular-devkit/build-angular:karma
@angular-devkit/build-angular:protractor
@angular-devkit/build-angular:server
@angular-devkit/build-angular:tslintoptionsbuilderに対するoption設定configurationscliで実行時に切り替えするoption設定
建立-angular:appShell的选项设置的内容。
項目名初期値説明browserTarget
ビルドターゲットとなるブラウザserverTarget
app shellをレンダリングするサーバappModuleBundle
サーバ用のAppModuleroute/レンダーするrouteinputIndexPath
ビルドターゲットとなるブラウザserverTarget
app shellをレンダリングするサーバappModuleBundle
サーバ用のAppModuleroute/レンダーするrouteinputIndexPath
outputIndexPath
在Angular构建中,关于`build-angular:browser`的选项配置内容。
項目名初期値説明assets[]アセットとして含めるファイルのリストmain
エントリポイントになるスクリプトファイルpolyfills
polyfill用のスクリプトファイルtsConfig
TypeScript設定ファイルのパスscripts[]グローバルな(index.htmlに直接読み込ませる)スクリプトファイルのリストstyles[]グローバルなスタイルシートのリスト。extractCssがtrueだと単独のstyles.cssに書き出される。stylePreprocessorOptions
scss等のプリプロセッサのオプション(includePaths)optimization
最適化する。{scripts: true, styles: false} というような個別設定も可能fileReplacements
ファイル差し替え。主にenvironmentファイルに使われる。outputPath
ビルドした生成物が出力されるフォルダresourcesOutputPath
styleの出力フォルダ。outputPathからの相対。aotfalseAhead of Time compilation(事前コンパイル)を有効にするsourceMaptruesourceMapを出力する。{scripts: true, styles: true, hidden: false, vendor: true}というような個別設定も可能vendorSourceMapfalseライブラリのsourceMapを出力するevalSourceMapfalsein-file evalスタイルのsourceMapを出力するvendorChunktrueライブラリだけで単独のファイルにする。ライブラリは変更頻度が低いため。commonChunktrue複数にまたがるコードを共通ファイルにする。baseHref
index.htmlにタグとして出力されるパス。サブフォルダで使うような場合に設定する。deployUrl
出力ファイルを読み込む際のパス。Urlという名前だけどパス指定。verbosefalseビルド時の出力progresstrueビルド時の進捗度合い表示i18nFile
i18n(国際化)で利用するファイルi18nFormat
i18nで利用するフォーマットi18nLocale
i18nで利用するロケールi18nMissingTranslation
i18nで訳がない場合の出力extractCssfalseグローバル指定のcssを展開するwatchfalseファイル変更を監視して自動的に再ビルドするoutputHashing”none”出力ファイル名にハッシュをつける。キャッシュバスター。”none”,”all”,”media”,”bundles”poll
watchする際の監視間隔をミリ秒で設定deleteOutputPathtrueビルド前にoutputPathを削除するpreserveSymlinksfalseシンボリックリンクをリアルパスに変換するextractLicensestrue利用ライブラリのライセンスファイルをまとめるshowCircularDependenciestrue循環参照を表示するbuildOptimizerfalseaot利用時、@angular-devkit/build-optimizerを有効にするnamedChunkstrue遅延読み込みのファイルに名前をつけるsubresourceIntegrityfalseサブリソース。(よくわかっていない)serviceWorkerfalseServiceWorkerのconfigを出力するngswConfigPath
ngsw-configファイルへのパス。ServiceWorker関連。skipAppShellfalseapp-shell関連をビルドしないindex
index.htmlファイルのパスstatsJsonfalsewebpack-bundle-analyzer で使うstats.jsonの出力forkTypeCheckertrueTypeScriptの型チェッカーをforkモードで使うlazyModules[]遅延読み込みするNgModuleのリスト。大抵はrouterモジュールが自動的にやってくれる。budgets[]生成ファイルのファイルサイズ制限を設定できる。気軽に巨大なライブラリをimportすると使わないコードが大量に含まれてしまったりするのを警告する。
エントリポイントになるスクリプトファイルpolyfills
polyfill用のスクリプトファイルtsConfig
TypeScript設定ファイルのパスscripts[]グローバルな(index.htmlに直接読み込ませる)スクリプトファイルのリストstyles[]グローバルなスタイルシートのリスト。extractCssがtrueだと単独のstyles.cssに書き出される。stylePreprocessorOptions
scss等のプリプロセッサのオプション(includePaths)optimization
最適化する。{scripts: true, styles: false} というような個別設定も可能fileReplacements
ファイル差し替え。主にenvironmentファイルに使われる。outputPath
ビルドした生成物が出力されるフォルダresourcesOutputPath
styleの出力フォルダ。outputPathからの相対。aotfalseAhead of Time compilation(事前コンパイル)を有効にするsourceMaptruesourceMapを出力する。{scripts: true, styles: true, hidden: false, vendor: true}というような個別設定も可能vendorSourceMapfalseライブラリのsourceMapを出力するevalSourceMapfalsein-file evalスタイルのsourceMapを出力するvendorChunktrueライブラリだけで単独のファイルにする。ライブラリは変更頻度が低いため。commonChunktrue複数にまたがるコードを共通ファイルにする。baseHref
index.htmlにタグとして出力されるパス。サブフォルダで使うような場合に設定する。deployUrl
出力ファイルを読み込む際のパス。Urlという名前だけどパス指定。verbosefalseビルド時の出力progresstrueビルド時の進捗度合い表示i18nFile
i18n(国際化)で利用するファイルi18nFormat
i18nで利用するフォーマットi18nLocale
i18nで利用するロケールi18nMissingTranslation
i18nで訳がない場合の出力extractCssfalseグローバル指定のcssを展開するwatchfalseファイル変更を監視して自動的に再ビルドするoutputHashing”none”出力ファイル名にハッシュをつける。キャッシュバスター。”none”,”all”,”media”,”bundles”poll
watchする際の監視間隔をミリ秒で設定deleteOutputPathtrueビルド前にoutputPathを削除するpreserveSymlinksfalseシンボリックリンクをリアルパスに変換するextractLicensestrue利用ライブラリのライセンスファイルをまとめるshowCircularDependenciestrue循環参照を表示するbuildOptimizerfalseaot利用時、@angular-devkit/build-optimizerを有効にするnamedChunkstrue遅延読み込みのファイルに名前をつけるsubresourceIntegrityfalseサブリソース。(よくわかっていない)serviceWorkerfalseServiceWorkerのconfigを出力するngswConfigPath
ngsw-configファイルへのパス。ServiceWorker関連。skipAppShellfalseapp-shell関連をビルドしないindex
index.htmlファイルのパスstatsJsonfalsewebpack-bundle-analyzer で使うstats.jsonの出力forkTypeCheckertrueTypeScriptの型チェッカーをforkモードで使うlazyModules[]遅延読み込みするNgModuleのリスト。大抵はrouterモジュールが自動的にやってくれる。budgets[]生成ファイルのファイルサイズ制限を設定できる。気軽に巨大なライブラリをimportすると使わないコードが大量に含まれてしまったりするのを警告する。
build-angular:devServer选项的内容。
項目名初期値説明browserTarget
対象にするbuildport4200ポート。複数アプリ開発時に4201等違うポートに設定できる。host”localhost”ホスト。0.0.0.0等にすると同じLAN内の違うマシンからアクセスできる。別OSやスマホからの確認に。proxyConfig
proxyConfigファイルのパスsslfalseSSL設定sslKey
SSL設定sslCert
SSL設定openfalse初回ビルド時にデフォルトブラウザを開くliveReloadtrueビルド時に自動リロードするpublicHost
ホスト名の制限servePath
サーブするパスdisableHostCheckfalseホスト名のチェックhmrfalsehot module replacementを有効にするwatchtrueファイル変更を監視して自動的に再ビルドするhmrWarningtruehmr有効にする時の警告を表示するservePathDefaultWarningtruedeploy-url/base-hrefが利用されている際の警告を表示するoptimization
最適化する。{scripts: true, styles: false} というような個別設定も可能aot
Ahead of Time compilation(事前コンパイル)を有効にするsourceMaptruesourceMapを出力する。{scripts: true, styles: true, hidden: false, vendor: true}というような個別設定も可能vendorSourceMapfalseライブラリのsourceMapを出力するevalSourceMap
in-file evalスタイルのsourceMapを出力するvendorChunk
ライブラリだけで単独のファイルにする。ライブラリは変更頻度が低いため。commonChunk
複数にまたがるコードを共通ファイルにする。baseHref
index.htmlにタグとして出力されるパス。サブフォルダで使うような場合に設定する。deployUrl
出力ファイルを読み込む際のパス。Urlという名前だけどパス指定。verbose
ビルド時の出力progress
ビルド時の進捗度合い表示
対象にするbuildport4200ポート。複数アプリ開発時に4201等違うポートに設定できる。host”localhost”ホスト。0.0.0.0等にすると同じLAN内の違うマシンからアクセスできる。別OSやスマホからの確認に。proxyConfig
proxyConfigファイルのパスsslfalseSSL設定sslKey
SSL設定sslCert
SSL設定openfalse初回ビルド時にデフォルトブラウザを開くliveReloadtrueビルド時に自動リロードするpublicHost
ホスト名の制限servePath
サーブするパスdisableHostCheckfalseホスト名のチェックhmrfalsehot module replacementを有効にするwatchtrueファイル変更を監視して自動的に再ビルドするhmrWarningtruehmr有効にする時の警告を表示するservePathDefaultWarningtruedeploy-url/base-hrefが利用されている際の警告を表示するoptimization
最適化する。{scripts: true, styles: false} というような個別設定も可能aot
Ahead of Time compilation(事前コンパイル)を有効にするsourceMaptruesourceMapを出力する。{scripts: true, styles: true, hidden: false, vendor: true}というような個別設定も可能vendorSourceMapfalseライブラリのsourceMapを出力するevalSourceMap
in-file evalスタイルのsourceMapを出力するvendorChunk
ライブラリだけで単独のファイルにする。ライブラリは変更頻度が低いため。commonChunk
複数にまたがるコードを共通ファイルにする。baseHref
index.htmlにタグとして出力されるパス。サブフォルダで使うような場合に設定する。deployUrl
出力ファイルを読み込む際のパス。Urlという名前だけどパス指定。verbose
ビルド時の出力progress
ビルド時の進捗度合い表示