Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Это важно
CLI разработки Windows App в настоящее время находится в общественном предварительном тестировании. Функции и команды могут изменяться до окончательного выпуска. Поделитесь своим отзывом, создайте запрос.
Интерфейс командной строки разработки Windows App (winapp CLI) — это единый интерфейс командной строки для управления пакетами SDK для Windows, упаковки, создания удостоверения приложения, манифестов, сертификатов и использования средств сборки с любой платформой приложений. Это средство позволяет преодолеть разрыв между кроссплатформенной разработкой и возможностями Windows.
Независимо от того, создаете ли вы с использованием .NET/Win32, CMake, Electron или Rust, этот интерфейс командной строки предоставляет доступ к:
- Модерн API Windows - Windows App SDK и windows SDK с автоматической настройкой и созданием кода
- Удостоверение пакета — отладка и тестирование путем добавления удостоверения пакета без полной упаковки
- Упаковка MSIX — пакетирование приложений с подписыванием и готовностью для публикации в магазине
- Developer Tools — манифесты, сертификаты, ресурсы и интеграция сборки
Почему идентификация пакета?
Многие мощные API Windows требуют, чтобы приложение имело идентификацию пакета, что позволяет использовать компоненты ОС Windows, к которым у вас в противном случае не было бы доступа. Благодаря идентификации приложение получает access к функциям, таким как уведомления, интеграция ОС и ИИ на устройстве.
Примеры возможностей, которые раскрывает идентификация пакета и упаковка MSIX:
- Интерактивные собственные уведомления и управление уведомлениями
- Интеграция с проводником Windows, панелью задач, листом общего доступа и другими поверхностями оболочки
-
Обработчики протоколов (
yourapp://URI) - ИИ на устройстве (локальные интерфейсы LLM, API ИИ для текста и изображений)
- Фоновые задачи (запуск при закрытии приложения)
- Сопоставления типов файлов
- Чистая установка/удаление и автоматические обновления
Installation
WinGet
Самый простой способ установки интерфейса командной строки — через WinGet (Windows Package Manager):
winget install Microsoft.winappcli --source winget
NPM
Для проектов Electron установите через npm:
npm install @microsoft/winappcli --save-dev
GitHub Actions / Azure DevOps
Для pipelines CI/CD используйте действие setup-WinAppCli для автоматической установки интерфейса командной строки на средства выполнения или агенты.
Скачивание вручную
Скачайте последнюю сборку из GitHub релизов.
Проверка установки
После установки проверьте установку, вызвав интерфейс командной строки:
winapp --help
Или при использовании Electron/Node.js:
npx winapp --help
Поддерживаемые платформы
Интерфейс командной строки winapp работает с различными платформами приложений:
| Платформа | Guide |
|---|---|
| .NET / WPF / WinForms | Начало работы с .NET |
| C++ (CMake) | Начните с C++ |
| Электрон | Начните с Electron |
| Rust | Начните с Rust |
| Тельца | Начать работу с Tauri |
| Трепетание | Начните с Flutter |
Общие сведения о командах
| Категория | Commands |
|---|---|
| Setup | init, restore, update |
| Упаковка | pack, create-debug-identity |
| Манифесты | создание манифеста, обновление ресурсов манифеста |
| Сертификаты и подписывание | Создание сертификата, установка сертификата, подпись |
| утилиты | утилита, хранилище, get-winapp-path |
| Node.js/Electron | node create-addon, node add-electron-debug-identity, node clear-electron-debug-identity |
Полный справочник см. в разделе CLI reference.
Open source
Интерфейс командной строки winapp с открытым исходным кодом. Вы можете найти исходный код, завести отчёты о проблемах и внести свой вклад на GitHub.
Связанные темы
Windows developer