Compartilhar via

CLI de Desenvolvimento de Aplicativos do Windows (CLI de WinApp)

Importante

A CLI de Desenvolvimento de Apps do Windows está atualmente em visão pública. Recursos e comandos podem ser alterados antes da versão final. Compartilhe seus comentários criando um problema.

A CLI de Desenvolvimento do aplicativo do Windows (CLI do winapp) é uma interface de linha de comando única para gerenciar SDKs Windows, empacotar, gerar identidade do aplicativo, manifestos, certificados e usar ferramentas de build com qualquer estrutura de aplicativo. Essa ferramenta faz a ponte entre o desenvolvimento multiplataforma e as funcionalidades nativas de Windows.

Se você estiver criando com .NET/Win32, CMake, Electron ou Rust, esta CLI lhe dá acesso a:

  • APIs Modernas do Windows - SDK do Aplicativo Windows e Windows SDK com configuração automática e geração de código
  • Identidade do Pacote – Depurar e testar adicionando a identidade do pacote sem empacotamento completo
  • Empacotamento MSIX – Empacotamento de aplicativos com assinatura e pronto para a Loja
  • Developer Tools - Manifestos, certificados, ativos e integração de build

Por que a identidade do pacote?

Muitas APIs de Windows poderosas exigem que seu aplicativo tenha a identidade do pacote. Com a identidade, seu aplicativo ganha access a recursos como notificações, integração do sistema operacional e IA no dispositivo. Para obter uma lista completa do que a identidade do pacote desbloqueia e ajudar a escolher o modelo de empacotamento correto, consulte a visão geral do empacotamento.

Installation

WinGet

A maneira mais fácil de instalar a CLI é por meio do WinGet (Windows Gerenciador de Pacotes):

winget install Microsoft.winappcli --source winget

NPM

Para projetos do Electron, instale via npm:

npm install @microsoft/winappcli --save-dev

GitHub Actions/Azure DevOps

Para pipelines de CI/CD, use a ação setup-WinAppCli para instalar automaticamente a CLI em seus executores/agentes.

Download manual

Baixe o build mais recente do GitHub Releases.

Verifique a instalação

Depois de instalado, verifique a instalação chamando a CLI:

winapp --help

Ou se estiver usando o Electron/Node.js:

npx winapp --help

Estruturas com suporte

A CLI do winapp funciona com várias estruturas de aplicativo:

Framework Guide
.NET/WPF/WinForms Comece com o .NET
C++ (CMake) Comece com C++
Elétron Comece com Electron
Rust Comece com Rust
Tauri Comece com Tauri
Tremulação Comece com Flutter

Visão geral de comandos

Categoria Comandos
Setup init, restore, update
Embalagem pack, create-debug-identity
Manifestos geração de manifesto, manifesto update-assets
Certificados e Assinatura Gerar certificado, instalar certificado, assinar
utilidades tool, store, get-winapp-path
Node.js/Electron node create-addon, node add-electron-debug-identity, node clear-electron-debug-identity

Para obter a referência completa da CLI, consulte a referência da CLI.

Código aberto

A CLI do winapp é código aberto. Você pode encontrar o código-fonte, problemas de arquivo e contribuir com GitHub.

  • Last updated on