Установка Angular-библиотек через ng add | ng-hub-ui
Установщик семейства ng-hub-ui: одна команда ng add спрашивает, какие библиотеки вам нужны, разрешает пакеты для каждой из них и записывает их в ваш манифест.
Последнее обновление 8 сент. 2026 г.
Обзор
Почему команды ищут эту библиотеку
Используйте ng-hub-ui, когда добавляете одну или несколько библиотек семейства в рабочее пространство Angular и не хотите вручную выяснять, какой пир нужен каждой из них.
Установка
ng add ng-hub-uiПерейти к
Идеально для
- Добавить несколько библиотек ng-hub-ui в рабочее пространство Angular за один шаг
- Автоматизировать первоначальную настройку проекта в CI без ответов на диалог
- Позволить вычислить за вас пиры, нужные каждой библиотеке
О библиотеке ui
ng-hub-ui — зонтичный пакет семейства и единственный опубликованный, в котором нет компонентов. В нём есть схематик ng-add. Он предлагает 25 библиотек каталога в списке множественного выбора или берёт их идентификаторы прямо из флага --libraries и разрешает выбор в те пакеты npm, которые действительно нужны: пиры, от которых зависит библиотека, и единственный внешний пакет sortablejs, который вообще не наш. Полученный список записывается в dependencies в корне рабочего пространства, никогда не перезаписывая уже существующий ключ, и передаётся тому менеджеру пакетов, который обнаружила Angular CLI. Дальше связывания зависимостей дело не идёт: ни angular.json, ни провайдеров, ни импортов компонентов, ни записей в таблицах стилей.
Руководства по возможностям
Одна команда
`ng add ng-hub-ui` — это вся установка. Angular CLI загружает пакет, запускает его схематик `ng-add`, и тот спрашивает, какие из 25 библиотек каталога вам нужны. Пробел выбирает, `a` отмечает всё, `i` инвертирует выбор; после подтверждения выбор превращается в пакеты npm, они записываются в `dependencies`, а установка передаётся тому менеджеру пакетов, который обнаружил CLI.
Примеры:
Интерактивная установка
Команда и открываемый ею диалог — так, как они выглядят в терминале.
Space selects, a toggles everything and i inverts the selection. The schematic writes the chosen packages into dependencies and then lets the package manager install them.
Флаги и скрипты
Диалог можно пропустить, и именно это делает установщик пригодным для CI и для собственного скрипта настройки проекта. `--libraries` принимает список через запятую или тот же флаг несколько раз; обе формы нормализуются одинаково: без пробелов, без дублей, в заданном порядке. `--skip-install` записывает манифест и на этом останавливается. Передавайте идентификаторы из каталога, а не подписи из диалога — это разные строки, и неизвестный идентификатор останавливает схематик до того, как `package.json` будет затронут.
Примеры:
Флаги вместо диалога
Три неинтерактивные формы и два способа отклонить неверный выбор.
Comma-separated
Repeated flag — the same selection, normalized the same way
Manifest only, install left to you
An empty selection fails with Select at least one ng-hub-ui library to install. and an unknown identifier with Unknown ng-hub-ui library: <id>. — in both cases before package.json is touched.
Разрешённые зависимости
Выбранное — не то же самое, что записанное. Каждая библиотека каталога объявляет нужные ей пиры: `ng-hub-ui-utils` — почти для всего семейства, `ng-hub-ui-ds` — для panels, `ng-hub-ui-forms` — для signature и `sortablejs`, который вообще не наш. Разрешение транзитивно, поэтому подтянутая библиотека приносит собственные пиры. Нижняя граница каждого диапазона не ниже самого высокого пира, который семейство от него требует, — это и не даёт записать пару, которую npm не сможет разрешить. Уже существующий ключ никогда не переписывается, так что зафиксированная версия сохраняется. Схематик заканчивается на связывании зависимостей: ни `angular.json`, ни провайдеров, ни регистрации компонентов, ни записей в таблицах стилей.
Примеры:
Что записывает выбор
Запрошены две библиотеки, записаны пять пакетов — сопутствующие установки наглядно.
Two libraries asked for…
…five packages written into package.json
The schematic adds a dependency only when the key is absent, so a version already pinned in your manifest survives the install untouched.
Ключевые возможности
Последние изменения
Version 0.2.1 - 9/8/26, 12:00 AM
fixed: Four documents said the installer has no page on the documentation site. This is that page: both READMEs and `FUNCTIONALITIES.md` link to it instead of denying it.
changed: The manifest `homepage` points at this page rather than at the family root — it is the link a registry shows beside the package, and every other library in the family already points at its own documentation. Metadata only: no code, no schematic behaviour, no catalogue change.
Version 0.2.0 - 9/6/26, 12:00 AM
fixed: Every one of the 25 catalogue ranges now floors at or above the highest peer the family declares on it. `ng-hub-ui-forms` had reached 22.32.0 peering on `ng-hub-ui-utils >=22.12.0` while the catalogue still offered `utils ^22.8.1`, so `ng add ng-hub-ui --libraries=forms` wrote a pair npm cannot satisfy — invisible on a fresh unpinned install, an `ERESOLVE` anywhere resolution was already fixed.
fixed: Both READMEs denied a library the installer has offered since 0.1.6: they said `ng-hub-ui-action-sheet` was not on npm, in five separate places, while the catalogue had carried it all along.
changed: The Angular peer range is `>=18.0.0`, up from `>=17.3.0`. Nothing in the catalogue targets Angular 17, so the old floor let `ng add ng-hub-ui` run, write the manifest and only then fail to resolve. See `BREAKING_CHANGES.md`.
added: The schematic has a tracked spec again. The only test over `ng add` lived beside the compiled output where `.gitignore` excludes it, so it left the repository the moment it was written; run today it reported three failures it had been reporting for months.
Version 0.1.7 - 9/1/26, 12:00 AM
changed: The manifest `homepage` points at the localized site root rather than the redirect above it, so a reader arriving from npm lands one hop earlier.
Version 0.1.6 - 8/30/26, 12:00 AM
added: `action-sheet` joins the catalogue and the prompt: `ng-hub-ui-action-sheet` reached the registry with 22.0.0, and it needs no co-installs.
Связанные библиотеки
Часто задаваемые вопросы
Как установить ng-hub-ui в проект Angular?
Выполните ng add ng-hub-ui. Angular CLI загрузит пакет установщика и запустит его схематик ng-add: он спросит, какие из 25 библиотек каталога вам нужны, запишет разрешённые пакеты в dependencies и передаст установку вашему менеджеру пакетов.
Можно ли установить библиотеки без интерактивного диалога?
Да. Передайте идентификаторы во флаг --libraries — через запятую (--libraries=modal,paginable) или повторяя флаг (--libraries=modal --libraries=paginable). Добавьте --skip-install, чтобы обновить package.json и оставить установку себе.
Что схематик ng-hub-ui меняет в проекте?
Только блок dependencies в корневом package.json, и только те ключи, которых там ещё нет. Он не трогает angular.json, не регистрирует провайдеров, не импортирует компоненты и не добавляет таблицы стилей.