Команды шаблона
Создание проекта
npm create nsmp-embedded-app@latest my-appИмя проекта можно не указывать — CLI запросит его интерактивно.
Подключение к существующему Vue + Vite проекту
Запустите команду без имени из корня проекта. Если в package.json обнаружены vue и vite, CLI предложит добавить выбранные NSMP-пакеты и утилиты в текущий проект, не копируя шаблон и не изменяя исходный код приложения:
npm create nsmp-embedded-app@latestПакеты добавляются в dependencies, а утилиты — в src/utils. Существующие папки утилит CLI пропускает без перезаписи. Автоматическая настройка импортов и Vue-плагинов в этом режиме не выполняется.
Работа с приложением
| Команда | Назначение |
|---|---|
npm run dev | Запустить Vite в режиме разработки |
npm run pack:modules | Собрать скриптовые модули из modules/ в XML-файл для приложения |
npm run build | Проверить типы, собрать приложение и создать ZIP |
npm run deploy | Загрузить готовый ZIP в NSMP |
npm run release | Последовательно выполнить build и deploy |
Аргументы Vite можно передать после --:
npm run dev -- --host 0.0.0.0Упаковка модулей
npm run pack:modulesКоманда читает все файлы из папки modules/, включая файлы во вложенных папках, и создаёт public/modules/parameters.xml. В этот XML попадают код модуля, его имя и контрольная сумма, необходимые NSMP для импорта скриптовых модулей.
Имя модуля берётся из имени файла без расширения. Например, файл modules/create-task.js станет модулем с кодом create-task.
Если папки modules/ ещё нет, она будет создана автоматически. Если в ней нет файлов, команда завершается успешно и не создаёт XML-файл. npm run build запускает упаковку модулей автоматически перед проверкой типов и сборкой приложения.
Публикация приложения
npm run deployКоманда загружает готовый ZIP-архив из dist-zip/ в NSMP. Перед запуском соберите приложение командой npm run build и создайте .env.deploy.local с обязательными переменными NSMP_URL и NSMP_ACCESS_KEY:
NSMP_URL=https://support.example.ru
NSMP_ACCESS_KEY=replace-meДля сборки и публикации одной командой используйте npm run release. Полный список настроек публикации, включая код, название и TLS-проверку, приведён в разделе «Публикация в NSMP».