Comece a desenvolver aplicativos do Windows

Bem-vindo ao desenvolvimento de aplicativos do Windows. Este guia irá guiá-lo pelas etapas necessárias para começar a criar aplicativos usando as estruturas de desenvolvimento mais recentes do Windows: o SDK de Aplicativos Windows e o WinUI. Ele também irá apontá-lo para recursos que irão ajudá-lo a aprender mais sobre o desenvolvimento do Windows. Se já se sente à vontade para desenvolver aplicações para Windows, mas quer saber mais sobre as ferramentas mais recentes, consulte Desenvolver aplicações de ambiente de trabalho do Windows.

Dica

Microsoft Copilot é um ótimo recurso se você tiver dúvidas sobre como começar a escrever aplicativos do Windows.

1. Ativar o Modo de Desenvolvedor

O Windows tem um modo especial para programadores que ajusta as definições de segurança para lhe permitir executar as aplicações em que está a trabalhar. Você precisará habilitar o Modo de Desenvolvedor antes de poder criar, implantar e testar seu aplicativo usando o Visual Studio.

Dica

Se você não habilitá-lo agora, você será solicitado a habilitá-lo quando tentar criar seu aplicativo no Visual Studio.

Para ativar o Modo de Desenvolvedor:

• Abra as Configurações do Windows e navegue até a página Sistema Para desenvolvedores.
• Alterne o interruptor do Modo de desenvolvedor para ligado e confirme a sua escolha no diálogo de confirmação.

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

2. Instale o Visual Studio

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

Dica

Antes de instalar essas ferramentas, verifique se o computador de desenvolvimento atende aos requisitos de sistema para o Windows app development.

Use o link abaixo para baixar e instalar o Visual Studio mais recente. O instalador irá guiá-lo pelas etapas, mas se você achar que precisa de instruções detalhadas, consulte Instalar o Visual Studio.

Baixar o Visual Studio

O Visual Studio Community Edition gratuito inclui tudo o que você precisa para criar seus aplicativos. Se você estiver trabalhando com uma equipe de desenvolvimento ou empresa, talvez precise do Visual Studio Professional ou do Visual Studio Enterprise. Consulte O que é o Visual Studio? para mais informações.

2.2 Cargas de trabalho e componentes necessários

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

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

Visual Studio 2022 versão 17.10 e posterior

• Para desenvolvimento de aplicativos em C# usando o SDK de aplicativos do Windows, selecione Desenvolvimento de aplicativos WinUI.

• Para desenvolvimento de aplicativos C++ usando o SDK de aplicativos do Windows, selecione Desenvolvimento de aplicativos WinUI.
  • Em seguida, no painel Detalhes da instalação , no nó de desenvolvimento de aplicativos WinUI , selecione Ferramentas de desenvolvimento de aplicativos WinUI C++. (Isso também selecionará quaisquer componentes adicionais necessários.)

Observação

No Visual Studio 17.10 - 17.12, essa carga de trabalho é chamada de desenvolvimento de aplicativos do Windows.

Visual Studio 2022 versão 17.1 - 17.9

• Para desenvolvimento de aplicativos em C# usando o SDK de Aplicativo do Windows, selecione .NET Desktop Development.
  • Em seguida, no painel Detalhes da instalação da caixa de diálogo de instalação, selecione Modelos de C# do SDK de Aplicativos do Windows (perto do fundo da lista).
• Para desenvolvimento de aplicações C++ usando o SDK de Aplicações Windows, selecione Desenvolvimento de aplicações para desktop com C++
  • Em seguida, no painel Detalhes da instalação da caixa de diálogo de instalação , selecione Modelos C++ do SDK de Aplicativo Windows (na parte inferior da lista).
  • Na caixa de diálogo de instalação, na guia componentes individuais, na seção SDKs, bibliotecas e frameworks, certifique-se de que o SDK do Windows mais recente está selecionado. Será parecido com SDK do Windows 11 (10.0.22621.0). Digite "Windows SDK" na caixa de pesquisa para facilitar a localização.

3. Crie e inicie seu primeiro aplicativo WinUI

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

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

1. Abra o Visual Studio e selecione Criar um novo projeto na página de inicialização. (Se o Visual Studio já estiver aberto para o editor, selecione Arquivo>Novo Projeto>):

2. Procure por WinUI e selecione o modelo de projeto C# WinUI Blank App (Packaged), depois clique em Avançar:

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

   Observação

   Se você quiser usar este projeto para criar o aplicativo completo na seção Próximas etapas, nomeie o projeto WinUINotes.

4. Clique no botão "Iniciar" de Depuração para criar e executar o seu projeto:
   
   Seu projeto será compilado, implantado em sua máquina local e executado no modo de depuração:
   

5. Para parar a depuração, feche a janela do aplicativo ou clique no botão "Parar" de depuração no Visual Studio.

4. Excluir código de exemplo

A MainWindow classe incluída com o modelo de projeto inclui algum código de exemplo que precisa ser removido para abrir espaço para seu conteúdo.

1. Clique duas vezes em MainWindow.xaml no Explorador de Soluções para abri-lo. Você deve ver a marcação XAML para o controlo StackPanel.

2. Exclua o XAML do StackPanel. (Você adicionará seu próprio conteúdo em seu lugar ao criar seu aplicativo.)

   <!-- ↓ Delete this. ↓ -->
   <StackPanel Orientation="Horizontal" HorizontalAlignment="Center" VerticalAlignment="Center">
       <Button x:Name="myButton" Click="myButton_Click">Click Me</Button>
   </StackPanel>
   

   Se você tentar executar seu aplicativo agora, o Visual Studio lançará um erro nos moldes de The name 'myButton' does not exist in the current context. Isso ocorre porque você excluiu o Button controle chamado myButton, mas ele ainda é referenciado no arquivo MainPage.xaml.cs code-behind. Exclua a referência no arquivo de código também.

3. Clique duas vezes em MainWindow.xaml.cs no Explorador de Soluções para abri-lo.

4. Exclua o manipulador de myButton_Click eventos.

   public sealed partial class MainWindow : Window
   {
       public MainWindow()
       {
           this.InitializeComponent();
       }
   
       // ↓ Delete this. ↓
       private void myButton_Click(object sender, RoutedEventArgs e)
       {
           myButton.Content = "Clicked";
       }
       // End delete.
   }
   

5. Salve o arquivo pressionando CTRL + SHIFT + S, clicando no ícone Salvar tudo na barra de ferramentas ou selecionando o menu Arquivo>salvar tudo.

5. Atualize para o WinUI/Windows App SDK mais recente

O SDK do Aplicativo Windows (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 Windows e o Visual Studio. Como resultado, o modelo do Visual Studio usado para criar seu projeto pode não fazer referência ao pacote NuGet mais recente do SDK de Aplicativo Windows. Para garantir que você tenha os recursos e correções mais recentes, atualize seus pacotes NuGet sempre que criar um novo projeto no Visual Studio.

Para atualizar o pacote NuGet do SDK de Aplicativo Windows para seu projeto:

• No Visual 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 versão.)
• Clique no botão Atualizar e, em seguida, 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 que estão disponíveis e está pronto para você torná-lo seu.

Próximos passos

Conclua um tutorial para criar um aplicativo de anotações com o WinUI

• Para ter uma ideia do que a WinUI tem a oferecer, confira o aplicativo WinUI Gallery.

  O aplicativo WinUI 3 Gallery inclui exemplos interativos da maioria dos controles, recursos e funcionalidades do WinUI 3. Obtenha o aplicativo no da Microsoft Store ou obtenha o código-fonte em do GitHub

• Saiba mais sobre fundamentos do WinUI.
• Explore Design Fluente princípios.
• Encontre exemplos e ferramentas para ajudá-lo a desenvolver aplicativos com mais eficiência.