Criar seu primeiro aplicativo WinUI

Crie seu primeiro aplicativo WinUI e veja-o ganhar vida em Windows. Este início rápido leva você da configuração da ferramenta para um aplicativo em execução e, em seguida, orienta você pela sua primeira atualização de interface.

Antes de começar

O que você aprenderá

  • Escolha e configure suas ferramentas de desenvolvimento.
  • Crie e execute um aplicativo WinUI.
  • Atualize a interface e veja sua alteração no app em execução.

Escolha suas ferramentas de desenvolvimento

Siga um dos caminhos recomendados neste guia de início rápido:

  • CLI do winapp: Trabalhe em um terminal no editor de sua preferência. Esse fluxo de trabalho de linha de comando também funciona bem para programação com agentes.
  • Visual Studio: Use uma experiência integrada de desenvolvimento e depuração.

Se suas ferramentas já estiverem instaladas, acesse Criando seu primeiro aplicativo.

Instalação das ferramentas

  1. Habilitar o modo de desenvolvedor. Você pode abrir as configurações com Configurações do desenvolvedor.

  2. Instale o SDK do .NET 10 e a CLI de desenvolvimento do aplicativo do Windows. Se você usa o WinGet, execute:

    winget install --id Microsoft.DotNet.SDK.10 --exact --source winget
winget install --id Microsoft.WinAppCli --exact --source winget

    Pule a instalação se a ferramenta necessária já estiver instalada.

  3. Abra um novo terminal para que ele reconheça os comandos instalados e, em seguida, verifique as versões:

    dotnet --version
winapp --version

    Use o .NET SDK 10 ou posterior e o winapp CLI 0.6 ou posterior para esse fluxo de trabalho.

Note

A CLI do winapp está em prévia pública. winapp new gerencia os modelos de projeto do WinUI, mas não instala o SDK do .NET. Consulte o anúncio da CLI 0.6 para obter os comandos de novo projeto e execução.

Criando seu primeiro aplicativo

Use o fluxo de trabalho instalado acima para criar e iniciar o projeto.

Em uma pasta em que você mantém seus projetos, execute:

winapp new --name MyWinUIApp --template winui --use-defaults
cd MyWinUIApp
winapp run

winapp new cria o aplicativo WinUI em branco. winapp run compila o projeto e o executa; você não precisa de um comando de compilação ou registro de pacote separado.

Seu aplicativo abre uma janela do desktop. Continue com Faça uma alteração abaixo.

Fazer uma alteração

Mantenha o projeto que você acabou de criar. Adicione uma mensagem à sua interface existente:

  1. Feche o aplicativo em execução. Abra MainPage.xaml em seu editor. Se o modelo não contiver esse arquivo, abra MainWindow.xaml em vez disso.

  2. Localize o painel de layout que contém o conteúdo do aplicativo. No modelo vazio atual da CLI, MainPage.xaml contém um <Grid /> vazio. Substitua essa grade vazia por:

    <Grid>
    <TextBlock
        Text="Hello, WinUI!"
        HorizontalAlignment="Center"
        VerticalAlignment="Center" />
</Grid>

    Se o painel já contiver controles, adicione apenas o TextBlock dentro desse painel. Mantenha os controles, nomes e manipuladores de eventos existentes. Não substitua oPage ou Window ao redor, nem a moldura e a barra de título em MainWindow.xaml.

  3. Salve o arquivo. Execute winapp run novamente na pasta do projeto ou pressione F5 em Visual Studio.

Parabéns! Você criou, executou e atualizou seu primeiro aplicativo WinUI. A janela agora exibe Hello, WinUI!

Solução de problemas

Problema O que verificar
winapp ou dotnet não é reconhecido. Reabra o terminal após a instalação. Use os comandos de versão na guia CLI para confirmar se ambas as ferramentas estão disponíveis.
winapp new não é reconhecido. Esse fluxo de trabalho requer a CLI do winapp 0.6 ou posterior. Atualize a CLI usando o método de instalação escolhido.
Os modelos WinUI não aparecem no Visual Studio. Abra o Instalador do Visual Studio, selecione Modificar e confirme se a carga de trabalho Desenvolvimento de aplicativos WinUI está instalada. Reinicie o Visual Studio depois.
A compilação relata um erro de SDK ou de restauração. Verifique os pré-requisitos do fluxo de trabalho selecionado e o primeiro erro na saída da compilação. Use Suporte ao SDK de Aplicativos do Windows para verificar os requisitos de versão antes de alterar as propriedades do projeto.
Os relatórios de implantação informam que o Modo de Desenvolvedor está desabilitado. Habilite Modo de Desenvolvedor e então execute o aplicativo novamente.
Sua nova mensagem não aparece. Salve o arquivo XAML e reinicie o projeto. Em modelos com um MainPage.xaml, adicione a mensagem nessa página em vez de substituir o frame hospedeiro da janela.

Próximas etapas

Criar um aplicativo de notas

O tutorial de Anotações usa um projeto WinUINotes separado para ensinar páginas, navegação, vinculação de dados e armazenamento local. Você também pode encontrar exemplos focados de controles em exemplos de código e na Galeria do WinUI.

  • Última atualização em