Início rápido: criar seu primeiro aplicativo WinUI 3

Crie, compile e execute seu primeiro aplicativo WinUI 3. Escolha Visual Studio para uma experiência de IDE completa com suporte de designer visual ou dotnet novo para funcionar na linha de comando em qualquer editor. Use as abas abaixo para alternar entre as duas abordagens.

Visual Studio

Configurar seu ambiente de desenvolvimento

Para desenvolver aplicativos WinUI 3 com Visual Studio, você precisa Visual Studio 2026 com as cargas de trabalho necessárias e o Modo de Desenvolvedor habilitados.

Configurar com o WinGet (recomendado)

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

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

Para examinar o arquivo de configuração e saber mais, consulte seu README no GitHub.

Note

Se o WinGet não estiver disponível em seu ambiente, instale-o primeiro:

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

Consulte Como usar o WinGet para obter mais informações.

Configurar manualmente

Se você preferir instalar as ferramentas manualmente:

1. Habilitar o Modo de Desenvolvedor: abra Windows Configurações, navegue até o System > Advanced e alterne o Modo do Desenvolvedor para Ativado.

2. Baixe e instale Visual Studio 2026. Para obter detalhes, consulte Instalar Visual Studio.

3. No instalador Visual Studio, selecione a carga de trabalho de desenvolvimento de aplicativos WinUI na guia Cargas de Trabalho. Para o desenvolvimento do C++, selecione também as ferramentas de desenvolvimento de aplicativos WinUI do C++ nessa carga de trabalho no painel Detalhes da Instalação.

   

Dica

Se você não vir os modelos WinUI após instalar o Visual Studio, abra o Instalador do Visual Studio, selecione Modificar e confirme se a carga de trabalho desenvolvimento de aplicativos WinUI está marcada. Reinicie Visual Studio depois de modificar a instalação.

Criar e iniciar seu primeiro aplicativo WinUI 3

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

2. Pesquise por WinUI, selecione o modelo de projeto C# do WinUI Blank App (Empacotado) e selecione Avançar.

   

3. Insira um nome de projeto e selecione Criar.

   

4. Pressione Iniciar (F5) para compilar e executar seu aplicativo.

   

   Seu aplicativo cria, implanta e inicia no modo de depuração:

   

   Você criou e iniciou seu primeiro aplicativo WinUI 3! 🎉

Linha de comando

Pré-requisitos

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

Criar e executar seu primeiro aplicativo WinUI 3

1. Instale os modelos de projeto do WinUI 3 para dotnet new (executar uma vez):

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

2. Crie um novo projeto e navegue até 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 conecta-se ao destino da CLI run .NET para registrar uma identidade de depuração e iniciar o aplicativo com a identidade do pacote MSIX – nenhuma etapa de implantação manual é necessária.

   Uma janela de aplicativo vazia é aberta. Você criou e iniciou seu primeiro aplicativo WinUI 3! 🎉

Próximas etapas

Criar seu primeiro aplicativo WinUI
Pronto para ir mais longe? Siga o tutorial passo a passo para criar um aplicativo WinUI completo.

Galeria do WinUI 3
Explore exemplos interativos de controles, recursos e funcionalidades do WinUI.

Exemplos e recursos
Navegue por exemplos de código, projetos iniciais e ferramentas para acelerar seu desenvolvimento.