Comece com WinUI

Bem-vindo ao desenvolvimento de aplicativos com WinUI. Este guia orientará você nas etapas necessárias para começar. Ele também indicará recursos que o ajudarão a aprender mais sobre o desenvolvimento do Home windows.

1. Instale o Visible Studio

Você usará o Visible Studio, o ambiente de desenvolvimento integrado (IDE) abrangente da Microsoft, para criar seu aplicativo WinUI. É a ferramenta de desenvolvimento preferida de muitos desenvolvedores do Home windows e ajudará você a escrever, depurar e implantar seus aplicativos. Os modelos de projeto no Visible Studio irão ajudá-lo a começar rapidamente com projetos para Home windows e muitas outras plataformas.

Use este hyperlink para baixar e instalar o Visible Studio mais recente. O instalador orientará você pelas etapas, mas se precisar de instruções detalhadas, consulte Instalar o Visible Studio.

O Visible Studio Group Version gratuito inclui tudo que você precisa para criar seus aplicativos. Se estiver trabalhando com uma equipe de desenvolvimento ou empresa, talvez você exact do Visible Studio Skilled ou do Visible Studio Enterprise. Consulte O que é o Visible Studio? para mais informações.

Cargas de trabalho e componentes necessários

Ao instalar o Visible Studio, você precisa instalar as cargas de trabalho e os componentes necessários para desenvolver com o WinUI e o SDK do Aplicativo Home windows. Após a instalação, você pode abrir o aplicativo Visible Studio Installer e selecionar Modificar para adicionar cargas de trabalho e componentes.

No Cargas de trabalho do aplicativo Visible Studio Installer, selecione as seguintes cargas de trabalho e componentes:

2. Habilite o modo de desenvolvedor

O Home windows possui um modo especial para desenvolvedores que ajusta as configurações de segurança para permitir que você execute os aplicativos em que está trabalhando. Você precisará habilitar o Modo de Desenvolvedor antes de poder criar, implantar e testar seu aplicativo usando o Visible Studio.

Para ativar o modo de desenvolvedor:

• Abra as configurações do Home windows e navegue até o Sistema > Para desenvolvedores página.
• Alterne o botão Modo de desenvolvedor para Sobre e confirme sua escolha na caixa de diálogo de confirmação.

Para obter mais informações sobre o modo de desenvolvedor, consulte Habilitar seu dispositivo para desenvolvimento.

3. Crie e inicie seu primeiro aplicativo WinUI

Os modelos de projeto do Visible Studio incluem todos os arquivos necessários para criar seu aplicativo rapidamente. Na verdade, depois de criar seu projeto a partir de um modelo de aplicativo WinUI, você já terá um aplicativo que poderá executar e ao qual adicionar seu código.

Para criar um novo projeto usando o modelo de projeto WinUI C# Clean App:

1. Abra o Visible Studio e selecione Crie um novo projeto na página de lançamento. (Se o Visible Studio já estiver aberto no editor, selecione Arquivo > Novo > Projeto):
   
   
   

2. Procurar WinUI e selecione o Clean App, Packaged (WinUI 3 in Desktop) Modelo de projeto C# e clique em Próximo:
   
   
   

3. Especifique um nome de projeto e clique em Criar. Opcionalmente, você pode especificar um nome e diretório de solução ou deixar os padrões. Nesta imagem, o Howdy World projeto pertence a um Howdy World solução, que viverá em C:Tasks:
   
   
   

4. Clique no botão Debug “Iniciar” para compilar e executar seu projeto:
   
   
   
   
   Seu Howdy World O projeto será compilado, implantado em sua máquina native e executado em modo de depuração:
   
   
   

5. Para interromper a depuração, feche a janela do aplicativo ou clique no botão “Parar” de depuração no Visible Studio.

4. Atualize para o SDK do aplicativo WinUI/Home windows mais recente

O Home windows App SDK (e o WinUI, que faz parte dele) é distribuído como um pacote NuGet. Isso significa que as atualizações podem ser lançadas fora de sincronia com o Home windows e o Visible Studio. Como resultado, o modelo do Visible Studio usado para criar seu projeto pode não fazer referência ao pacote NuGet do SDK do aplicativo Home windows mais recente. Para garantir que você tenha os recursos e as correções mais recentes, atualize seus pacotes NuGet sempre que criar um novo projeto no Visible Studio.

Para atualizar o pacote NuGet do SDK do aplicativo Home windows para seu projeto:

• No Visible Studio, com seu projeto carregado, selecione Ferramentas > Gerenciador de pacotes NuGet > Gerenciar pacotes NuGet para solução….
• Se uma atualização estiver disponível, ela aparecerá na página Atualizações. Marque a caixa ao lado da atualização listada. (Para incluir atualizações de pré-lançamento, marque a opção “Incluir pré-lançamento”. Para saber mais sobre o que está incluído em uma atualização, consulte as notas de lançamento.)
• Clique no Atualizar botão e clique em Aplicar na caixa de diálogo Visualizar alterações e aceite os termos de licença para concluir a instalação da atualização.

Agora seu projeto está usando os recursos mais recentes do WinUI disponíveis e está pronto para você personalizá-lo.

Próximos passos