Início Rápido: Criar e publicar um aplicativo Windows com IA

Neste início rápido, você passa de uma pasta vazia para um aplicativo de Windows publicado usando a assistência de IA. Não é necessário Visual Studio.

Note

Prefere trabalhar em Visual Studio? Consulte Set up GitHub Copilot for Windows development. Este início rápido usa o VS Code e a CLI do winapp.

  • Instalar as ferramentas gratuitas necessárias (aproximadamente 5 minutos)
  • Gerar um aplicativo WinUI pela linha de comando
  • Usar o winui-dev agente de IA para adicionar recursos
  • Empacotar e publicar no Microsoft Store

Tempo de conclusão: aproximadamente 30 minutos
Cost: gratuito (GitHub Copilot camada gratuita é suficiente)

Prerequisites

Instale as ferramentas a seguir antes de começar. Todos são gratuitos.

1. Visual Studio Code

winget install Microsoft.VisualStudioCode

2. .NET SDK 10 ou posterior

winget install Microsoft.DotNet.SDK.10

3. CLI de Desenvolvimento de Aplicativos do Windows (winapp CLI)

winget install Microsoft.winappcli --source winget

4. Novos modelos winUI dotnet

dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates

5. GitHub CLI (necessário para comandos gh copilot — precisa de uma assinatura GitHub Copilot, disponível gratuitamente)

winget install GitHub.cli

Importante

Feche e reabra o terminal após a conclusão da instalação. O gh comando não estará disponível até que uma nova sessão do shell pegue o PATH atualizado.

gh auth login
gh extension install github/gh-copilot

6. Plug-in do agente WinUI para GitHub Copilot

gh copilot plugin install winui@awesome-copilot

7. Extensão do WinApp para VS Code

code --install-extension microsoft-winappcli.winapp

Ou pesquise WinApp no painel Extensões (Ctrl+Shift+X). Consulte as ferramentas do VS Code para obter uma referência de comando completa.

Verificar sua configuração

winapp --version

Dica

Para obter melhores resultados, conecte também o agente de IA ao servidor mcp do Microsoft Learn – ele busca documentos de API do WinUI 3 atuais em tempo de consulta em vez de depender de dados de treinamento.

Etapa 1: Gerar a estrutura de um novo aplicativo WinUI

Crie uma nova pasta e gere a estrutura de um aplicativo WinUI com o layout NavigationView:

mkdir MyFirstApp
cd MyFirstApp
dotnet new winui-navview

Etapa 2: Executar o aplicativo

Crie e execute o aplicativo para confirmar se tudo está funcionando antes de começar a adicionar recursos:

dotnet run

O aplicativo é iniciado como um pacote de layout flexível – nenhuma instalação MSIX é necessária. Você deve ver um aplicativo WinUI 3 com um NavigationView contendo páginas Página Inicial, Sobre e Configurações:

Captura de tela do MyFirstApp em execução — uma janela WinUI 3 com um NavigationView mostrando itens Home, About e Settings, com a home page selecionada exibindo

Depois que ele for iniciado com êxito, abra o projeto no VS Code:

code .

Note

Não pressione F5 antes da primeira dotnet run bem-sucedida. O depurador do VS Code procura um .exe que ainda não existe. Após a conclusão bem-sucedida de dotnet run, F5 e o botão Executar no painel da extensão WinApp funcionam normalmente.

Etapa 3: Usar o agente de IA para adicionar um recurso

No VS Code, abra o GitHub Copilot Chat (Ctrl+Alt+I), alterne para o modo Agent e selecione o agente winui-dev. Digite uma solicitação como:

Add a settings page to my WinUI NavigationView app with a toggle for dark mode

O agente gera o código, cria todos os arquivos necessários e atualiza sua estrutura de navegação. Examine as alterações e verifique o resultado:

dotnet run

Navegue até a página Configurações no aplicativo em execução para confirmar se o recurso foi adicionado corretamente.

Dica

Deseja automatizar a verificação da interface do usuário? Consulte Testando aplicativos WinUI para ver os comandos winapp ui que inspecionam, pesquisam e fazem capturas de tela da árvore de interface do usuário do seu aplicativo — úteis para pipelines de CI.

Etapa 4: Empacotar o aplicativo

Publique seu aplicativo em uma pasta e, em seguida, empacote-o como um instalador MSIX.

Importante

A etapa de empacotamento instala um certificado no repositório raiz confiável do computador e requer um terminal elevado (Administrador). Clique com o botão direito do mouse no PowerShell ou Terminal do Windows e selecione Run como administrador e navegue de volta para a pasta do projeto.

dotnet publish -o ./publish
winapp pack ./publish --generate-cert --install-cert

--generate-cert --install-cert cria e instala um certificado de desenvolvimento local para teste. Para submissão à Loja, use seu certificado do Partner Center em vez disso.

Etapa 5: Publicar no Microsoft Store

Envie seu aplicativo diretamente da linha de comando:

winapp store publish ./*.msix --appId <your-app-id>

Note

A publicação requer uma conta do Partner Center. A certificação de aplicativos normalmente leva de 1 a 3 dias úteis.

Próximas Etapas 

Você criou e publicou um aplicativo Windows usando apenas ferramentas gratuitas e assistência de IA. Aqui está onde ir a seguir:

  • Last updated on