Escolher um caminho de desenvolvimento Windows

Para um novo aplicativo de desktop nativo do Windows, use WinUI 3 com o SDK do Aplicativo Windows. O WinUI 3 é Microsoft estrutura de interface do usuário nativa recomendada para novos aplicativos Windows e o SDK do Aplicativo Windows é a plataforma de desenvolvimento recomendada.

Se você mantiver um aplicativo WPF, Windows Forms ou Win32 existente, não precisará necessariamente reescrevê-lo. Você pode adicionar SDK do Aplicativo Windows recursos ao aplicativo atual ou migrar sua interface do usuário para o WinUI 3. Se você mantiver um aplicativo UWP, siga o caminho de migração para o SDK do Aplicativo Windows e WinUI 3.

Escolha seu caminho

O seu cenário	Caminho recomendado
Você está iniciando um novo aplicativo nativo Windows desktop	Use WinUI 3 com o SDK do Aplicativo Windows.
Você mantém um aplicativo WPF ou Windows Forms	Mantenha sua estrutura de interface do usuário atual e adicione SDK do Aplicativo Windows recursos ou migre sua interface do usuário para o WinUI 3.
Você mantém um aplicativo C++ Win32	Continue a usar o Win32 quando necessário e adicione SDK do Aplicativo Windows recursos.
Você mantém um aplicativo UWP	Planeje uma migração para o SDK do Aplicativo Windows.
Seu aplicativo deve compartilhar sua interface do usuário e código entre sistemas operacionais	Examine a documentação da estrutura multiplataforma.
Você deseja tornar um site instalável no Windows	Consulte a documentação sobre Aplicativos Web Progressivos.

Iniciar um novo aplicativo com o WinUI 3

O WinUI 3 fornece a estrutura nativa de interface do usuário para aplicativos da área de trabalho do Windows. Ele usa XAML com C# ou C++ e é fornecido como parte do SDK do Aplicativo Windows.

Criar seu primeiro aplicativo WinUI 3

Para obter mais informações, consulte a visão geral do WinUI 3, SDK do Aplicativo Windows visão geral e o tutorial do WinUI 3.

Modernizar ou migrar um aplicativo existente

Você pode adotar Windows recursos de plataforma incrementalmente sem alterar sua estrutura de interface do usuário existente. O SDK do Aplicativo Windows dá suporte a aplicativos WPF, Windows Forms e C++ Win32 existentes.

• Para adicionar janelas, ciclo de vida do aplicativo, renderização de texto e outros recursos de SDK do Aplicativo Windows, consulte Usar o SDK do Aplicativo Windows em um projeto existente.
• Para comparar a modernização incremental com uma migração de interface do usuário, consulte Os recursos de Windows modernos para aplicativos da área de trabalho.
• Para mover uma camada de interface do usuário existente para o WinUI 3, consulte Migrar para o SDK do Aplicativo Windows.
• Se você mantiver um aplicativo UWP, consulte Migrar da UWP para o SDK do Aplicativo Windows.

Localizar documentação para outra estrutura

Use esses links quando você mantém um aplicativo criado com outra estrutura ou tem um requisito que o WinUI 3 não aborda, como compartilhar uma interface do usuário em vários sistemas operacionais.

Tecnologia	Documentation
WPF	visão geral WPF
Windows Forms	Visão geral do Windows Forms
Win32 e C++/WinRT	Programação da área de trabalho win32 e C++/WinRT
UWP	Diretrizes de documentação e migraçãoda UWP
.NET MAUI	visão geral do .NET MAUI
React Native para desktop	React Native para Windows
Elétron	Introdução ao Electron no Windows
Aplicativos Web Progressivos	Aplicativos Web Progressivos no Windows

Entender os SDKs de Windows

O SDK do Aplicativo Windows fornece um conjunto de APIs e ferramentas para aplicativos da área de trabalho, incluindo WinUI 3, ciclo de vida do aplicativo, janelas e notificações. Ele é fornecido pelo NuGet em um ciclo de lançamento separado de Windows. Você pode usá-lo ao criar um aplicativo WinUI 3 ou adicionar muitos de seus recursos a um aplicativo de área de trabalho existente.

O SDK do Windows fornece os cabeçalhos, bibliotecas, metadados e ferramentas para acessar Windows APIs do sistema operacional. Use-o quando seu aplicativo precisar do Win32, Windows Runtime, DirectX ou outros recursos do sistema operacional.