Partilhar via

Windows App Development CLI (winapp CLI)

Importante

O CLI de Desenvolvimento de Aplicações do Windows encontra-se atualmente em pré-visualização pública. As funcionalidades e comandos podem mudar antes do lançamento final. Partilhe o seu feedback criando um problema.

O Windows App Development CLI (winapp CLI) é uma interface única de linha de comandos para gerir SDKs do Windows, empacotamento, gerar identidade de aplicação, manifestos, certificados e utilizar ferramentas de compilação com qualquer framework de aplicação. Esta ferramenta faz a ponte entre o desenvolvimento multiplataforma e as capacidades nativas do Windows.

Quer esteja a construir com .NET/Win32, CMake, Electron ou Rust, esta CLI dá-lhe acesso a:

  • Modern Windows APIs - Windows App SDK e SDK do Windows com configuração automática e geração de código
  • Identidade de Pacote - Depurar e testar adicionando identidade de pacote sem empacotamento completo
  • MSIX Packaging - Embalagem de aplicações com assinatura e preparação para a Store
  • Developer Tools - Manifestos, certificados, ativos e integração de builds

Porquê a identidade do pacote?

Muitas APIs poderosas do Windows exigem que a sua aplicação tenha identidade de pacote, permitindo-lhe tirar partido de componentes do sistema operativo que o Windows oferece e aos quais de outra forma não teria acesso. Com a identidade, a sua aplicação ganha acesso a funcionalidades como notificações, integração com o sistema operativo e IA no dispositivo.

Exemplos do que a identidade da embalagem e a embalagem MSIX desbloqueiam:

Instalação

WinGet

A forma mais fácil de instalar a CLI é através do WinGet (Windows Package Manager):

winget install Microsoft.winappcli --source winget

NPM

Em projetos Electron, instale via npm:

npm install @microsoft/winappcli --save-dev

GitHub Actions / Azure DevOps

Para pipelines CI/CD, usa a ação setup-WinAppCli para instalar automaticamente a CLI nos teus runners/agentes.

Transferência manual

Descarregue a versão mais recente de GitHub Releases.

Verificar a instalação

Depois de instalado, verifique a instalação chamando a linha de código:

winapp --help

Ou, se estiver a usar Electron/Node.js:

npx winapp --help

Estruturas suportadas

O Winapp CLI funciona com uma variedade de frameworks de aplicações:

Framework Guide
.NET / WPF / WinForms Comece com o .NET
C++ (CMake) Comece a usar C++
Elétron Inicie com o Electron
Ferrugem Comece com Rust
Tauri Começar com o Tauri
Flutter Comece com o Flutter

Visão geral dos comandos

Categoria Comandos
Configuração iniciar, restaurar, atualizar
Empacotamento pack, criar-debug-identidade
Manifestos manifest generate, manifest update-assets
Certificados e Assinatura gerar certificado, instalar certificado, assinar
Utilities ferramenta, armazenar, get-winapp-path
Node.js/Electron nó criar-addon, nó adicionar-identidade-debug-electron, nó limpar-identidade-debug-electron

Para a referência completa de CLI, veja referência de CLI.

Open source

O winapp CLI é open source. Podes encontrar o código-fonte, problemas de ficheiros e contribuir em GitHub.

  • Last updated on