Visual Studio para desenvolvimento de aplicações para Windows

Visual Studio é o IDE recomendado para construir aplicações Windows com WinUI e o SDK de Aplicações Windows. Proporciona uma integração profunda com a plataforma Windows e ferramentas concebidas especificamente para o desenvolvimento de aplicações baseadas em XAML.

As principais funcionalidades para os programadores de aplicações Windows incluem:

  • XAML Hot Reload — Modifica a marcação XAML enquanto a tua aplicação está a correr e vê as alterações aplicadas instantaneamente sem reiniciar
  • Árvore Visual XAML Live — inspecione a árvore visual em tempo de execução da sua aplicação em execução para depurar problemas de layout e compreender a hierarquia dos elementos
  • IntelliSense para XAML e C#/C++ — obtenha conclusão automática de código, informações rápidas e realce de erros tanto para marcação como para código por detrás
  • Depuração integrada — define pontos de interrupção em XAML e código, inspeciona ligações de dados e diagnostica problemas de renderização da interface de utilizador

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

Modelos de Projeto do WinUI

O Visual Studio inclui modelos de projeto para o ajudar a criar rapidamente aplicações WinUI. Para os localizar, abra File>New>Project, depois filtre por WinUI no menu pendente de tipos de projeto ou pesquise por WinUI.

Modelos de projeto WinUI

Modelos de aplicação

Escolhe um modelo com base no shell da aplicação a partir do qual queres começar. Selecione o nome de um modelo para ver uma captura de ecrã da aplicação que ele cria.

Template Linguagem Modelo de CLI winapp Descrição
Aplicação em Branco WinUI (Empacotada) C# e C++ winui (C#) Uma única janela sem conteúdo. Este é o ponto de partida recomendado para a maioria das novas aplicações.
Aplicação de Navegação WinUI C# winui-navview Um shell NavigationView com páginas Inicial, Sobre e Definições.
Aplicação WinUI TabView C# winui-tabview Um shell TabView cujos separadores estão na barra de título.
Aplicação WinUI MVVM C# winui-mvvm Um modelo de página e visualização que utiliza o padrão Model-View-ViewModel (MVVM) com o CommunityToolkit.Mvvm.
Aplicação em Branco (Incluída com o WAP Project) C# e C++ Não disponível Uma aplicação em branco mais um Projeto separado de Empacotamento de Aplicações Windows.

Crie um projeto a partir da linha de comandos

Os modelos de aplicações em C# também estão disponíveis a partir do terminal através do Aplicação do Windows Development CLI (winapp CLI). Passe o nome do modelo da tabela para winapp new, depois construa e lance a aplicação 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, por isso podes abri-lo no Visual Studio a qualquer momento. Para mais informações, consulte Usar a linha de comando do winapp com WinUI.

Aplicativo em branco WinUI (empacotado)

Cria uma aplicação de ambiente de trabalho em C# (.NET) ou C++ (Win32) com uma interface baseada em WinUI. O projeto começa com uma única janela derivada de Microsoft.UI.Xaml.Window, pronta para você adicionar os seus próprios controlos e páginas. Este é o ponto de partida recomendado para a maioria das novas aplicações. Para um guia, consulte Criar e executar um projeto WinUI 3.

Uma aplicação criada a partir do modelo WinUI Blank App, mostrando uma janela vazia com uma barra de título.

Aplicação de Navegação WinUI

Cria uma aplicação C# com uma NavigationView no painel esquerdo. O modelo inclui as páginas Início e Sobre, um item de Definições e o código de navegação que alterna entre elas.

Uma aplicação criada a partir do modelo WinUI Navigation App, que mostra um painel de navegação com os itens Inicial, Sobre e Definições e a página inicial.

Aplicação TabView do WinUI

Cria uma aplicação C# com um TabView que se estende até à barra de título. O modelo inclui separadores Página Principal e Sobre e um botão para adicionar novos separadores.

Uma aplicação criada a partir do modelo WinUI TabView App, que mostra os separadores Início e Sobre na barra de título.

Aplicação MVVM WinUI

Cria uma aplicação em C# que separa a interface da lógica com o padrão MVVM. O template usa o CommunityToolkit.Mvvm para propriedades e comandos observáveis, e mostra um contador vinculado a um modelo de visualização.

Uma aplicação criada a partir do modelo WinUI MVVM App, que mostra um título Hello, WinUI! e um contador com botões de incremento e decremento.

Blank App (Incluído com o Projeto WAP)

Igual ao modelo WinUI Blank App (Packaged) acima, mas adiciona um projeto de empacotamento de aplicações Windows separado à solução. Este projeto lida com a criação da sua aplicação num pacote MSIX para distribuição. Se preferir uma configuração mais simples, pode usar projeto único MSIX para evitar manter o projeto de embalagem separado.

Modelos de componentes e de teste

Estes modelos criam bibliotecas e projetos de teste que funcionam em conjunto com uma aplicação WinUI.

Template Linguagem Modelo da CLI do winapp Descrição
Biblioteca de Classes WinUI C# winui-lib Uma biblioteca de classes .NET (DLL) para partilhar código e componentes de interface entre aplicações WinUI.
Componente de Runtime do Windows C++ Não disponível Um componente Windows Runtime escrito em C++/WinRT que pode ser consumido por qualquer aplicação com uma interface baseada em WinUI, independentemente da linguagem de programação.
Aplicação de Testes Unitários WinUI C# e C++ winui-unittest (C#) Um projeto MSTest para escrever e executar testes automatizados contra a sua aplicação.

Modelos de itens WinUI

Os modelos de itens permitem-te adicionar novos ficheiros a um project WinUI existente. Clique com o botão direito do seu projeto em Explorador de Soluções, selecione Adicionar>Novo Item e escolha o separador WinUI.

Modelos de item 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 ficheiro XAML e um ficheiro de código que define um novo diálogo derivado da Microsoft.UI.Xaml.Controls.ContentDialog. Para mais informações, veja Controlos de diálogo.
Dicionário de Recursos C# e C++ Adiciona uma coleção vazia de recursos XAML com chave. Para obter mais informações, consulte ResourceDictionary e referências de recursos XAML.
Arquivo de Recursos (.resw) C# e C++ Adiciona um arquivo para armazenar recursos condicionais e de cadeia de caracteres para seu aplicativo. Você pode usar este item para ajudar a localizar seu aplicativo. Para saber mais, veja Localizar cadeias de caracteres no manifesto da interface do usuário e do pacote do aplicativo.
Controle baseado em modelo C# e C++ Adiciona um arquivo de código para criar um controle de modelo com um estilo padrão. O controlo com modelo é derivado da classe Microsoft.UI.Xaml.Controls.Control.

Para um guia que demonstra como usar este modelo de item, veja Build XAML templated controls. Para obter mais informações sobre controles modelados, consulte Controles XAML personalizados.
Controlo de Utilizador 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 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 estes itens na linha de comandos num projeto C#, use o modelo de item correspondente dotnet new, como dotnet new winui-page -n SettingsPage. Executa dotnet new list winui para ver todos os modelos de itens.

Consulte também

  • Última atualização a