Introdução ao WinUI

O WinUI 3 é o framework nativo de interface para construir aplicações de ambiente de trabalho Windows. Faz parte do SDK de Aplicações Windows — um conjunto de APIs e ferramentas separadas do próprio sistema operativo Windows e que devem ser instaladas na máquina de destino ou empacotadas juntamente com a sua aplicação. O WinUI 3 suporta tanto C# como C++ e não é um framework multiplataforma ou baseado na web.

Importante

O WinUI 3 é distinto do UWP. O WinUI 3 utiliza o Microsoft.UI.Xaml namespace e executa-se como um processo de ambiente de trabalho; O UWP utiliza Windows.UI.Xaml e corre num contentor de aplicação. O WinUI 3 suporta distribuição empacotada (MSIX), empacotada com localização externa e distribuição não empacotada — a escolha correta depende do seu cenário de implementação. Consulte Escolher um método de distribuição para orientação.

Escolhe o teu caminho

Existem dois caminhos suportados para criar um projeto WinUI 3.

	Visual Studio	Linha de comandos
Melhor para	Desenvolvedores novos no desenvolvimento Windows, designers de UI visual ou qualquer pessoa que queira uma experiência completa no IDE	Desenvolvedores à vontade com o terminal, pipelines CI/CD ou configuração do ambiente por script
Ferramentas	Visual Studio 2026 com as cargas de trabalho do SDK de Aplicações Windows e WinUI instaladas	.NET 10 SDK com dotnet new Modelos WinUI
Criação do Project	Assistente de Novo Projeto — selecione o modelo Blank App, Packaged (WinUI 3 in Desktop)	dotnet new winui -n MyApp
Construir e executar	Pressione F5 — O Visual Studio constrói, assina, implementa o pacote MSIX e lança a aplicação	dotnet run — constrói e lança a aplicação com identidade de pacote (requer o Modo Desenvolvedor)
Debugging	Depurador completo do Visual Studio com pré-visualização em direto de XAML	Anexe um depurador manualmente ou abra o .sln gerado no Visual Studio

Ambos os caminhos produzem projetos equivalentes ao WinUI 3. A via do Visual Studio trata automaticamente da assinatura e da distribuição do MSIX. O caminho da linha de comandos utiliza dotnet run para desenvolvimento local (o pacote Microsoft.Windows.SDK.BuildTools.WinApp incluído gere automaticamente a identidade de depuração); o empacotamento para distribuição exige passos adicionais.

Prerequisites

Ambos os percursos partilham os mesmos requisitos mínimos.

• Windows 10 versão 1809 (build 17763) ou posterior — recomenda-se o Windows 11
• Modo Desenvolvedor ativado no seu dispositivo (ms-settings:developers)
• Visual Studio 2026 (caminho do Visual Studio) ou SDK .NET 10 (caminho da linha de comandos)

O SDK de Aplicações Windows é uma instalação separada do Windows. O Visual Studio instala-o como parte da configuração da carga de trabalho. Para a via da linha de comandos, os modelos dotnet new winui incluem automaticamente os pacotes NuGet necessários.

Passos seguintes

Início rápido: Visual Studio

Início rápido: Linha de comandos