Справочник по командам CLI

Angular CLI - это инструмент интерфейса командной строки, который используется для инициализации, разработки, создания и поддержки приложений Angular. Вы можете использовать инструмент непосредственно в командной оболочке или косвенно через интерактивный интерфейс, такой как Angular Console.

Установка углового CLI

Основные версии Angular CLI соответствуют поддерживаемой основной версии Angular, но дополнительные версии могут быть выпущены отдельно.

Установите CLI, используя менеджер пакетов npm:

npm install -g @angular/cli

Основной рабочий процесс

Запустите инструмент из командной строки через исполняемый файл ng. Онлайн-справка доступна в командной строке. Введите следующее, чтобы перечислить команды или параметры для данной команды (например, создать) с кратким описанием.

ng help
ng generate --help

Чтобы создать, построить и обслуживать новый базовый проект Angular на сервере разработки, перейдите в родительский каталог вашего нового рабочего пространства с помощью следующих команд:

ng new my-first-project
cd my-first-project
ng serve

В вашем браузере откройте http: // localhost: 4200 /, чтобы увидеть, как запускается новое приложение. Когда вы используете команду ng serve для создания приложения и его локального обслуживания, сервер автоматически перестраивает приложение и перезагружает страницу при изменении любого из исходных файлов.

Рабочие пространства и файлы проекта

Команда ng new создает папку рабочей области Angular и генерирует новый скелет приложения. Рабочая область может содержать несколько приложений и библиотек. Начальное приложение, созданное командой ng new, находится на верхнем уровне рабочей области. Когда вы генерируете дополнительное приложение или библиотеку в рабочей области, оно переходит в подпапку проектов /.

Вновь созданное приложение содержит исходные файлы для корневого модуля, с корневым компонентом и шаблоном. Каждое приложение имеет папку src, которая содержит логику, данные и ресурсы.

Вы можете редактировать сгенерированные файлы напрямую или добавлять и изменять их с помощью команд консоли. Используйте команду ng generate, чтобы добавить новые файлы для дополнительных компонентов и служб, а также код для новых каналов, директив и т. Д. Такие команды, как add и generate, которые создают приложения или библиотеки или работают с ними, должны выполняться из рабочей области или папки проекта.

Рабочая область и конфигурация проекта

Единственный файл конфигурации рабочего пространства, angular.json, создается на верхнем уровне рабочего пространства. Здесь вы можете установить для каждого проекта параметры по умолчанию для каждого проекта и указать конфигурации, которые будут использоваться, когда CLI создает проект для разных целей.

Команда ng config позволяет вам устанавливать и получать значения конфигурации из командной строки, или вы можете редактировать файл angular.json напрямую. Обратите внимание, что имена параметров в файле конфигурации должны использовать camelCase, в то время как имена параметров, предоставляемые командам, могут использовать camelCase или dash-case.

Синтаксис командного языка CLI

Синтаксис команды показан следующим образом:

ng commandNameOrAlias requiredArg [optionalArg] [options]

Большинство команд и некоторые опции имеют псевдонимы. Псевдонимы отображаются в синтаксической инструкции для каждой команды.

Имена опций начинаются с двойной черты (-). Псевдонимы опций начинаются с одной черты (-). Аргументы не имеют префикса. Например:

ng build my-app -c production

Как правило, имя сгенерированного артефакта может быть задано в качестве аргумента команды или указано с помощью параметра --name.

Имена аргументов и опций могут быть заданы либо в camelCase, либо в dash-case. --myOptionName эквивалентно --my-option-name.

Булевы и перечисляемые параметры

Логические параметры имеют две формы: --thisOption устанавливает флаг, --noThisOption очищает его. Если ни одна из опций не указана, флаг остается в своем состоянии по умолчанию, как указано в справочной документации.

Допустимые значения даются с каждым перечисленным описанием опции, значение по умолчанию выделено жирным шрифтом.

Относительные пути

Параметры, которые определяют файлы, могут быть заданы как абсолютные пути или как пути относительно текущего рабочего каталога, который обычно является либо рабочим пространством, либо корневым каталогом проекта.

Schematics

Команды ng generate и ng add принимают в качестве аргумента артефакт или библиотеку, которые будут созданы или добавлены в текущий проект. В дополнение к любым общим параметрам каждый артефакт или библиотека определяет свои собственные параметры в схеме. Параметры схемы предоставляются команде в том же формате, что и параметры немедленной команды.

Обзор команд

Предыдущая: Обновление ваших Angular проектов
Далее: нг добавить