Visual Studio para o desenvolvimento de aplicativos Windows

Visual Studio é o IDE recomendado para criar aplicativos Windows com WinUI e o SDK do Aplicativo Windows. Ele fornece integração profunda com a plataforma Windows e ferramentas criadas para o desenvolvimento de aplicativos baseado em XAML.

Os principais recursos para desenvolvedores de aplicativos Windows incluem:

• XAML Recarga Dinâmica — modifique a marcação XAML enquanto o aplicativo estiver em execução e veja as alterações aplicadas instantaneamente sem reiniciar
• Árvore Visual Dinâmica XAML – inspecione a árvore visual de runtime do aplicativo em execução para depurar problemas de layout e entender a hierarquia de elementos
• IntelliSense para XAML e C#/C++ — obtenha preenchimento de código, informações rápidas e realce de erros para marcação e code-behind
• Depuração integrada – definir pontos de interrupção em XAML e código, inspecionar associações de dados e diagnosticar problemas de renderização da interface do usuário

Para começar, consulte Criar e executar um projeto WinUI 3.

Modelos de projeto WinUI

Visual Studio inclui modelos de projeto para ajudá-lo a criar rapidamente aplicativos WinUI. Para encontrá-los, abra File>New>Project, em seguida, filtre por WinUI na lista suspensa do tipo project ou pesquise WinUI.

Modelos de aplicativos

Escolha um modelo com base no shell do aplicativo que você quer usar como ponto de partida. Selecione um nome de modelo para ver uma captura de tela do aplicativo que ele cria.

Template	Linguagem	Modelo da CLI do winapp	Descrição
Aplicativo WinUI em branco (empacotado)	C# e C++	winui (C#)	Uma única janela sem conteúdo. Esse é o ponto de partida recomendado para a maioria dos novos aplicativos.
Aplicativo de Navegação WinUI	C#	winui-navview	Um shell NavigationView com páginas Página Inicial, Sobre e Configurações.
Aplicativo WinUI TabView	C#	winui-tabview	Um shell tabView cujas guias estão na barra de título.
Aplicativo WinUI MVVM	C#	winui-mvvm	Uma página e um view model que utilizam o padrão Model-View-ViewModel (MVVM) com CommunityToolkit.Mvvm.
Aplicativo em branco (empacotado com projeto WAP)	C# e C++	Não disponível	Um aplicativo em branco mais um projeto separado de empacotamento de aplicativos do Windows.

Criar um projeto a partir da linha de comando

Os modelos de aplicativo C# também estão disponíveis no terminal por meio da aplicativo do Windows Development CLI (CLI do winapp). Passe o nome do modelo da tabela para winapp new, em seguida, compile e inicie o aplicativo com winapp run:

winapp new --name MyApp --template winui-navview --use-defaults
cd MyApp
winapp run

Execute winapp new --list para ver todos os templates instalados. O projeto gerado é um .csproj padrão, portanto, você pode abri-lo em Visual Studio a qualquer momento. Para obter mais informações, consulte Como usar a CLI do winapp com WinUI.

Aplicativo WinUI em branco (empacotado)

Cria um aplicativo da área de trabalho em C# (.NET) ou C++ (Win32) com uma interface do usuário baseada em WinUI. O projeto começa com uma única janela derivada de Microsoft.UI.Xaml.Window, pronta para que você adicione seus próprios controles e páginas. Esse é o ponto de partida recomendado para a maioria dos novos aplicativos. Para obter um passo a passo, consulte Criar e executar um projeto WinUI 3.

Aplicativo de Navegação WinUI

Cria um aplicativo C# com um NavigationView no painel esquerdo. O modelo inclui páginas Página Inicial e Sobre, um item configurações e o código de navegação que alterna entre elas.

Aplicativo WinUI TabView

Cria um aplicativo C# com um TabView que se estende até a barra de título. O modelo inclui guias Página Inicial e Sobre e um botão para adicionar novas guias.

Aplicativo WinUI MVVM

Cria um aplicativo C# que separa a interface do usuário da lógica com o padrão MVVM. O modelo usa CommunityToolkit.Mvvm para comandos e propriedades observáveis e mostra um contador associado a um view model.

Aplicativo em branco (empacotado com Projeto WAP)

Equivale ao modelo do Aplicativo WinUI em Branco (Empacotado) acima, mas adiciona um Projeto de Empacotamento de Aplicativo do Windows separado à solução. Este projeto trata da criação do seu aplicativo em um pacote MSIX para distribuição. Se preferir uma configuração mais simples, você poderá usar single-project MSIX em vez disso para evitar a manutenção do projeto de empacotamento separado.

Modelos de componente e teste

Esses modelos criam bibliotecas e testam projetos que funcionam junto com um aplicativo WinUI.

Template	Linguagem	Modelo da CLI do winapp	Descrição
Biblioteca de classes WinUI	C#	winui-lib	Uma DLL (biblioteca de classes) .NET para compartilhar código e componentes de interface do usuário em aplicativos WinUI.
Componente Windows Runtime	C++	Não disponível	Um componente Windows Runtime escrito em C++/WinRT que pode ser consumido por qualquer aplicativo com uma interface do usuário baseada em WinUI, independentemente da linguagem de programação.
Aplicativo de teste de unidade WinUI	C# e C++	winui-unittest (C#)	Um projeto MSTest para escrever e executar testes automatizados em seu aplicativo.

Modelos de itens WinUI

Os modelos de item permitem adicionar novos arquivos a um project WinUI existente. Clique com o botão direito do mouse no seu projeto em Gerenciador de Soluções, selecione Adicionar>Novo Item e escolha a guia WinUI.

Template	Linguagem	Descrição
Página em branco	C# e C++	Adiciona um arquivo XAML e um arquivo de código que define uma nova página derivada da classe Microsoft.UI.Xaml.Controls.Page .
Janela em branco	C# e C++	Adiciona um arquivo XAML e um arquivo de código que define uma nova janela derivada da classe Microsoft.UI.Xaml.Window .
Caixa de Diálogo de Conteúdo	C#	Adiciona um arquivo XAML e um arquivo de código que define uma nova caixa de diálogo derivada da classe Microsoft.UI.Xaml.Controls.ContentDialog. Para obter mais informações, consulte controles de caixa de diálogo.
Dicionário de recursos	C# e C++	Adiciona uma coleção vazia chaveada de recursos XAML. Para obter mais informações, consulte referências de recursos ResourceDictionary e XAML.
Arquivo de recursos (.resw)	C# e C++	Adiciona um arquivo para armazenar cadeia de caracteres e recursos condicionais para seu aplicativo. Você pode usar esse item para ajudar a localizar seu aplicativo. Para obter mais informações, confira Localizar as cadeias de caracteres em sua interface do usuário e o manifesto do pacote do aplicativo.
Controle Modelo	C# e C++	Adiciona um arquivo de código para criar um controle modelo com um estilo padrão. O controle modelo é derivado da classe Microsoft.UI.Xaml.Controls.Control . Para obter um tutorial que demonstra como usar esse modelo de item, consulte Criar controles com modelos XAML. Para obter mais informações sobre controles modelo, consulte Controles XAML Personalizados.
Controle de usuário	C# e C++	Adiciona um arquivo XAML e um arquivo de código para criar um controle de usuário que deriva da classe Microsoft.UI.Xaml.Controls.UserControl . Normalmente, um controle de usuário encapsula os controles existentes relacionados e fornece sua própria lógica. Para obter mais informações sobre controles de usuário, consulte Controles XAML Personalizados.

Para adicionar esses itens pela linha de comando em um projeto C#, use o modelo de item correspondente dotnet new, como dotnet new winui-page -n SettingsPage. Execute dotnet new list winui para ver todos os modelos de item.

Consulte também

• SDK do Aplicativo do Windows
• Criar e executar um projeto WinUI 3
• exemplos do SDK de Aplicativos do Windows