Ferramentas do VS Code para desenvolvimento de Windows

Duas ferramentas do VS Code completam o fluxo de trabalho de desenvolvimento de Windows assistido por IA: a extensão WinApp traz a CLI de Desenvolvimento aplicativo do Windows para o editor e o Microsoft Learn MCP Server fornece ao agente de IA acesso ao vivo à documentação atual do Windows.

Extensão do VS Code do WinApp

A extensão WinApp traz a CLI de desenvolvimento do aplicativo do Windows para o VS Code — inicialize, execute, depure, empacote e assine aplicativos do Windows sem sair do editor.

Note

A extensão está em pré-lançamento. Recursos e comandos podem ser alterados. Comentários do arquivo.

Install

code --install-extension microsoft-winappcli.winapp

Ou pesquise WinApp no painel Extensões (Ctrl+Shift+X). Requer que a CLI do WinApp seja instalada primeiro.

Comandos da paleta de comandos

Todos os comandos estão disponíveis por meio do Ctrl+Shift+P → WinApp:

Command O que faz
WinApp: inicializar projeto Configurar um novo projeto com o SDK do Windows e/ou SDK do Aplicativo Windows
WinApp: executar aplicativo Execute seu aplicativo como um pacote de layout livre com identidade de pacote completa
WinApp: Criar pacote MSIX Empacotar seu aplicativo em um instalador MSIX
WinApp: Criar identidade de depuração Adicionar identidade de pacote esparsa a um executável existente para depuração
WinApp: cancelar o registro do pacote Remover um pacote de desenvolvimento instalado por sideload
WinApp: gerar manifesto Gerar um AppxManifest.xml a partir de um modelo
WinApp: Adicionar alias de execução do manifesto Adicionar um alias de execução ao manifesto do aplicativo
WinApp: Atualizar Recursos do Manifesto Gerar todos os ícones do aplicativo necessários a partir de uma única imagem-fonte
WinApp: gerar certificado Criar um certificado de assinatura de desenvolvimento
WinApp: Informações do certificado Exibir detalhes sobre um arquivo de certificado
WinApp: Instalar certificado Instalar um .pfx ou .cer certificado (requer Administrador)
WinApp: Assinar pacote Assinar um pacote MSIX com um certificado
WinApp: restaurar pacotes Restaurar pacotes e dependências do projeto
WinApp: atualizar pacotes Atualizar pacotes para as versões mais recentes
WinApp: Obter o caminho do WinApp Mostrar o caminho para o executável da CLI do WinApp instalado
WinApp: executar a ferramenta SDK Executar diretamente as ferramentas do SDK do Windows

Workflow

  1. dotnet new winui-navview -n MyApp — projeto base
  2. cd MyApp && dotnet run — compilar e verificar se ele é executado
  3. code . — abrir no VS Code
  4. Ctrl+Shift+P → WinApp: Executar Aplicativo — executar com a identidade do pacote
  5. Editar arquivos XAML e C# com assistência de IA
  6. Ctrl+Shift+P → WinApp: Criar pacote MSIX — pacote para distribuição
  7. winapp store publish ./*.msix --appId <your-app-id> — publicar na Loja

Servidor MCP do Microsoft Learn

Os modelos de IA são treinados com base em um recorte da web. No desenvolvimento para Windows, isso significa que seu agente pode ter aprendido com exemplos de WPF e UWP escritos anos antes de o WinUI 3 existir — e ele não consegue perceber a diferença. O servidor MCP do Microsoft Learn corrige isso fornecendo ao seu agente uma ferramenta que ele pode invocar para obter documentação atual e oficial no momento em que precisar.

O que é MCP?

O PROTOCOLO MCP (Model Context Protocol) é um padrão aberto que permite que agentes de IA chamem ferramentas externas e fontes de dados durante uma conversa. Em vez de depender inteiramente de dados de treinamento, um agente conectado ao MCP pode pesquisar e ler conteúdo ao vivo , incluindo Microsoft Learn, antes de gerar uma resposta.

Adicionar o servidor MCP do Microsoft Learn

O servidor é hospedado por Microsoft e não requer nenhuma instalação ou entrada.

VS Code (GitHub Copilot)

Adicione o seguinte ao seu projeto .vscode/mcp.json:

{
  "servers": {
    "microsoft-learn": {
      "type": "http",
      "url": "https://dotnet.territoriali.olinfo.it/api/mcp"
    }
  }
}

O VS Code solicitará que você habilite o servidor na primeira vez que abrir uma sessão de chat Copilot.

Código Claude

Adicione o servidor à configuração do Claude Code (~/.claude/mcp_servers.json):

{
  "microsoft-learn": {
    "type": "http",
    "url": "https://dotnet.territoriali.olinfo.it/api/mcp"
  }
}

Outros clientes MCP

Qualquer cliente compatível com o transporte HTTP do MCP pode se conectar usando:

https://dotnet.territoriali.olinfo.it/api/mcp

Nenhuma chave de API ou autenticação necessária.

O que o servidor pode fazer

Uma vez conectado, seu agente pode pesquisar e recuperar páginas do Microsoft Learn. Para o desenvolvimento no Windows, isso significa que ele pode consultar:

  • ApIs de controle e padrões de uso atuais do WinUI 3
  • SDK do Aplicativo Windows notas de versão e guias de migração
  • winapp Referência de comando da CLI
  • Requisitos de envio da loja e critérios de certificação

Exemplo

Sem o servidor MCP, pedir ao Copilot para adicionar um seletor de arquivo pode gerar código usando o padrão UWP FileOpenPicker preterido:

// ❌ UWP pattern — may be generated without MCP context
var picker = new FileOpenPicker();
picker.SuggestedStartLocation = PickerLocationId.DocumentsLibrary;

Com o servidor MCP conectado, o agente recupera as diretrizes atuais do WinUI 3 e gera o padrão correto:

// ✅ WinUI 3 pattern — retrieved from current docs
var picker = new FileOpenPicker();
var hwnd = WinRT.Interop.WindowNative.GetWindowHandle(this);
WinRT.Interop.InitializeWithWindow.Initialize(picker, hwnd);
picker.SuggestedStartLocation = PickerLocationId.DocumentsLibrary;
var file = await picker.PickSingleFileAsync();

Dica

Para obter diretrizes mais profundas específicas do WinUI, combine o servidor MCP com o plug-in do agente WinUI. O plug-in manipula padrões de codificação; o servidor MCP manipula a recuperação de documentação.