角CLI
的Angular应用 ember-cli 项目。
注意
如果你想合作,请退出 我们的问题列表.
先决条件
CLI和生成的项目都有需要Node 6.9.0或更高版本的依赖项 NPM为3或以上。
目录表
安装
安装前: 请阅读 先决条件
npm install -g @angular/cli
使用
ng help
通过开发服务器生成和服务Angular项目
ng new PROJECT-NAME
cd PROJECT-NAME
ng serve
导航到 http://localhost:4200/。如果你更改了任何源文件,应用程序将自动重新加载。
您可以使用两个命令行选项配置开发服务器使用的默认HTTP主机和端口:
ng serve --host 0.0.0.0 --port 4201
生成组件、指令、管道和服务
你可以使用 ng generate (或只是 ng g)命令来生成Angular组件:
ng generate component my-new-component
ng g component my-new-component # using the alias
# components support relative path generation
# if in the directory src/app/feature/ and you run
ng g component new-cmp
# your component will be generated in src/app/feature/new-cmp
# but if you were to run
ng g component ./newer-cmp
# your component will be generated in src/app/newer-cmp
# if in the directory src/app you can also run
ng g component feature/new-cmp
# and your component will be generated in src/app/feature/new-cmp
您可以在下表中找到所有可能的蓝图:
| 脚手架 | 使用 |
|---|
Angular-cli会添加引用到 components, directives 和 pipes 自动地 app.module.ts. 如果您需要将这些引用添加到另一个自定义模块,请遵循以下步骤:
ng g module new-module创建一个新模块- 呼叫
ng g component new-module/new-component
这应该添加新的 component, directive 或者 pipe 参考 new-module 您已经创建了。
更新Angular CLI
如果你使用的是Angular CLI 1.0.0-beta.28 或者更少,您需要卸载 angular-cli 包中。由于更改了包的名称和作用域,所以应该这样做 angular-cli 来 @angular/cli:
npm uninstall -g angular-cli
npm uninstall --save-dev angular-cli
要将Angular CLI更新到新版本,你必须同时更新全局包和项目的本地包。
全球计划:
npm uninstall -g @angular/cli
npm cache verify
# if npm version is < 5 then use `npm cache clean`
npm install -g @angular/cli@latest
本地项目包:
rm -rf node_modules dist # use rmdir /S/Q node_modules dist in Windows Command Prompt; use rm -r -fo node_modules,dist in Windows PowerShell
npm install --save-dev @angular/cli@latest
npm install
如果您正在从beta或RC版本更新到1.0,请查看我们的 1.0更新指南.
您可以在中找到有关版本之间更改的更多详细信息 GitHub上的发布选项卡.
Angular CLI的开发提示
与师傅一起工作
git clone https://github.com/angular/angular-cli.git
cd angular-cli
npm link
npm link 非常相似 npm install -g 除了不下载包
从回购,刚刚克隆 angular-cli/ 文件夹成为全局包。
此外,这个存储库发布了几个包,我们使用特殊的逻辑来加载它们
关于开发设置。
中的文件的任何更改 angular-cli/ 文件夹将立即影响全局 @angular/cli 包,
允许您快速测试对cli项目所做的任何更改。
现在你可以用 @angular/cli 通过命令行:
ng new foo
cd foo
npm link @angular/cli
ng serve
npm link @angular/cli ,因为默认情况下全局安装 @angular/cli 只加载
当地的 @angular/cli 从从npm远程获取的项目中。
npm link @angular/cli 符号链接全局 @angular/cli 包裹到本地 @angular/cli 包中。
现在, angular-cli 你之前克隆的是在三个地方
你克隆到的文件夹,npm的文件夹,存放全局包和你刚刚创建的Angular CLI项目。
你也可以用 ng new foo --link-cli 自动链接 @angular/cli 包中。
请阅读官方 npm-link文档 和 npm-link备忘单 了解更多信息。
要运行Angular CLI测试套件,请使用 node tests/run_e2e.js 命令。
它还可以接收一个文件名,以便只运行该测试(例如: node tests/run_e2e.js tests/e2e/tests/build/dev-build.ts)。
作为测试过程的一部分,将构建并链接所有包。
您需要重新运行 npm link 以便在测试结束后重新链接Angular CLI开发环境。
文档
Angular CLI的文档就在这个repo中 维基.
许可证
麻省理工学院