Windows App Dev CLI v0.3: F5 a partir do terminal e automação de UI para agentes

Emiliano Montesdeoca — Thu, 23 Apr 2026 00:00:00 +0000

Esta publicação foi traduzida automaticamente. Para a versão original, clique aqui.

A experiência F5 do Visual Studio é fantástica. Mas ter que abrir o VS só para lançar e depurar uma app Windows empacotada é demais — seja num pipeline de CI, num workflow automatizado, ou quando um agente de IA está fazendo os testes.

Windows App Development CLI v0.3 acabou de ser lançada e aborda isso diretamente com dois recursos principais: winapp run e winapp ui.

winapp run: F5 a partir de qualquer lugar

winapp run recebe uma pasta de app não empacotada e um manifesto, e faz tudo que o VS faz num debug launch: registra um pacote loose, lança a app e preserva o LocalState entre re-deploys.

# Compilar a app e então executá-la como app empacotada
winapp run ./bin/Debug

Funciona para WinUI, WPF, WinForms, Console, Avalonia e mais. Os modos são pensados para desenvolvedores e workflows automatizados:

--detach: Lança e devolve o controle ao terminal imediatamente. Perfeito para CI.
--unregister-on-exit: Limpa o pacote registrado ao fechar a app.
--debug-output: Captura mensagens OutputDebugString e exceções em tempo real.

Novo pacote NuGet: dotnet run para apps empacotadas

Para desenvolvedores .NET há um novo pacote NuGet: Microsoft.Windows.SDK.BuildTools.WinApp. Após a instalação, dotnet run cuida de todo o inner loop: build, preparar um pacote loose-layout, registrar no Windows e lançar — tudo em uma etapa.

winapp init
# ou
dotnet add package Microsoft.Windows.SDK.BuildTools.WinApp

winapp ui: UI Automation a partir da linha de comando

Este é o recurso que abre os cenários agênticos. winapp ui fornece acesso completo de UI Automation a qualquer app Windows em execução — WPF, WinForms, Win32, Electron, WinUI3 — diretamente do terminal.

O que é possível fazer:

Listar todas as janelas de nível superior
Navegar pela árvore completa de UI Automation de uma janela
Procurar elementos por nome, tipo ou ID de automação
Clicar, invocar e definir valores
Tirar screenshots
Aguardar o aparecimento de elementos — ideal para sincronização de testes

Combinar winapp ui com winapp run cria um workflow completo build → lançar → verificar a partir do terminal. Um agente pode executar a app, inspecionar o estado da UI e validar o resultado.

Outras novidades

winapp unregister: Remove um pacote sideloaded quando terminar.
winapp manifest add-alias: Adiciona um alias para lançar a app por nome a partir do terminal.
Tab completion: Configure o completamento PowerShell com um único comando.

Como obter

winget install Microsoft.WinAppCli
# ou
npm install -g @microsoft/winappcli