Поделиться через


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

Это важно

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:

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.