Compartilhar via

Criar seu primeiro aplicativo WinUI 3

Esta série de tutoriais demonstra como criar um aplicativo WinUI usando XAML e C#. O aplicativo que você criará é um aplicativo de anotação, em que o usuário pode criar, salvar e carregar várias anotações. Você pode baixar ou exibir o código deste tutorial no repositório GitHub.

Neste tutorial, você aprenderá como:

  • Use a marcação XAML para definir a interface do usuário do aplicativo.
  • Interaja com elementos XAML por meio do código C#.
  • Salve e carregue arquivos do sistema de arquivos local.
  • Crie exibições e associe-as aos dados.
  • Use a navegação para mover de e para páginas no aplicativo.
  • Use recursos como documentação e aplicativos de exemplo para criar seu próprio aplicativo.

Você usará Visual Studio 2022 para criar um aplicativo que pode ser usado para inserir uma anotação e salvá-la no aplicativo local storage. Você pode encontrar o código-fonte deste aplicativo aqui. O aplicativo terá duas páginas:

  • NotePage - uma página para editar uma única anotação.
  • AllNotesPage - uma página para mostrar todas as anotações salvas.

O aplicativo final é mostrado abaixo:

AllNotesPage

Captura de tela final do aplicativo de anotações, mostrando três anotações de salvamento.

NotePage

Captura de tela final do aplicativo de anotações, mostrando uma nova nota em branco.

Crie o projeto do Visual Studio

Para começar este tutorial, você deve criar um projeto de aplicativo WinUI em Visual Studio usando o modelo de projeto C# Blank App, Packaged (WinUI in Desktop). Ao criar o projeto, use as seguintes configurações:

  • Project Name

    Isso deve ser definido como WinUINotes. Se o project for nomeado algo diferente, o código que você copiar e colar deste tutorial poderá resultar em erros de build. Isso ocorre porque Visual Studio usa o nome do project como o namespace padrão para o código do aplicativo.

  • Windows App SDK

    Este tutorial usa recursos novos no Windows App SDK 1.7. Você deve verificar se o pacote NuGet Windows App SDK está atualizado para a versão 1.7 ou posterior.

Importante

Se você não criou um projeto WinUI antes, siga as etapas em Comece desenvolvendo aplicativos do Windows para garantir que seu ambiente de desenvolvimento e projeto do Visual Studio estejam configurados corretamente.

Ao executar seu projeto de aplicativo em branco (conforme descrito em Começar a desenvolver aplicativos para Windows), você deverá ver uma janela vazia semelhante a isto:

A janela do aplicativo de anotações com uma barra de título e uma área de conteúdo vazia.

Dica

Você se referirá frequentemente a documentos de referência de API e documentos conceituais durante a criação de aplicativos do Windows. Neste tutorial, você verá links embutidos no texto e em grupos rotulados como "Saiba mais nos documentos:". Esses links são opcionais; você não precisa segui-los para concluir o tutorial. Eles são fornecidos caso você queira anotar onde encontrar as informações necessárias quando começar a criar seus próprios aplicativos.

Continue para a etapa 1 – configuração do projeto

  • Last updated on