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