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

NotePage

Criar o projeto 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 em C#. Ao criar o projeto, use as seguintes configurações:

• Nome do Projeto

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

• Kit de Desenvolvimento de Aplicativos do Windows

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

Importante

Se você não tiver criado um projeto WinUI 3 antes, siga as etapas em Iniciar o desenvolvimento de aplicativos do Windows para garantir que o ambiente de desenvolvimento e o projeto do Visual Studio estejam configurados corretamente.

Ao executar seu projeto de aplicativo em branco (conforme descrito em Iniciar o desenvolvimento de aplicativos do Windows), você deverá ver uma janela vazia com esta aparência:

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.

Continuar na etapa 1 – Configuração do projeto