Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Você não precisa reescrever seu aplicativo WPF, Windows Forms ou Win32 para aproveitar os recursos de Windows modernos. O SDK do Aplicativo Windows e a plataforma de Windows mais ampla oferecem funcionalidades modulares que você pode adotar incrementalmente, em seu próprio ritmo.
Use a tabela abaixo para encontrar o ponto de partida certo para sua situação.
Escolha seu caminho de modernização
| Eu desejo... | Abordagem recomendada |
|---|---|
| Adicionar controles de interface do usuário modernos (Fluent, cantos arredondados, modo escuro) ao meu aplicativo WPF ou Win32 | Hospedar controles WinUI em um aplicativo WPF (Ilhas XAML) |
| Utilize recursos da plataforma Windows, como notificações, compartilhamento e seletores de arquivos, em seu aplicativo WPF ou WinForms. | Chamar APIs da Windows Runtime em aplicativos de desktop |
| Empacotar meu aplicativo para o Microsoft Store ou para implantação empresarial | Empacotar um aplicativo de desktop com MSIX |
| Desbloquear recursos que exigem a identidade do pacote (tarefas em segundo plano, extensões de aplicativo) | Conceder identidade a um aplicativo não empacotado |
| Integrar meu aplicativo aos recursos de shell do Windows 11 (organização ajustável, menus de contexto, Barra de Tarefas) | Integre com os recursos do Windows 11 |
| Migrar para um aplicativo completamente moderno com o WinUI 3 com o tempo | Migrar para o WinUI 3 |
| Adicionar recursos de IA ao dispositivo ao meu aplicativo de desktop | Windows AI Foundry |
Qual é o SDK do Aplicativo Windows?
O SDK do Aplicativo Windows é a maneira recomendada de acessar recursos modernos da plataforma Windows de qualquer aplicativo da área de trabalho – WPF, Windows Forms, Win32 ou WinUI 3. Ele fornece um conjunto consistente e com controle de versão de APIs que funcionam em Windows 10 e Windows 11, separados do ciclo de lançamento do sistema operacional.
Você pode usar o SDK do Aplicativo Windows em seu aplicativo existente sem alterar sua estrutura de interface do usuário. Adicione-o como um pacote NuGet e chame suas APIs junto com seu código existente.
Adicionar interface do usuário moderna sem uma reescrita completa
Você pode hospedar controles WinUI 3 dentro das janelas de aplicativos WPF ou Win32 existentes usando o SDK do Aplicativo Windows. Isso permite que você modernize sua interface do usuário incrementalmente — uma janela ou caixa de diálogo por vez — sem migrar todo o aplicativo.
Para obter diretrizes sobre como hospedar controles WinUI 3 em seu aplicativo existente, consulte Hospedar controles XAML do WinRT em aplicativos para desktop (Ilhas XAML). Para efeitos visuais e animações de baixo nível, consulte Modernizar seu aplicativo da área de trabalho usando a camada Visual.
Chamar APIs do Windows Runtime
Muitos recursos da plataforma Windows – notificações por push, o contrato de compartilhamento, seletores de arquivos, Bluetooth e muito mais – são expostos por meio de APIs do Windows Runtime (WinRT). Você pode chamar essas APIs diretamente de aplicativos WPF, Windows Forms e C++ Win32.
Para obter mais informações, consulte Call Windows Runtime APIs em aplicativos da área de trabalho.
Pacote com MSIX
Empacotar seu aplicativo com o MSIX oferece uma experiência de instalação moderna e confiável, desinstalação limpa, atualizações automáticas e acesso à Microsoft Store e aos pipelines de implantação empresariais. O empacotamento MSIX é separado da modernização do código do aplicativo. Você pode empacotar um aplicativo WPF ou Win32 com MSIX sem alterar nenhum código-fonte.
Para obter mais informações, consulte Como criar um pacote MSIX a partir de seu código.
Recursos que exigem a identidade do pacote
Alguns recursos da plataforma Windows , incluindo determinadas tarefas em segundo plano, extensões de aplicativo e destinos de compartilhamento, exigem que seu aplicativo tenha uma identidade de pacote em runtime. Você pode conceder uma identidade a um aplicativo não empacotado sem precisar ser completamente empacotado como pacote MSIX.
Para obter mais informações, consulte:
- Visão geral da identidade do pacote
- Conceder identidade a um aplicativo não empacotado
- Recursos que exigem a identidade do pacote
Integrar com os recursos do shell do Windows 11
Windows 11 apresenta novos pontos de integração do shell – layouts de ajuste, menus de contexto atualizados, cantos de janela arredondados e integração da barra de tarefas. Muitos deles estão disponíveis para aplicativos desktop não empacotados sem alterações de código. Outros exigem extensões de empacotamento.
Para obter mais informações, consulte Integrar seu aplicativo desktop ao Windows usando extensões de empacotamento.
Migrar para o WinUI 3
Se você estiver planejando um esforço de modernização maior ou criando novos recursos como módulos separados, considere criar novos componentes com WinUI 3 e o SDK do Aplicativo Windows. O WinUI 3 é a estrutura de interface do usuário nativa moderna para aplicativos da área de trabalho Windows e é o caminho recomendado para o novo desenvolvimento.
Confira Criar seu primeiro aplicativo WinUI 3 para começar.
Windows developer