Spec-Zone.ru › Angular

build

ng build [project] [options]
ng b [project] [options]

Эту команду можно использовать для сборки проекта типа «приложение» или «библиотека». При сборке библиотеки вызывается другой сборщик, и применяются только параметры ts-config, configuration, poll и watch. Все остальные параметры применяются только при сборке приложений.

Для сборки приложения используется инструмент esbuild с параметрами конфигурации по умолчанию, указанными в файле конфигурации рабочей области (angular.json), или с именованной альтернативной конфигурацией. При создании проекта с помощью CLI по умолчанию создаётся конфигурация «development». Её можно использовать, указав --configuration development.

Параметры конфигурации в целом соответствуют параметрам команды. Вы можете переопределить отдельные значения по умолчанию, указав соответствующие параметры в командной строке. Команда принимает имена параметров в формате dash-case. Обратите внимание: в файле конфигурации имена необходимо указывать в формате camelCase.

Некоторые дополнительные параметры можно задать только через файл конфигурации — непосредственно отредактировав его или воспользовавшись командой ng config. К ним относятся объекты assets, styles и scripts, предоставляющие проекту глобальные ресурсы, доступные во время выполнения. Ресурсы CSS, например изображения и шрифты, автоматически записываются в корневую папку выходных данных, а их имена снабжаются хешами.

Подробнее см. в разделе Конфигурация рабочей области.

Аргументы

project

Имя проекта для сборки. Это может быть приложение или библиотека.

Тип значения

string

Параметры

allowed-common-js-dependencies

Список пакетов CommonJS или AMD, которые разрешено использовать без предупреждения во время сборки. Чтобы разрешить все пакеты, используйте '*'.

Тип значения

array

aot

Сборка с использованием компиляции Ahead-of-Time.

Тип значения

boolean

Значение по умолчанию

true

app-shell

Создаёт оболочку приложения во время сборки.

Тип значения

boolean

base-href

Базовый URL собираемого приложения.

Тип значения

string

browser

Полный путь к точке входа браузерной части приложения относительно текущей рабочей области.

Тип значения

string

clear-screen

Автоматически очищать экран терминала при повторных сборках.

Тип значения

boolean

Значение по умолчанию

false

conditions

Пользовательские условия разрешения пакетов для разрешения условных экспортов и импортов. По умолчанию используются ['module', 'development'/'production']. Если выполнены необходимые условия, всегда присутствуют следующие специальные условия: 'default', 'import', 'require', 'browser', 'node'.

Тип значения

array

configuration

Одна или несколько именованных конфигураций сборщика в виде списка, разделённого запятыми, как указано в разделе "configurations" файла angular.json. Сборщик использует именованные конфигурации для запуска заданной цели. Подробнее см. на странице https://angular.dev/reference/configs/workspace-config#alternate-build-configurations.

Тип значения

string

cross-origin

Задаёт значение атрибута crossorigin для элементов, поддерживающих CORS.

Тип значения

string

Допустимые значения

anonymous, none, use-credentials

Значение по умолчанию

none

define

Определяет глобальные идентификаторы, которые будут заменены указанными константными значениями при обнаружении в любом коде JavaScript или TypeScript, включая библиотеки. Значение будет использоваться напрямую. Строковые значения необходимо заключать в кавычки. Идентификаторы в метаданных Angular, например в декораторах компонентов, заменяться не будут.

Тип значения

array

delete-output-path

Удалить выходную папку перед сборкой.

Тип значения

boolean

Значение по умолчанию

true

deploy-url

Настраивает базовый путь для URL-адресов ресурсов в 'index.html' и таблицах стилей компонентов. Этот параметр нужен только в особых сценариях развёртывания, например при использовании Angular Elements или разных расположений CDN.

Тип значения

string

external-dependencies

Исключает перечисленные внешние зависимости из пакета. Вместо этого созданный пакет предполагает, что эти зависимости будут доступны во время выполнения. Примечание: @foo/bar помечает как внешние все пути внутри пакета @foo/bar, включая пути к подпакетам, например @foo/bar/baz.

Тип значения

array

extract-licenses

Извлекать все лицензии в отдельный файл.

Тип значения

boolean

Значение по умолчанию

true

help

Показывает справочное сообщение об этой команде в консоли.

Тип значения

boolean

i18n-duplicate-translation

Способ обработки повторяющихся переводов i18n.

Тип значения

string

Допустимые значения

error, ignore, warning

Значение по умолчанию

warning

i18n-missing-translation

Способ обработки отсутствующих переводов i18n.

Тип значения

string

Допустимые значения

error, ignore, warning

Значение по умолчанию

warning

index

Настраивает создание HTML-индекса приложения.

Тип значения

string

inline-style-language

Язык таблиц стилей для встроенных стилей компонентов приложения.

Тип значения

string

Допустимые значения

css, less, sass, scss

Значение по умолчанию

css

localize

Переводить пакеты на один или несколько языков.

Тип значения

boolean

named-chunks

Использовать имена файлов для лениво загружаемых чанков.

Тип значения

boolean

Значение по умолчанию

false

optimization

Включает оптимизацию выходных данных сборки, в том числе минификацию скриптов и стилей, tree shaking, удаление неиспользуемого кода, встраивание критического CSS и встраивание шрифтов. Подробнее см. на странице https://angular.dev/reference/configs/workspace-config#optimization-configuration.

Тип значения

boolean

Значение по умолчанию

true

output-hashing

Задаёт режим хеширования имён выходных файлов для сброса кэша.

  • none: без хеширования.
  • all: хеширование всех выходных пакетов.
  • media: хеширование всех выходных медиафайлов (например, изображений, шрифтов и других ресурсов, на которые ссылаются файлы CSS).
  • bundles: хеширование выходных данных ленивых и основных пакетов.

Тип значения

string

Допустимые значения

all, bundles, media, none

Значение по умолчанию

none

output-mode

Определяет тип артефакта сборки. 'static': создаёт артефакт статической сборки сайта для размещения на любом хостинге статических сайтов. 'server': создаёт артефакт сборки серверного приложения, необходимый для приложений с гибридным рендерингом или API.

Тип значения

string

Допустимые значения

server, static

output-path

Задаёт путь для выходных данных относительно корня рабочей области.

Тип значения

string

poll

Включает опрос файлов и задаёт интервал опроса в миллисекундах.

Тип значения

number

polyfills

Список полифилов, включаемых в сборку. Можно указать полный путь к файлу относительно текущей рабочей области или спецификатор модуля. Пример: 'zone.js'.

Тип значения

array

prerender

Выполнять предварительный рендеринг (SSG) страниц приложения во время сборки.

Тип значения

boolean

preserve-symlinks

Не использовать реальный путь при разрешении модулей. Если параметр не задан, по умолчанию используется true, если задан параметр NodeJS --preserve-symlinks.

Тип значения

boolean

progress

Выводить ход сборки в консоль.

Тип значения

boolean

Значение по умолчанию

true

scripts

Глобальные скрипты, включаемые в сборку.

Тип значения

array

server

Полный путь к точке входа серверной части приложения относительно текущей рабочей области.

Тип значения

string

service-worker

Создаёт конфигурацию service worker.

Тип значения

string

source-map

Создавать карты исходного кода для скриптов и стилей. Подробнее см. на странице https://angular.dev/reference/configs/workspace-config#source-map-configuration.

Тип значения

boolean

Значение по умолчанию

false

ssr

Выполнять серверный рендеринг (SSR) страниц приложения во время выполнения.

Тип значения

boolean

Значение по умолчанию

false

stats-json

Создаёт файл 'stats.json', который можно анализировать с помощью https://esbuild.github.io/analyze/.

Тип значения

boolean

Значение по умолчанию

false

styles

Глобальные стили, включаемые в сборку.

Тип значения

array

subresource-integrity

Включает проверку целостности подресурсов.

Тип значения

boolean

Значение по умолчанию

false

ts-config

Полный путь к файлу конфигурации TypeScript относительно текущей рабочей области.

Тип значения

string

verbose

Добавляет подробности в журналы вывода.

Тип значения

boolean

Значение по умолчанию

false

watch

Запускать сборку при изменении файлов.

Тип значения

boolean

Значение по умолчанию

false

web-worker-ts-config

Конфигурация TypeScript для модулей Web Worker.

Тип значения

string

Super-powered by Google ©2010–2025.
Code licensed under an MIT-style License. Documentation licensed under CC BY 4.0.
https://angular.dev/cli/build

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API