Partilhar via


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

Nesta introdução ao ambiente integrado de desenvolvimento (IDE) do Visual Studio, cria uma aplicação "Hello World" que corre em qualquer dispositivo com Windows 10 ou posterior. Para isso, utiliza-se um modelo de projeto do Windows App SDK (WinUI 3), a Extensible Application Markup Language (XAML) e a linguagem de programação C#.

Observação

O WinUI 3 é o componente nativo da plataforma de interface que vem com o Windows App SDK. Está completamente desacoplado dos SDKs do Windows. Para obter mais informações, consulte WinUI 3.

Pré-requisitos

  • Precisa do Visual Studio 2026 ou da versão mais recente do Visual Studio 2022 para completar este tutorial. Para uma versão gratuita, consulte downloads do Visual Studio.
  • Cargas de trabalho e componentes necessários para o desenvolvimento com WinUI e o SDK de Aplicativo Windows. Para verificar ou instalar uma carga de trabalho no Visual Studio, selecione Ferramentas >Obter Ferramentas e Recursos. Para obter mais informações, consulte Alterar Cargas de Trabalho ou Componentes Individuais.

Na guia Cargas de trabalho do instalador do Visual Studio, selecione o seguinte:

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

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

Observação

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 de aplicativos Windows.

Criar um projeto

Primeiro, crie um projeto WinUI 3. O tipo de projeto vem com todos os arquivos de modelo que você precisa, antes mesmo de adicionar qualquer coisa!

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

  2. No ecrã Criar um novo projeto , introduza WinUI na caixa de pesquisa, escolha o modelo C# para WinUI Blank App (Packaged) e depois escolha Próximo.

    Captura de ecrã do diálogo 'Criar um novo projeto' com 'WinUI' introduzido na caixa de pesquisa, e o modelo de projeto WinUI Blank App (Packaged) destacado.

  3. Dê um nome ao projeto, HelloWorlde escolha Criar.

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

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

  2. Na janela de Criar um novo projeto, introduza winui na caixa de pesquisa, escolha o modelo C# para Aplicação em Branco, Empacotada (WinUI 3 no Ambiente de Trabalho) e depois escolha Seguinte.

    Captura de ecrã do diálogo 'Criar um novo projeto' no Visual Studio 2022 com 'WinUI' introduzido na caixa de pesquisa, e o modelo do projeto WinUI Blank App (Packaged) destacado.

  3. Dê um nome ao projeto, HelloWorlde escolha Criar.

    Captura de ecrã do diálogo 'Configurar o seu novo projeto' no Visual Studio 2022 com 'HelloWorld' introduzido no campo nome do projeto.

Observação

Se este artigo for a primeira vez que usa o Visual Studio para criar uma aplicação SDK de aplicações Windows, pode aparecer um diálogo de Definições . Escolha modo de desenvolvedore, em seguida, escolha Sim.

Captura de ecrã a mostrar o diálogo Definições com a opção de ativar o Modo Desenvolvedor.

O Visual Studio instala outro pacote do Modo Desenvolvedor para si. Quando a instalação do pacote estiver concluída, feche o diálogo de Definições .

Criar o aplicativo

É hora de começar a desenvolver. Aqui adicionas um controlo de botão, adicionas uma ação ao botão e depois executas a aplicação Hello World para ver como fica.

Adicionar um botão à área de design

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

    Captura de ecrã da janela do Explorador de Soluções a mostrar as propriedades, referências, recursos e ficheiros no projeto HelloWorld, com o ficheiro MainWindow.xaml selecionado.

    O do Editor XAML é onde você pode adicionar ou alterar marcações. Ao contrário dos projetos UWP, o WinUI 3 não tem um Design view.

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

  2. Dentro do <Grid> item, comece a escrever <Button. O Intellisense oferece-te uma opção de botões. Prima Tab para aceitar.

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

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

    Captura de ecrã da janela do Explorador de Soluções no Visual Studio 2022 a mostrar as propriedades, referências, recursos e ficheiros no projeto HelloWorld, com o ficheiro MainWindow.xaml selecionado.

    O do Editor XAML é onde você pode adicionar ou alterar marcações. Ao contrário dos projetos UWP, o WinUI 3 não tem um Design view.

    Captura de ecrã que mostra o MainWindow.xaml aberto no IDE Visual Studio 2022. O painel do Editor XAML mostra a marcação XAML para a janela.

  2. Revise o controlo Botão aninhado no do StackPanel na raiz da Window.

    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 dos Botões do seu valor atual para "Hello World!".

    Captura de ecrã que mostra o código XAML para o Botão no editor XAML, com o valor da propriedade Conteúdo alterado para Hello World!

  2. Coloca o cursor na <Button> tag inicial do elemento (depois dos atributos existentes, como Content) e começa a escrever Click. A Intellisense oferece um novo gestor de eventos chamado Button_Click. Trabalhas com esse código na secção seguinte.

    Captura de ecrã que mostra o código XAML do Botão no editor XAML, com o evento de clique do botão destacado.

  1. No Editor XAML, altere o valor do Conteúdo dos Botões do seu valor atual para "Hello World!".

    Captura de ecrã que mostra o código XAML do Botão no editor XAML no Visual Studio 2022, com o valor da propriedade Conteúdo alterado para Hello World!

  2. Observe que o botão também tem um manipulador de eventos Click chamado myButton_Click especificado. Trabalhe com isso no próximo passo.

    Captura de ecrã mostrando o código XAML do Botão no editor XAML no Visual Studio 2022 com o evento de clique do botão destacado.

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. Neste caso, adiciona uma ação desencadeada pelo Hello World! botão.

  1. No Explorador de Soluções, clique duas vezes em MainWindow.xaml.cs, a página da camada de código.

  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.

    Vamos mudá-lo, para que fique assim:

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

    Aqui está 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 Explorador de Soluções, clique duas vezes em MainWindow.xaml.cs, a página da camada de código.

  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 ecrã que mostra o código C# para o handler de eventos de Button_Click predefinido no Visual Studio 2022.

    Vamos mudá-lo, para que fique assim:

    Captura de ecrã que mostra o código C# para o novo gestor de eventos assíncrono myButton_Click no Visual Studio 2022.

    Aqui está 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 de ContentDialog para exibir uma mensagem de boas-vindas em um controle pop-up modal dentro da janela atual. Para mais informações sobre a utilização de Microsoft.UI.Xaml.Controls.ContentDialog, veja Classe ContentDialog.

Execute o aplicativo

Está na altura de construir, implementar e lançar a aplicação Hello World utilizando o SDK da Aplicação Windows para ver como fica. Veja como.

  1. Usa o botão Play para iniciar a aplicação na máquina local. Tem o texto HelloWorld (Pacote).

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

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

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

    Captura de ecrã a mostrar a aplicação 'Hello World' do SDK de Aplicações Windows em execução.

  3. Selecione o botão Hello World.

    O seu dispositivo com Windows 10 ou mais recente mostra uma mensagem que diz "Bem-vindo à sua primeira aplicação do Windows App SDK" com o título "Hello from HelloWorld." Selecione Ok para descartar 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. Alternativamente, escolha Debug>Stop Debugging na barra de menu, ou pressione Shift+F5.

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

Estes recursos também podem ser úteis: