Compartilhar via

Tutorial: Criar seu primeiro aplicativo da Plataforma Universal do Windows no Visual Studio com XAML e C#

  • Artigo

Neste tutorial, como uma 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 da Plataforma Universal do Windows (UWP), XAML (Extensible Application Markup Language) e a linguagem de programação C#.

Nota

Se você estiver satisfeito com sua funcionalidade atual na UWP (Plataforma Universal do Windows), não será necessário migrar seu tipo de projeto para o SDK do Aplicativo do Windows. O WinUI 2.x e o SDK do Windows dão suporte a tipos de projeto UWP. Se você quiser começar a usar o WinUI 3 e o SDK do Aplicativo do Windows, siga as etapas no tutorial do SDK do Aplicativo do Windows.

Neste tutorial, você:

  • Criar um projeto
  • Criar um aplicativo
  • Executar o aplicativo

Pré-requisitos

Você precisa do Visual Studio para concluir este tutorial. Visite a página de downloads do Visual Studio para obter uma versão gratuita.

Nota

Este tutorial requer o modelo de projeto Aplicativo em Branco (Universal do Windows). Durante a instalação, selecione a carga de trabalho de desenvolvimento da Plataforma Universal do Windows:

Captura de tela do Instalador do Visual Studio mostrando a carga de trabalho de desenvolvimento da Plataforma Universal do Windows.

Se você já tiver o Visual Studio instalado e precisar adicioná-lo, no menu, selecione Ferramentas>Obter Ferramentas e Recursosou, na janela Criar um novo projeto, selecione o link Instalar mais ferramentas e recursos.

Captura de tela da janela Criar um novo projeto mostrando o link

Criar um projeto

Primeiro, crie um projeto da Plataforma Universal do Windows. 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 janela Criar um novo projeto, insira Universal Windows na caixa de pesquisa, escolha o modelo C# para Aplicativo em Branco (Universal Windows) e, em seguida, escolha Avançar.

    Captura de tela da caixa de diálogo “Criar um novo projeto” com “janelas universais” inseridas na caixa de pesquisa e o modelo de projeto “Aplicativo em Branco (Universal do Windows)” realçado.

  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.

  4. Aceite as configurações padrão de Versão de destino e de Versão mínima na caixa de diálogo Novo Projeto da Plataforma Universal do Windows.

    Captura de tela da caixa de diálogo Novo Projeto da Plataforma Universal do Windows mostrando a versão de destino padrão e as configurações de versão mínima.

    Nota

    Se esta for a primeira vez que você usa o Visual Studio para criar um aplicativo UWP, uma caixa de diálogo Configurações poderá aparecer. Selecione Modo do Desenvolvedor e, em seguida, escolha Sim.

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

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

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

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

    Captura de tela da caixa de diálogo “Criar um novo projeto” com “Janelas Universais” inseridas na caixa de pesquisa e o modelo de projeto “Aplicativo em Branco (Universal do Windows)” realçado.

  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.

  4. Aceite as configurações padrão de Versão de destino e de Versão mínima na caixa de diálogo Novo Projeto da Plataforma Universal do Windows.

    Captura de tela da caixa de diálogo Novo Projeto da Plataforma Universal do Windows mostrando a versão de destino padrão e as configurações de versão mínima.

    Nota

    Se esta for a primeira vez que você usou o Visual Studio para criar um aplicativo UWP, a caixa de diálogo Habilitar Modo de Desenvolvedor para Windows será exibida. Selecione as configurações para desenvolvedores para abrir Configurações. Ative o Modo Desenvolvedore depois escolha Sim.

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

    O Visual Studio instala um pacote adicional 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. Adicione um controle de botão, adicione uma ação ao botão e inicie o aplicativo "Olá, Mundo" para ver a aparência dele.

Adicionar um botão à tela de Design

  1. No Gerenciador de Soluções, clique duas vezes MainPage.xaml para abrir uma exibição dividida.

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

    Há dois painéis: o do Designer XAML, que inclui uma tela de design e o editor XAML , em que você pode adicionar ou alterar o código.

    Captura de tela mostrando MainPage.xaml aberto no IDE do Visual Studio e o painel designer XAML mostra uma superfície de design em branco e o painel Editor XAML mostra parte do código XAML.

  2. Escolha Caixa de ferramentas para abrir a janela de submenu Caixa de Ferramentas.

    Captura de tela mostrando a guia da janela suspensa 'Caixa de Ferramentas' realçada no lado esquerdo do Painel do Designer XAML.

    Se a opção Caixa de Ferramentas não for exibida, ela poderá ser aberta na barra de menus. Para fazer isso, escolha Exibição>Barra de Ferramentas. Ou pressione Ctrl+Alt+X.

  3. Selecione o ícone Fixar para encaixar a janela Caixa de Ferramentas.

    Captura de tela mostrando o ícone Fixar realçado na barra superior da janela Caixa de Ferramentas.

  4. Selecione o controle de Botão e, em seguida, arraste-o para a tela de design.

    Captura de tela mostrando 'Botão' realçado na janela Caixa de Ferramentas e um controle Botão na tela de design.

    Se você examinar o código no Editor XAML , verá que o Botão aparece lá também.

    Captura de tela mostrando o código do botão recém-adicionado realçado no editor XAML.

  1. No Gerenciador de Soluções, clique duas vezes em MainPage.xaml para abrir o modo divisão.

    Captura de tela da janela Gerenciador de Soluções mostrando as propriedades, referências, ativos e arquivos no projeto HelloWorld. O arquivo MainPage.xaml está selecionado.

    Há dois painéis: o do Designer XAML, que inclui uma tela de design e o editor XAML , em que você pode adicionar ou alterar o código.

    Captura de tela mostrando MainPage.xaml aberto no IDE do Visual Studio. O painel Designer XAML mostra uma superfície de design em branco e o painel editor XAML mostra parte do código XAML.

  2. Escolha Caixa de ferramentas para abrir a janela de submenu Caixa de Ferramentas.

    Captura de tela mostrando a guia da janela suspensa 'Caixa de Ferramentas' realçada no lado esquerdo do Painel do Designer XAML.

    Se a opção Caixa de Ferramentas não for exibida, ela poderá ser aberta na barra de menus. Para fazer isso, escolha Exibição>Barra de Ferramentas. Ou pressione Ctrl+Alt+X.

  3. Selecione o ícone Fixar para encaixar a janela Caixa de Ferramentas.

    Captura de tela mostrando o ícone Fixar realçado na barra superior da janela Caixa de Ferramentas.

  4. Selecione o controle de Botão e, em seguida, arraste-o para a tela de design.

    Captura de tela mostrando 'Botão' realçado na janela Caixa de Ferramentas e um controle Botão na tela de design.

    Se você examinar o código no editor XAML, verá que o Botão também aparece lá:

    Captura de tela mostrando o código do botão recém-adicionado realçado no editor XAML.

Adicionar um rótulo ao botão

  1. No Editor XAML, altere o valor Button Content de Botão para Olá, Mundo!

    Captura de tela mostrando o código XAML do botão no editor XAML, com a propriedade Content alterada para Hello World!

  2. Observe que o botão no Designer XAML muda muito.

    Captura de tela mostrando o controle Botão na tela do Designer XAML com o rótulo do botão alterado para Hello World!

  1. No Editor XAML, altere o valor Button Content de Botão para Olá, Mundo!

    Captura de tela mostrando o código XAML do Botão no editor XAML com o valor da propriedade Content alterado para 'Olá, Mundo!'.

  2. Observe que o botão no Designer XAML muda muito.

    Captura de tela mostrando o controle Botão na tela do Designer XAML com o rótulo do botão alterado para Hello World!

Adicionar um 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 ao botão Hello World!.

  1. Clique duas vezes no controle de botão na tela de design.

  2. Edite o código do manipulador de eventos em MainPage.xaml.cs, a página code-behind.

    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.

    Altere-o, para que se pareça com este:

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

    Este é o código para copiar e colar:

    private async void Button_Click(object sender, RoutedEventArgs e)
{
   MediaElement mediaElement = new MediaElement();
   var synth = new Windows.Media.SpeechSynthesis.SpeechSynthesizer();
   Windows.Media.SpeechSynthesis.SpeechSynthesisStream stream = await synth.SynthesizeTextToStreamAsync("Hello, World!");
   mediaElement.SetSource(stream, stream.ContentType);
   mediaElement.Play();
}

  1. Clique duas vezes no controle de botão na tela de design.

  2. Edite o código do manipulador de eventos em MainPage.xaml.cs, a página code-behind.

    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.

    Altere-o, para que se pareça com este:

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

    Este é o código para copiar e colar:

    private async void Button_Click(object sender, RoutedEventArgs e)
{
   MediaElement mediaElement = new MediaElement();
   var synth = new Windows.Media.SpeechSynthesis.SpeechSynthesizer();
   Windows.Media.SpeechSynthesis.SpeechSynthesisStream stream = await synth.SynthesizeTextToStreamAsync("Hello, World!");
   mediaElement.SetSource(stream, stream.ContentType);
   mediaElement.Play();
}

O que acabamos de fazer?

O código usa algumas APIs do Windows para criar um objeto de síntese de fala e, em seguida, fornece um texto a ser dito. Para obter mais informações sobre como usar SpeechSynthesis, consulte System.Speech.Synthesis.

Executar o aplicativo

É hora de criar, implantar e iniciar o aplicativo UWP "Olá, Mundo" para ver como ele se parece e soa. Veja como.

  1. Use o botão Reproduzir para iniciar o aplicativo no computador local. Ele tem o texto Computador Local.

    Captura de tela mostrando a caixa suspensa aberta ao lado do botão Reproduzir com 'Computador Local' 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 figura:

    Captura de tela mostrando o aplicativo

  3. Selecione o botão Hello World.

    Seu dispositivo Windows 10 ou posterior literalmente diz: "Olá, Mundo!"

  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.

É hora de criar, implantar e iniciar o aplicativo UWP "Olá, Mundo" para ver como ele se parece e soa. Veja como.

  1. Use o botão Play (ele tem o texto Computador Local) para iniciar o aplicativo no computador local.

    Captura de tela mostrando a caixa suspensa aberta ao lado do botão Reproduzir com 'Computador Local' 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 literalmente diz: "Olá, Mundo!"

  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.

Conteúdo relacionado

Próxima etapa

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

Criar uma interface do usuário