Compartilhar via


Tutorial: Criar seu primeiro aplicativo SDK de Aplicativo do Windows no Visual Studio com XAML e C#

Nesta introdução ao IDE (ambiente de desenvolvimento integrado) do Visual Studio, você cria um aplicativo "Olá, Mundo" que é executado em qualquer dispositivo Windows 10 ou posterior. Para fazer isso, use um modelo de projeto do SDK de Aplicativo do Windows (WinUI 3), XAML (Extensible Application Markup Language) e a linguagem de programação C#.

Nota

O WinUI 3 é o componente nativo da plataforma de interface do usuário que é fornecido com o SDK do Aplicativo do Windows. Ele é completamente dissociado dos SDKs do Windows. Para obter mais informações, consulte WinUI 3.

Pré-requisitos

  • Você precisa do Visual Studio 2026 ou da versão mais recente do Visual Studio 2022 para concluir este tutorial. Para obter uma versão gratuita, consulte os downloads do Visual Studio.
  • Cargas de trabalho e componentes necessários para o desenvolvimento com o WinUI e o SDK do Aplicativo do Windows. Para verificar ou instalar uma carga de trabalho no Visual Studio, selecione Ferramentas>Obter Ferramentas e Recursos. Para obter mais informações, consulte Modificar cargas de trabalho ou componentes individuais.

Na guia Cargas de Trabalho do Instalador do Visual Studio, selecione o seguinte:

Para o desenvolvimento de aplicativos em C# usando o SDK do Aplicativo do Windows, selecione o desenvolvimento de aplicativos WinUI.

Para o desenvolvimento de aplicativos em C# usando o SDK do Aplicativo do Windows, selecione o desenvolvimento de aplicativos WinUI.

Nota

No Visual Studio 17.10 – 17.12, essa carga de trabalho é chamada de desenvolvimento de aplicativos do Windows.

Para obter detalhes, consulte Instalar ferramentas para o SDK do Aplicativo do Windows.

Criar um projeto

Primeiro, crie um projeto WinUI 3. O tipo de projeto vem com todos os arquivos de modelo necessários, antes mesmo de adicionar qualquer coisa!

  1. Abra o Visual Studio e, na janela inicial, escolha Criar um novo projeto.

  2. Na tela Criar um novo projeto , insira WinUI na caixa de pesquisa, escolha o modelo C# para o Aplicativo WinUI em Branco (Empacotado) e escolha Avançar.

    Captura de tela da caixa de diálogo

  3. Dê um nome ao projeto, HelloWorld, e escolha Criar.

    Captura de tela da caixa de diálogo 'Configurar seu novo projeto' com 'HelloWorld' inserido no campo Nome do Projeto.

  1. Abra o Visual Studio e, na janela inicial, escolha Criar um novo projeto.

  2. Na tela Criar um novo projeto , insira winui na caixa de pesquisa, escolha o modelo C# para modelo C# para Aplicativo em Branco, Empacotado (WinUI 3 na Área de Trabalho) e escolha Avançar.

    Captura de tela da caixa de diálogo

  3. Dê um nome ao projeto, HelloWorld, e escolha Criar.

    Captura de tela da caixa de diálogo

Nota

Se este artigo for a primeira vez que você usa o Visual Studio para criar um aplicativo SDK de Aplicativo do Windows, uma caixa de diálogo Configurações poderá aparecer. Escolha Modo Desenvolvedore então escolha Sim.

Captura de tela mostrando a caixa de diálogo Configurações com a opção para habilitar o Modo de Desenvolvedor.

O Visual Studio instala outro pacote do Modo de Desenvolvedor para você. Quando a instalação do pacote for concluída, feche a caixa de diálogo Configurações .

Criar o aplicativo

É hora de começar a desenvolver. Aqui você adiciona um controle de botão, adiciona uma ação ao botão e, em seguida, executa o aplicativo Hello World para ver a aparência dele.

Adicionar um botão à tela de Design

  1. No Gerenciador de Soluções, clique duas vezes em MainWindow.xaml para abrir o editor de marcação XAML.

    Captura de tela da janela Gerenciador de Soluções mostrando as propriedades, referências, ativos e arquivos no projeto HelloWorld, com o arquivo MainWindow.xaml selecionado.

    O Editor de XAML é onde você pode adicionar ou alterar a marcação. Ao contrário dos projetos UWP, o WinUI 3 não tem uma exibição Design.

    Captura de tela mostrando MainWindow.xaml aberto no IDE do Visual Studio. O painel Editor XAML mostra a marcação XAML da janela.

  2. Dentro do <Grid> item, comece a digitar <Button. O Intellisense oferece uma opção de botão. Pressione Tab para aceitar.

    Captura de tela mostrando 'Button' realçado no editor XAML.

  1. No Gerenciador de Soluções, clique duas vezes em MainWindow.xaml para abrir o editor de marcação XAML.

    Captura de tela da janela Gerenciador de Soluções no Visual Studio 2022 mostrando as propriedades, referências, ativos e arquivos no projeto HelloWorld, com o arquivo MainWindow.xaml selecionado.

    O Editor de XAML é onde você pode adicionar ou alterar a marcação. Ao contrário dos projetos UWP, o WinUI 3 não tem uma exibição Design.

    Captura de tela mostrando MainWindow.xaml aberto no IDE do Visual Studio 2022. O painel Editor XAML mostra a marcação XAML da janela.

  2. Examine o controle de Botão aninhado no StackPanel na raiz da Janela.

    Captura de tela mostrando 'Button' realçado no editor XAML.

Alterar o rótulo no botão

  1. No Editor XAML, altere o valor do Conteúdo do Botão de seu valor atual para "Olá, Mundo!".

    Captura de tela mostrando o código XAML para o Botão no editor XAML, com o valor da propriedade Content alterado para Hello World!

  2. Coloque o <Button> cursor na marca inicial do elemento (após os atributos existentes, como Content) e comece a digitar Clique. O Intellisense oferece um novo manipulador de eventos chamado Button_Click. Você trabalha com esse código na próxima seção.

    Captura de tela mostrando o código XAML do Botão no editor XAML com o evento de clique do botão realçado.

  1. No Editor XAML, altere o valor do Conteúdo do Botão de seu valor atual para "Olá, Mundo!".

    Captura de tela mostrando o código XAML para o Botão no editor XAML no Visual Studio 2022, com o valor da propriedade Content alterado para Hello World!

  2. Observe que o botão também tem um manipulador de eventos de Clique chamado myButton_Click especificado. Você irá trabalhar com isso na próxima etapa.

    Captura de tela mostrando o código XAML para o Botão no editor XAML no Visual Studio 2022 com o evento de clique do botão realçado.

Modificar o manipulador de eventos

Um manipulador de eventos parece complicado, mas é apenas outro nome para o código que é chamado quando um evento acontece. Nesse caso, ele adiciona uma ação disparada pelo Hello World! botão.

  1. No Gerenciador de Soluções, clique duas vezes em MainWindow.xaml.cs, na página code-behind.

  2. Edite o código do manipulador de eventos na janela do editor C# que é aberta.

    Aqui é onde as coisas ficam interessantes. O manipulador de eventos padrão tem esta aparência:

    Captura de tela mostrando o código C# para o manipulador de eventos de Button_Click padrão.

    Vamos alterá-lo, para que fique assim:

    Captura de tela mostrando o código C# para o novo manipulador de eventos assíncrono myButton_Click.

    Este é o código para copiar e colar:

    private async void Button_Click(object sender, RoutedEventArgs e)
    {
        var welcomeDialog = new ContentDialog()
        {
            Title = "Hello from HelloWorld",
            Content = "Welcome to your first Windows App SDK app.",
            CloseButtonText = "Ok",
            XamlRoot = ((FrameworkElement)sender).XamlRoot
        };
        await welcomeDialog.ShowAsync();
    }
    
  1. No Gerenciador de Soluções, clique duas vezes em MainWindow.xaml.cs, na página code-behind.

  2. Edite o código do manipulador de eventos na janela do editor C# que é aberta.

    Aqui é onde as coisas ficam interessantes. O manipulador de eventos padrão tem esta aparência:

    Captura de tela mostrando o código C# para o manipulador de eventos Button_Click padrão no Visual Studio 2022.

    Vamos alterá-lo, para que fique assim:

    Captura de tela mostrando o código C# para o novo manipulador de eventos assíncrono myButton_Click no Visual Studio 2022.

    Este é o código para copiar e colar:

    private async void myButton_Click(object sender, RoutedEventArgs e)
    {
        var welcomeDialog = new ContentDialog()
        {
            Title = "Hello from HelloWorld",
            Content = "Welcome to your first Windows App SDK app.",
            CloseButtonText = "Ok",
            XamlRoot = myButton.XamlRoot
        };
        await welcomeDialog.ShowAsync();
    }
    

O que acabamos de fazer?

O código usa o controle ContentDialog para exibir uma mensagem de boas-vindas em um controle pop-up modal dentro da janela atual. Para obter mais informações sobre como usar Microsoft.UI.Xaml.Controls.ContentDialog, consulte a Classe ContentDialog.

Executar o aplicativo

É hora de criar, implantar e iniciar o aplicativo Hello World Windows App SDK para ver a aparência dele. Veja como.

  1. Use o botão Reproduzir para iniciar o aplicativo no computador local. Ele tem o texto HelloWorld (Pacote).

    Captura de tela mostrando a caixa suspensa aberta ao lado do botão Reproduzir com 'HelloWorld (Pacote)' selecionado.

    Como alternativa, você pode escolher Depurar>Iniciar Depuração na barra de menus ou pressionar F5 para iniciar seu aplicativo.

  2. Veja o aplicativo, que aparece logo depois que uma tela inicial desaparece. O aplicativo deve ser semelhante a esta imagem:

    Captura de tela mostrando o aplicativo

  3. Selecione o botão Hello World.

    Seu dispositivo Windows 10 ou posterior exibe uma mensagem que diz "Bem-vindo ao seu primeiro aplicativo SDK de Aplicativo do Windows" com o título "Olá do HelloWorld". Selecione Ok para ignorar a mensagem.

    Captura de tela mostrando o aplicativo 'Hello World' em execução com um pop-up intitulado 'Hello from HelloWorld'.

  4. Para fechar o aplicativo, selecione o botão Parar Depuração na barra de ferramentas. Como alternativa, escolha Depurar>Parar depuração na barra de menus ou pressione Shift+F5.

Parabéns por concluir este tutorial! Esperamos que você tenha aprendido algumas noções básicas sobre o SDK do Aplicativo do Windows, o WinUI 3 e o IDE do Visual Studio. Para saber mais, continue com o seguinte tutorial:

Esses recursos também podem ser úteis: