Partilhar via


Criar um aplicativo WinUI

Esta série de tutoriais demonstra como criar um aplicativo WinUI 3 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. Você pode baixar ou visualizar o código para este 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.

Você usará o Visual Studio 2022 para criar um aplicativo que pode ser usado para inserir uma anotação e salvá-la no armazenamento local do aplicativo. 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.

Criar o projecto do Visual Studio

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

  • Nome do Projeto

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

  • SDK de aplicativos do Windows

    Este tutorial usa recursos que são novos no Windows App SDK 1.7. Você deve certificar-se de que o pacote NuGet do SDK de Aplicativo Windows está atualizado para a versão 1.7 ou posterior.

Importante

Se você não criou um projeto WinUI 3 antes, siga as etapas em Começar a desenvolver 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 do Windows), você verá uma janela vazia com esta aparência:

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.