TL;DR
Novo lançamento: a Microsoft lançou o Windows App Development CLI v0.2 em 3 de março, adicionando suporte nativo.NET para WinUI 3, WPF, Windows Forms e aplicativos de console. Principais recursos: A atualização apresenta espaços reservados para manifesto, integração da CLI do Microsoft Store Developer e uma experiência de ajuda aprimorada com saída de erro detalhada. Mudanças recentes: A atualização da v0.1 requer a execução manual do certificado winapp, pois a ferramenta não gera mais certificados de assinatura automaticamente durante a inicialização. Instalação: A CLI está disponível via WinGet usando winget install Microsoft.WinAppCLI ou via npm com npm install –save-dev @microsoft/winappcli.
Quando a CLI de desenvolvimento de aplicativos do Windows foi lançada em janeiro, até mesmo observadores experientes do Windows tiveram dificuldade para compreender seu propósito.
A versão 0.2, lançada em 3 de março, agora traz suporte nativo a projetos.NET, marcadores de manifesto e integração com a Microsoft Store que deixam claro o escopo da ferramenta. O engenheiro de software principal Nikola Metulev anunciou o lançamento no Blog de desenvolvedores da Microsoft:
“A CLI de desenvolvimento de aplicativos do Windows v0.2 está aqui! Esta versão é impulsionada em grande parte pelo feedback da comunidade e pacotes de suporte nativo a projetos.NET, espaços reservados de manifesto que eliminam nomes executáveis codificados, integração da CLI do Microsoft Store Developer, uma experiência de ajuda renovada e muito mais.”
Nikola Metulev, Diretor Engenheiro de software (via Microsoft Dev Blog)
A atualização traz suporte nativo.NET para WinUI 3, WPF e Windows Forms, e inclui duas alterações importantes que os desenvolvedores que atualizam da v0.1 devem revisar antes de atualizar seus projetos.
O suporte ao projeto.NET chega como recurso principal
A principal adição na v0.2 é o suporte ao projeto.NET para aplicativos de console WinUI 3, WPF, Windows Forms e.NET. Metulev descreveu a resposta da comunidade diretamente:
“Este foi um dos nossos recursos mais solicitados. Projetos.NET (WinUI, WPF, WinForms, aplicativos de console) agora funcionam nativamente com winapp CLI. Não há mais winapp.yaml para.NET. Basta executar winapp init em uma pasta com um.csproj e a ferramenta cuida do resto.”
Nikola Metulev, engenheiro de software principal (via Windows App Development CLI blog)
A execução do winapp init em uma pasta de projeto.NET detecta.csproj e atualiza TargetFramework para o versão correta do SDK do Windows. Ele também adiciona referências NuGet necessárias (WindowsAppSDK e Microsoft.Windows.SDK.BuildTools) e gera um appxmanifest.xml junto com uma pasta Assets. A ferramenta lida com código x64 e Arm automaticamente, eliminando a necessidade de gerenciar manualmente as diferenças de arquitetura. Anteriormente, o WinUI 3 e outros tipos de projetos.NET exigiam uma camada de configuração separada; A v0.2 resume isso em uma única etapa de inicialização da CLI.
A documentação da CLI do winapp observa que a ferramenta reduz entre 10 e 12 etapas de desenvolvimento, dependendo da plataforma de destino, para quatro comandos da CLI, abrangendo todo o fluxo de trabalho, desde a estrutura do projeto até o empacotamento e o envio da loja.
Para desenvolvedores.NET que anteriormente enfrentavam fluxos de trabalho separados para WinUI 3, WPF e Windows Forms, isso posiciona o winapp como uma camada de unificação genuína, em vez de mais um modelo de projeto. gerador. Cada estrutura carregava suas próprias peculiaridades de andaime e gerenciamento de dependências do NuGet. O tratamento automático das arquiteturas Arm e x64 também remove um ponto de atrito que historicamente tem empurrado os desenvolvedores.NET para alternativas baseadas na Web ou de plataforma cruzada em relação ao desenvolvimento nativo do Windows.
O que mais há de novo na v0.2
Além do suporte.NET, a v0.2 oferece melhorias no tratamento de manifestos, na integração da loja e na UX voltada para o desenvolvedor.
Espaços reservados de manifestos resolvidos no momento do empacotamento é uma adição prática para equipes que compartilham configurações entre compilações. Tokens estilo Visual Studio, como $targetnametoken$ e $targetentrypoint$, são resolvidos automaticamente durante o empacotamento, eliminando nomes executáveis codificados do AppxManifest.xml. Os desenvolvedores que trabalham em várias configurações de build, IDEs ou ambientes de CI não precisam mais atualizar manualmente o manifesto para cada destino.
Com base nesse trabalho de manifesto, um novo subcomando winapp store proxies comanda para a CLI do desenvolvedor da Microsoft Store. Na primeira utilização, o winapp baixa e gerencia o binário msstore automaticamente – nenhuma etapa de instalação separada é necessária. A versão v0.2 também adiciona comandos para catálogos externos e identidade de pacote, e melhora o pacote winapp para que ele grave os arquivos gerados em um diretório temporário em vez da pasta de origem.
Completando a versão, melhorias de UX e duas alterações importantes abordam diretamente a experiência do desenvolvedor. A saída winapp–help agora agrupa comandos relacionados em vez de exibir uma lista simples, e um sinalizador–verbose fornece mensagens de erro detalhadas com formatação mais limpa. Os desenvolvedores que atualizam da v0.1 devem observar: o winapp init não gera mais automaticamente um certificado de assinatura (execute winapp cert generate explicitamente) e a ferramenta agora usa o cache global do NuGet em vez de uma pasta %userprofile%/.winapp/packages dedicada.
Da visualização pública à v0.2
Dois meses após sua estreia em janeiro de 2026, o segundo lançamento da ferramenta revela um padrão claro de iteração ativa. Como o WinBuzzer relatou anteriormente, a Microsoft lançou a visualização pública da CLI de desenvolvimento de aplicativos do Windows em janeiro de 2026. A CLI do desenvolvedor da Microsoft Store, que o winapp v0.2 agora integra, foi revelada em fevereiro de 2026, conforme detalhado no anúncio de integração da CLI do desenvolvedor da Microsoft Store. A cadência rápida sugere que a Microsoft está respondendo ao feedback dos desenvolvedores em vez de tratar o winapp como um utilitário estático e acabado.
O repositório GitHub da ferramenta inclui guias para estruturas.NET, C++/CMake, Electron, Rust e Flutter. Os guias abrangem o uso da API do SDK do aplicativo Windows, a configuração da identidade do depurador e as etapas de empacotamento de aplicativos para cada plataforma compatível. Os desenvolvedores podem instalar ou atualizar a CLI via WinGet usando winget install Microsoft.WinAppCLI ou via npm com npm install–save-dev @microsoft/winappcli.
