本文概述
Angular CLI是一个命令行界面工具,用于初始化,开发,构建和维护Angular应用程序。你可以直接在命令提示符下使用这些命令,也可以通过交互式UI(即Angular Console)间接使用这些命令。
命令 | 别名 | 描述 |
---|---|---|
add | 它用于向项目添加对外部库的支持。 | |
build | b | 它将Angular应用编译到给定输出路径下名为dist /的输出目录中。必须从工作空间目录中执行。 |
config | 它在工作空间的angular.json文件中检索或设置Angular配置值。 | |
doc | d | 它将在浏览器中打开Angular官方文档(angular.io), 并搜索给定的关键字。 |
e2e | 和 | 它会构建并提供一个Angular应用程序, 然后使用Protractor运行端到端测试。 |
generate | G | 它基于原理图生成和/或修改文件。 |
help | 它提供了可用命令及其简短说明的列表。 | |
lint | 升 | 它用于在给定项目文件夹中的Angular应用程序代码上运行linting工具。 |
new | ñ | 它创建一个新的工作区和一个初始的Angular应用程序。 |
run | 它运行带有在项目中定义的可选自定义构建器配置的Architect目标。 | |
serve | s | 它可以构建并服务你的应用, 并根据文件更改进行重建。 |
test | Ť | 它在项目中运行单元测试。 |
update | 它更新你的应用程序及其依赖项。参见https://update.angular.io/ | |
version | v | 它输出Angular CLI版本。 |
xi18n | 它从源代码中提取i18n消息。 |
add命令
ng add命令用于向项目添加对外部库的支持。它将发布的库的npm软件包添加到你的工作区,并使你的默认应用程序项目以该库的示意图指定的任何方式使用该库。例如,如果添加@ angular / pwa,则它将为PWA支持配置你的项目。
默认的应用程序项目是angular.json中defaultProject的值。
句法:
ng add <collection> [options]
参数说明:
<collection>:它指定要添加的软件包。
选件
–defaults = true | false:为true时,它将禁用交互式输入提示以提供默认选项。
–help = true | false | json | JSON:用于在控制台中显示帮助消息。默认值:false
–interactive = true | false:为false时,它将禁用交互式输入提示。
构建命令
ng build命令用于将Angular应用编译到给定输出路径下名为dist /的输出目录中。它必须从工作空间目录中执行。
句法:
ng build <project> [options]
ng b <project> [options]
参数说明:
<project>:它指定要构建的项目的名称。它可以是应用程序或库。
选件
–aot = true | false:它使用Ahead of Time编译构建。默认值:false
–baseHref = baseHref:它指定正在构建的应用程序的基本URL。
–buildEventLog = buildEventLog:(实验性的)构建事件协议事件的输出文件路径。
–buildOptimizer = true | false:使用“ aot”选项时,它将启用“ @ angular-devkit / build-optimizer”优化。默认值:false
–commonChunk = true | false:它使用单独的捆绑软件,其中包含跨多个捆绑软件使用的代码。默认值:true
–configuration = configuration:一个命名的构建目标,如angular.json的“配置”部分所指定。每个命名的目标都有该目标的默认选项配置。
别名:-c
–deleteOutputPath = true | false:用于在构建之前删除输出路径。默认值:true
–deployUrl = deployUrl:将在其中部署文件的URL。
–es5BrowserSupport = true | false:启用有条件加载的ES2015 polyfill。默认值:false
–extractCss = true | false:用于从全局样式中将css提取到css文件中,而不是js文件中。默认值:false
–extractLicenses = true | false:用于将所有许可证提取到一个单独的文件中。默认值:false
–forkTypeChecker = true | false:用于在派生进程中运行TypeScript类型检查器。默认值:true
–help = true | false | json | JSON:用于在控制台中显示此命令的帮助消息。默认值:false
–i18nFile = i18nFile:用于i18n的本地化文件。
–i18nFormat = i18nFormat:用–i18n-file指定的本地化文件的格式。
–i18nLocale = i18nLocale:用于i18n的语言环境。
–i18nMissingTranslation = i18nMissingTranslation:如何处理i18n的缺失翻译。
–index = index:索引HTML文件的名称。
–lazyModules:将被延迟加载的其他NgModule文件的列表。惰性路由器模块将被自动发现。
–main = main:相对于当前工作空间,应用程序主入口点的完整路径。
–namedChunks = true | false:对延迟加载的块使用文件名默认:true
–ngswConfigPath = ngswConfigPath:ngsw-config.json的路径。
–optimization = true | false:启用构建输出的优化。
–outputHashing = none | all | media | bundles:定义输出文件名缓存清除哈希模式。
默认值:无
–outputPath = outputPath:相对于当前工作空间的新输出目录的完整路径。
默认情况下,将输出写入当前项目中名为dist /的文件夹。
–poll:启用和定义文件监视轮询时间段(以毫秒为单位)。
–polyfills = polyfills:相对于当前工作空间的polyfills文件的完整路径。
–preserveSymlinks = true | false:解析模块时,请勿使用真实路径。
默认值:false
–prod = true | false:为true时,将构建配置设置为生产目标。所有建筑都利用捆绑和有限的摇树。生产版本还可以消除有限的死代码。
–profile = true | false:输出Chrome分析器的配置文件事件。
默认值:false
–progress = true | false:构建时将进度记录到控制台。
–resourcesOutputPath = resourcesOutputPath:相对于outputPath放置样式资源的路径。
–serviceWorker = true | false:为生产构建生成服务工作者配置。默认值:false
–showCircularDependencies = true | false:在构建中显示循环依赖警告。默认值:true
–sourceMap = true | false:用于显示输出源地图。
默认值:true
–statsJson = true | false:它将生成一个“ stats.json”文件,可以使用诸如“ webpack-bundle-analyzer”或https://webpack.github.io/analyse之类的工具进行分析。
默认值:false
–subresourceIntegrity = true | false:启用子资源完整性验证。
默认值:false
–tsConfig = tsConfig:相对于当前工作空间的TypeScript配置文件的完整路径。
–vendorChunk = true | false:它使用仅包含供应商库的单独捆绑包。
默认值:true
–verbose = true | false:它将更多详细信息添加到输出日志记录。
默认值:false
–watch = true | false:当文件更改时,它将运行build。
默认值:false
命令配置
ng config命令用于在工作区的angular.json文件中检索或设置Angular配置值。
句法:
ng config <jsonPath> <value> [options]
参数说明:
<jsonPath>:以JSON路径格式设置或查询的配置键。例如:“ a [3] .foo.bar [2]”。如果未提供新值,则返回此键的当前值。
<值>:如果提供,则为给定配置密钥的新值。
选件
–global = true | false:为true时,它将访问调用者主目录中的全局配置。
默认值:false
别名:-g
–help = true | false | json | JSON:用于在控制台中显示此命令的帮助消息。
默认值:false
命令文档
ng doc命令用于在浏览器中打开正式的Angular文档(angular.io),并搜索给定的关键字。
句法:
ng doc <keyword> [options]
ng d <keyword> [options]
参数说明:
<keyword>:它用于指定要搜索的关键字,如angular.io的搜索栏中所提供。
选件
–help = true | false | json | JSON:用于在控制台中显示此命令的帮助消息。
–search = true | false:为true时,它将搜索所有angular.io。否则,仅搜索API参考文档。
默认值:false
别名:-s
e2e命令
它用于构建和服务Angular应用程序,然后使用量角器运行端到端测试。
句法:
ng e2e <project> [options]
ng e <project> [options]
它必须从工作空间目录中执行。当你不指定项目名称时,它将对所有项目执行。
参数说明:
<project>:它指定要构建的项目的名称。它可以是应用程序或库。
选件
–baseUrl = baseUrl:它指定量角器要连接的基本URL。
–configuration = configuration:用于指定已命名的构建目标,如angular.json的“配置”部分中所指定。每个命名的目标都有该目标的默认选项配置。
别名:-c
–devServerTarget = devServerTarget:它指定运行测试的开发服务器目标。
–elementExplorer = true | false:它将启动量角器的Element Explorer进行调试。
默认值:false
–help = true | false | json | JSON:它在控制台中显示此命令的帮助消息。
默认值:false
–host = host:要监听的主机。
默认值:本地主机
–port:它指定服务应用程序的端口。
–prod = true | false:为true时,它将构建配置设置为生产目标。所有建筑都利用捆绑和有限的摇树。生产版本还可以消除有限的死代码。
–protractorConfig = protractorConfig:它指定量角器配置文件的名称。
–specs:它覆盖量角器配置中的规范。
–suite = suite:它覆盖量角器配置中的套件。
–webdriverUpdate = true | false:用于更新webdriver。
默认值:true
生成命令
ng generate命令用于基于示意图生成和/或修改文件。
ng generate <schematic> [options]
ng g <schematic> [options]
参数说明:
<schematic>:它指定要生成的原理图或collection:schematic。它可以采用以下子命令之一。
- appShell
- 应用
- 类
- 零件
- 指示
- 枚举
- 守护
- 接口
- 图书馆
- 模组
- 管
- 服务
- 服务工人
- 普遍
原理图命令说明
appShell:
它用于生成用于运行服务器端版本的应用程序的应用程序外壳程序。
句法:
ng generate appShell [options]
ng g appShell [options]
应用
它用于在工作区的“项目”子文件夹中创建新的基本应用程序定义。
句法:
ng generate application <name> [options]
ng g application <name> [options]
类
它用于在给定或默认项目中创建新的通用类定义。
句法:
ng generate class <name> [options]
ng g class <name> [options]
零件
它用于在给定或默认项目中创建新的通用组件定义。
句法:
ng generate component <name> [options]
ng g component <name> [options]
指示
它用于在给定或默认项目中创建新的通用指令定义。
句法:
ng generate directive <name> [options]
ng g directive <name> [options]
枚举
它用于为给定或默认项目创建新的通用枚举定义。
句法:
ng generate enum <name> [options]
ng g enum <name> [options]
枚举
它用于为给定或默认项目创建新的通用枚举定义。
句法:
ng generate enum <name> [options]
ng g enum <name> [options]
守护
它用于在给定或默认项目中生成新的通用路由保护定义。
句法:
ng generate enum <name> [options]
ng g enum <name> [options]
接口
它用于在给定或默认项目中创建新的通用接口定义。
句法:
ng generate interface <name> <type> [options]
ng g interface <name> <type> [options]
图书馆
它用于在当前工作空间中创建新的通用库项目。
句法:
ng generate library <name> [options]
ng g library <name> [options]
模组
它用于在给定或默认项目中创建新的通用NgModule定义。
句法:
ng generate module <name> [options]
ng g module <name> [options]
管
它用于在给定或默认项目中创建新的通用管道定义。
句法:
ng generate pipe <name> [options]
ng g pipe <name> [options]
服务
它用于在给定或默认项目中创建新的通用服务定义。
句法:
ng generate service <name> [options]
ng g service <name> [options]
服务工人
这用于将该原理图传递给“运行”命令以创建服务工作者。
句法:
ng generate serviceWorker [options]
ng g serviceWorker [options]
普遍
此命令用于将此原理图传递给“运行”命令,以设置应用程序的服务器端呈现。
句法:
ng generate universal [options]
ng g universal [options]
选件
–defaults = true | false:为true时,它将禁用交互式输入提示以提供默认选项。
–dryRun = true | false:为true时,它将运行并报告活动,而不会写出结果。
默认值:false
别名:-d
–force = true | false:为true时,它将强制覆盖现有文件。
默认值:false
别名:-f
–help = true | false | json | JSON:用于在控制台中显示帮助消息。
默认值:false
–interactive = true | false:为false时,它将禁用交互式输入提示。