Início rápido: Crie a sua primeira aplicação WinUI 3

Configurar seu ambiente de desenvolvimento

Para desenvolver aplicações WinUI 3 com o Visual Studio, precisa do Visual Studio 2026 com as cargas de trabalho necessárias e o Modo Desenvolvedor ativado.

Configurar com o WinGet (recomendado)

Abra o Terminal do Windows e execute o seguinte comando no PowerShell para instalar automaticamente o Visual Studio 2026 com as cargas de trabalho necessárias e ativar o Modo Desenvolvedor usando um ficheiro de configuração WinGet:

winget configure -f https://aka.ms/winui-config

Para rever o ficheiro de configuração e saber mais, consulte o README na GitHub.

Install-Module -Name Microsoft.WinGet.Client -Force
Repair-WinGetPackageManager -AllUsers

Configurar manualmente

Se preferir instalar ferramentas manualmente:

1. Ative o Modo de Programador: abra as Definições do Windows, navegue até Sistema > Avançadas e altere Modo de Programador para Ativado.

2. Descarregue e instale o Visual Studio 2026. Para mais detalhes, veja Install Visual Studio.

3. No Visual Studio Installer, selecione a carga de trabalho de desenvolvimento de aplicações WinUI no separador Workloads. Para desenvolvimento em C++, selecione também as ferramentas de desenvolvimento de aplicações WinUI em C++ nessa carga de trabalho, no painel de detalhes da instalação.

   

Crie e lance a sua primeira aplicação WinUI 3

1. Abra o Visual Studio 2026 e selecione Criar um novo projeto.

2. Pesquise por WinUI, selecione o modelo de projeto WinUI Blank App (Packaged) C# e selecione Seguinte.

   

3. Introduza o nome de um projeto e selecione Criar.

   

4. Pressiona Iniciar (F5) para construir e executar a sua aplicação.

   

   A sua aplicação é construída, implementada e lançada em modo de depuração:

   

   Criou e lançou a sua primeira aplicação WinUI 3! 🎉

Prerequisites

• Windows 10 versão 1809 (build 17763) ou posterior
• Modo Desenvolvedor ativado (ms-settings:developers)
• .NET 10 SDK ou posterior (verificar com dotnet --version)

Crie e execute a sua primeira aplicação WinUI 3

1. Instale os templates de projeto WinUI 3 para dotnet new (execute uma vez):

   dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates
   

2. Crie um novo projeto e avance para ele:

   dotnet new winui -n MyWinUIApp
   cd MyWinUIApp
   

3. Compile o projeto:

   dotnet build
   

4. Execute o aplicativo:

   dotnet run
   

   O modelo inclui Microsoft.Windows.SDK.BuildTools.WinApp, que se integra no destino run da CLI do .NET para registar uma identidade de depuração e iniciar a aplicação com identidade de pacote MSIX — não é necessária nenhuma etapa manual de implantação.

   Abre-se uma janela de aplicação vazia. Criou e lançou a sua primeira aplicação WinUI 3! 🎉