Aplicação do Windows Development CLI (winapp CLI)

Importante

O CLI de Desenvolvimento de Aplicações 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.

A CLI de Desenvolvimento de Apps do Windows (winapp CLI) é uma interface única de linha de comandos para gerir SDKs do Windows, pacotes, gerar identidade de app, manifestos, certificados e usar ferramentas de build com qualquer framework de apps. 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:

  • APIs Modern Windows - SDK de Aplicações Windows e Windows SDK 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. Com a identidade, a sua aplicação ganha acesso a funcionalidades como notificações, integração com o sistema operativo e IA no dispositivo. Para uma lista completa do que a identidade da embalagem desbloqueia e ajuda na escolha do modelo de embalagem certo, consulte Visão Geral da Embalagem.

Instalação

WinGet

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

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 Introdução ao .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 gerar manifest, atualizar ativos do manifest
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.

Código aberto

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

  • Last updated on