-
Notifications
You must be signed in to change notification settings - Fork 0
Angular CLI
Join the chat at https://gitter.im/angular/angular-cli
Build Status Dependency Status devDependency Status npm
CLI for Angular applications based on the ember-cli project.
基于ember-cli项目的angular应用程序CLI。
Note
注意
The CLI is now in 1.0. If you are updating from a beta or RC version, check out our 1.0 Update Guide.
CLI现在在1.0版本。 如果您从Beta版或RC版更新升级，请查阅我们的1.0更新指南。
If you wish to collaborate, check out our issue list.
如果您想协作，请查看我们的问题清单。
Before submitting new issues, have a look at issues marked with the type: faq label.
在提交新问题之前，请查看标有类型：faq标签的问题。
Prerequisites
先决条件
Both the CLI and generated project have dependencies that require Node 6.9.0 or higher, together with NPM 3 or higher.
Table of Contents
Installation<br/>
Usage<br/>
Generating a New Project<br/>
Generating Components, Directives, Pipes and Services<br/>
Updating Angular CLI<br/>
Development Hints for working on Angular CLI<br/>
Documentation<br/>
License<br/>
Installation
BEFORE YOU INSTALL: please read the prerequisites
npm install -g @angular/cli
Usage
ng help
Generating and serving an Angular project via a development server
ng new PROJECT-NAME
cd PROJECT-NAME
ng serve
Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.
You can configure the default HTTP host and port used by the development server with two command-line options :
ng serve --host 0.0.0.0 --port 4201
Generating Components, Directives, Pipes and Services
You can use the ng generate (or just ng g) command to generate Angular components:
ng generate component my-new-component
ng g component my-new-component # using the alias
ng g component new-cmp
ng g component ../newer-cmp
ng g component feature/new-cmp
You can find all possible blueprints in the table below:
Scaffold Usage
Component ng g component my-new-component
Directive ng g directive my-new-directive
Pipe ng g pipe my-new-pipe
Service ng g service my-new-service
Class ng g class my-new-class
Guard ng g guard my-new-guard
Interface ng g interface my-new-interface
Enum ng g enum my-new-enum
Module ng g module my-module
angular-cli will add reference to components, directives and pipes automatically in the app.module.ts. If you need to add this references to another custom module, follow this steps:
ng g module new-module to create a new module<br/>
call ng g component new-module/new-component<br/>
This should add the new component, directive or pipe reference to the new-module you've created.
Updating Angular CLI
If you're using Angular CLI beta.28 or less, you need to uninstall angular-cli package. It should be done due to changing of package's name and scope from angular-cli to @angular/cli:
npm uninstall -g angular-cli
npm uninstall --save-dev angular-cli
To update Angular CLI to a new version, you must update both the global package and your project's local package.
Global package:
npm uninstall -g @angular/cli
npm cache clean
npm install -g @angular/cli@latest
Local project package:
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
If you are updating to 1.0 from a beta or RC version, check out our 1.0 Update Guide.
You can find more details about changes between versions in CHANGELOG.md.
Development Hints for working on Angular CLI
Working with master
git clone https://github.com/angular/angular-cli.git
cd angular-cli
npm link
npm link is very similar to npm install -g except that instead of downloading the package from the repo, the just cloned angular-cli/ folder becomes the global package. Additionally, this repository publishes several packages and we use special logic to load all of them on development setups.
Any changes to the files in the angular-cli/ folder will immediately affect the global @angular/cli package, allowing you to quickly test any changes you make to the cli project.
Now you can use @angular/cli via the command line:
ng new foo
cd foo
npm link @angular/cli
ng serve
npm link @angular/cli is needed because by default the globally installed @angular/cli just loads the local @angular/cli from the project which was fetched remotely from npm. npm link @angular/cli symlinks the global @angular/cli package to the local @angular/cli package. Now the angular-cli you cloned before is in three places: The folder you cloned it into, npm's folder where it stores global packages and the Angular CLI project you just created.
You can also use ng new foo --link-cli to automatically link the @angular/cli package.
Please read the official npm-link documentation and the npm-link cheatsheet for more information.
To run the Angular CLI test suite use the node tests/run_e2e.js command. It can also receive a filename to only run that test (e.g. node tests/run_e2e.js tests/e2e/tests/build/dev-build.ts).
As part of the test procedure, all packages will be built and linked. You will need to re-run npm link to re-link the development Angular CLI environment after tests finish.
Documentation
The documentation for the Angular CLI is located in this repo's wiki.
License
MIT