CLI для разработки приложений Windows (winapp CLI)

Это важно

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

CLI разработки приложений Windows (winapp CLI) — это единый интерфейс командной строки для управления SDK Windows, формированием пакетов, созданием идентификаций приложений, манифестами, сертификатами и использованием средств сборки с любым фреймворком приложений. Это средство позволяет преодолеть разрыв между кроссплатформенной разработкой и Windows собственными возможностями.

Независимо от того, используете ли вы .NET/Win32, CMake, Electron или Rust для создания, этот CLI предоставляет вам доступ:

  • Modern Windows API - Windows App SDK и пакет SDK Windows с автоматической настройкой и созданием кода
  • Удостоверение пакета — отладка и тестирование путем добавления удостоверения пакета без полной упаковки
  • Упаковка MSIX — пакетирование приложений с подписыванием и готовностью для публикации в магазине
  • Developer Tools — манифесты, сертификаты, ресурсы и интеграция сборки

Почему идентификация пакета?

Многие влиятельные Windows API требуют, чтобы у вашего приложения была идентификация пакета. Благодаря идентификации приложение получает access к функциям, таким как уведомления, интеграция ОС и ИИ на устройстве. Полный список возможностей удостоверения пакета и помощь в выборе правильной модели упаковки вы можете найти в Обзоре упаковочных решений.

Installation

WinGet

Самый простой способ установки интерфейса командной строки — через WinGet (Windows диспетчер пакетов):

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

Дополнительные руководства.

  • Упаковка EXE/CLI: пошаговое руководство по упаковке существующего EXE/CLI как MSIX
  • Завершение оболочки: включение завершения вкладки для команд, параметров и значений в PowerShell, bash, zsh и fish

Общие сведения о командах

Категория Commands
Setup init, restore, update
Идентификация и отладка run, create-debug-identity, unregister
Упаковка упаковывать
Манифесты создание манифеста, обновление ресурсов манифеста, добавление псевдонима в манифесте
Сертификаты и подписывание Создание сертификата, установка сертификата, подпись, создание внешнего каталога
утилиты tool, store, get-winapp-path, complete
Автоматизация пользовательского интерфейса ui
Node.js/Electron node create-addon, node add-electron-debug-identity, node clear-electron-debug-identity

Полный справочник см. в разделе CLI reference.

Открытый исходный код

Интерфейс командной строки Winapp с открытым исходным кодом. Вы можете найти исходный код, сообщить о проблемах и внести свой вклад на GitHub.

  • Last updated on