Partilhar via

Crie a sua primeira aplicação WinUI 3

Esta série de tutoriais demonstra como criar uma aplicação WinUI usando XAML e C#. O aplicativo que você criará é um aplicativo de notas, onde o usuário pode criar, salvar e carregar várias notas. Pode descarregar ou ver o código deste tutorial no repositório GitHub.

Neste tutorial, aprenderás como:

  • Use a marcação XAML para definir a interface do usuário do aplicativo.
  • Interaja com elementos XAML por meio de código C#.
  • Salve e carregue arquivos do sistema de arquivos local.
  • Crie vistas 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.

Vais usar o Visual Studio 2022 para criar uma aplicação que podes usar para inserir uma nota e guardá-la no storage local da app. Você pode encontrar o código-fonte para este aplicativo aqui. O aplicativo terá duas páginas:

  • NotePage - uma página para editar uma única nota.
  • AllNotesPage - uma página para mostrar todas as notas salvas.

A candidatura final é apresentada abaixo:

AllNotesPage

Captura de ecrã final da aplicação de notas, mostrando três notas guardadas.

Página de Observação

Captura de ecrã final da aplicação Notas, mostrando uma nova nota em branco.

Crie o projeto do Visual Studio

Para começar este tutorial, tens de criar uma aplicação WinUI project em Visual Studio usando o modelo project Blank App, Packaged (WinUI in Desktop) C#. Ao criar o project, utilize as seguintes definições:

  • Project Nome

    Isso deve ser definido como WinUINotes. Se o project tiver um nome diferente, o código que copiar e colar deste tutorial pode resultar em erros de compilação. Isto deve-se ao facto de o Visual Studio usar o nome do projeto como o namespace predefinido para o código da sua aplicação.

  • Windows App SDK

    Este tutorial utiliza funcionalidades que são novas no Windows App SDK 1.7. Deve certificar-se de que o pacote NuGet do Windows App SDK está atualizado para a versão 1.7 ou posterior.

Importante

Se nunca criou um project WinUI antes, siga os passos em Comece a desenvolver aplicações Windows para garantir que o seu ambiente de desenvolvimento e Visual Studio project estão configurados corretamente.

Quando executa o seu projeto de aplicação em branco (conforme descrito em Começar a desenvolver aplicações Windows), deverá ver uma janela vazia que se assemelha a isto:

A janela da aplicação de notas com uma barra de título e uma área de conteúdo vazia.

Sugestão

Você frequentemente consultará documentos de referência de API e documentos conceituais ao criar aplicativos do Windows. Neste tutorial, você verá links embutidos no texto e em grupos rotulados como "Saiba mais nos documentos:". Estes 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