Modernizar ou portar um aplicativo Windows com GitHub Copilot

Se você tiver um aplicativo Windows existente – um projeto UWP, um aplicativo de área de trabalho WPF ou WinForms ou um aplicativo de plataforma cruzada Electron ou Flutter – GitHub Copilot poderá acelerar significativamente o processo de atualizá-lo para Windows modernas. Este artigo mostra os principais cenários e as ferramentas que os tornam práticos.

Antes de começar

Verifique se você tem as principais ferramentas configuradas:

  • GitHub Copilot com o plug-in de desenvolvimento WinUI 3 — manipula as diretrizes de migração de API e gera o código moderno correto
  • Microsoft Learn MCP Server – fornece acesso do Copilot à documentação atual do SDK do Aplicativo Windows
  • winapp CLI — adiciona a identidade do pacote e o empacotamento Windows a qualquer estrutura

Se você ainda não configurou isso, comece com Configurar o GitHub Copilot para desenvolvimento no Windows.

Migrar um aplicativo UWP para o WinUI 3

O WinUI 3 é o sucessor moderno da camada de interface do usuário da UWP. As APIs são semelhantes, mas não idênticas : namespaces foram movidos, alguns controles foram alterados e o modelo de aplicativo é diferente. A habilidade de guia de migração do WinUI 3 torna isso tratável.

Executar o guia de migração

Em Copilot Chat, execute a habilidade do guia de migração:

/winui3-development:winui3-migration-guide

Isso produz um plano de migração estruturado adaptado ao seu projeto, incluindo:

  • Um checklist de alterações nos arquivos e no manifesto do projeto
  • Uma tabela de mapeamentos de namespace de API (por exemplo, Windows.UI.Xaml → Microsoft.UI.Xaml)
  • Substituições de controle comuns e exemplos de código antes/depois
  • Diferenças de empacotamento e implantação

Migrar um arquivo

Abra um arquivo de origem UWP e peça a Copilot para migrá-lo:

"Migre esse arquivo da UWP para o WinUI 3. Substitua todas as APIs UWP preteridas pelos equivalentes do WinUI 3. Sinalizar qualquer coisa que precise de revisão manual."

As instruções personalizadas do plugin WinUI 3 orientam o Copilot a realizar substituições corretas. As mais comuns incluem:

UWP WinUI 3
Windows.UI.Xaml.* Microsoft.UI.Xaml.*
CoreDispatcher / RunAsync DispatcherQueue / TryEnqueue
MessageDialog ContentDialog (com XamlRoot)
Windows.UI.Popups Microsoft.UI.Xaml.Controls
BackgroundTaskBuilder SDK do Aplicativo Windows APIs de tarefa de segundo plano

O que Copilot pode ou não fazer automaticamente

O Copilot lida bem com o remapeamento de namespaces na maior parte e com substituições de API simples. Há áreas que precisam de revisão humana:

  • App model changes — eventos de ciclo de vida UWP (Suspending, Resuming) não são mapeados diretamente para o WinUI 3; Copilot pode sugerir alternativas, mas você precisará verificar o comportamento
  • Dicionários de recursos XAML — recursos de tema e estilos personalizados podem precisar de ajuste manual
  • Tarefas em segundo plano – o modelo de empacotamento é diferente; usar a CLI do winapp para configurar as novas entradas de manifesto

Modernizar um aplicativo WPF ou WinForms

Devo atualizar no local ou recompilar com o WinUI 3?

Antes de começar, vale a pena decidir qual direção faz sentido para seu aplicativo. Há alguns caminhos distintos com ferramentas diferentes e escopos distintos.

Sua situação Caminho recomendado
Mantenha WPF ou WinForms como sua estrutura de interface do usuário, vá para .NET 9+ Atualização no local — use o agente de modernização do GitHub Copilot para .NET para automatizar as alterações no arquivo e código do projeto
Adicione recursos de Windows modernos (notificações, IA, integração de shell) ao seu aplicativo existente sem alterar a estrutura da interface do usuário Adicionar recursos do SDK do Aplicativo Windows — confira os cenários abaixo; use o CLI do winapp para adicionar a identidade do pacote, se necessário
Precisa de interface do usuário fluente moderna, suporte a toque, profundidade do WinRT ou uma nova base de código Reconstruir com WinUI 3 — consulte os padrões WPF no WinUI 3 para mapeamento de API; para uma abordagem assistida pelo Copilot, consulte Migrar um aplicativo UWP para o WinUI 3 (específico da UWP, mas o fluxo de trabalho do Copilot é semelhante)
Aplicativo LOB com controles WCF, COM ou controles pesados de interface do usuário de terceiros Faça o upgrade primeiro e depois modernize incrementalmente — o agente de modernização GitHub Copilot para .NET pode ajudar com as atualizações do WCF → CoreWCF, EF e ASP.NET Core.

Observação

"Upgrade" (migrar para uma versão .NET mais recente na mesma estrutura de interface do usuário) e "reconstruir" (migrar para o WinUI 3) são decisões separadas. Você pode atualizar agora e recompilar mais tarde ou fazer os dois ao mesmo tempo para uma substituição em greenfield. A modernização do GitHub Copilot para .NET abrange o caminho de upgrade; as seções abaixo abordam a adição dos recursos do SDK do Aplicativo Windows ao seu aplicativo existente.

os aplicativos WPF e WinForms podem adotar SDK do Aplicativo Windows recursos sem uma reescrita completa. Copilot + o Learn MCP Server facilita a localização e a integração de recursos específicos.

Adicionar notificações por push

Tenho um aplicativo WPF voltado para o .NET 8. Mostre-me como adicionar Windows notificações por push usando a SDK do Aplicativo Windows. O aplicativo não está empacotado no momento."

Com o Learn MCP Server, Copilot busca a documentação de notificação do SDK do Aplicativo Windows atual e gera o código de integração. O suporte básico à notificação por push funciona para aplicativos não empacotados. No entanto, se o aplicativo precisar receber notificações push enquanto ele não estiver em execução, o cenário de produção mais comum, a ativação COM e a entrega em segundo plano exigirão a identidade do pacote. Copilot pode guiá-lo na adição de empacotamento com a CLI winapp, se necessário.

Modernizar a aparência do aplicativo

"Meu aplicativo WPF parece datado. Faça com que pareça moderno com uma opção de modo escuro e uma barra lateral de navegação como os aplicativos de Windows modernos usam".

Adicionar um seletor de arquivos usando SDK do Aplicativo Windows

"Substitua o uso do OpenFileDialog do WPF pelo SDK do Aplicativo Windows StorageFilePicker para uma experiência moderna aprimorada no Windows."

Adicionar Windows notificações

"Adicione uma notificação informando ao usuário quando uma tarefa em segundo plano for concluída."

Copilot fornecerá o código de notificação SDK do Aplicativo Windows. As notificações de aplicativo funcionam em aplicativos empacotados e não empacotados . Nenhuma identidade de pacote é necessária.

Peça ao Copilot para guiá-lo por meio de:

"Quero que meu aplicativo mostre uma notificação do sistema Windows. Explique o que preciso configurar primeiro.

Adicionar recursos de Windows a um aplicativo multiplataforma

Os aplicativos Electron, Flutter, React Native e Rust podem se tornar cidadãos de primeira classe Windows com a CLI winapp. Copilot ajuda você a adaptar seu código para APIs Windows depois de ter a identidade do pacote.

Elétron

npm install @microsoft/winappcli --save-dev
npx winapp init
npx winapp node create-addon --feature notifications

Depois que o complemento for estruturado, peça ao "Copilot" para realizar a integração.

Eu configurei um complemento de notificações do Windows para o meu aplicativo Electron usando a interface de linha de comando (CLI) do winapp. Mostre-me como enviar uma notificação do processo principal quando um download for concluído."

Para obter um passo a passo completo, consulte o guia de instalação do Electron.

Tremulação

winapp init

"Tenho um aplicativo Flutter para Windows. Mostre-me como usar o SDK do Aplicativo Windows para adicionar um ícone de bandeja do sistema com um menu de contexto.".

Consulte o guia Flutter para a configuração específica do Windows.

WPF/.NET

"Tenho um aplicativo WPF. Passe o passo a passo usando a CLI do winapp para adicionar o empacotamento MSIX e, em seguida, adicione um recurso de IA no dispositivo usando as APIs de IA Windows".

Consulte o guia .NET.

O que é desbloqueado pela identidade do pacote

Muitos recursos poderosos do Windows exigem identidade do pacote — que a CLI do winapp pode adicionar a qualquer estrutura. Depois de tê-lo, Copilot pode ajudá-lo a usar:

Característica O que perguntar para o Copilot
Notificações do aplicativo "Adicionar uma notificação do Windows quando meu trabalho em segundo plano for concluído"
IA no dispositivo (Phi Silica, reconhecimento de texto) "Adicionar resumo de texto de inteligência artificial local usando as APIs de IA do Windows"
Integração ao shell do Windows (compartilhamento, barra de tarefas) "Adicionar um destino de compartilhamento para que os usuários possam compartilhar com meu aplicativo do Explorer"
Tarefas em segundo plano "Execute uma tarefa em segundo plano a cada hora, mesmo quando meu aplicativo estiver fechado"
Associações de tipo de arquivo "Registre meu aplicativo para abrir arquivos .notes"

Próximas Etapas 

  • Last updated on