Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Bem-vindo ao desenvolvimento de aplicativos para o Windows. Este guia orientará você pelas etapas necessárias para começar a criar aplicativos usando as estruturas de desenvolvimento mais recentes do Windows: o SDK do Aplicativo Windows e da WinUI. Ele também apontará para recursos que ajudarão você a saber mais sobre o desenvolvimento do Windows. Se você já está à vontade em desenvolver aplicativos para o Windows, mas quer saber mais sobre as ferramentas mais recentes, consulte Desenvolver aplicativos da área de trabalho do Windows.
Dica
O Microsoft Copilot é um ótimo recurso se você tiver dúvidas sobre como começar a escrever aplicativos do Windows.
1. Habilitar o modo de desenvolvedor
O Windows tem um modo especial para desenvolvedores que ajusta as configurações de segurança para permitir que você execute os aplicativos em que você está trabalhando. 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 o habilitar agora, você será solicitado a habilitá-lo quando tentar criar seu aplicativo no Visual Studio.
Para habilitar o Modo de Desenvolvedor:
- Abra as Configurações do Windows e navegue até a página Sistema > Para desenvolvedores.
- Alterne a opção Modo de Desenvolvedor para Ativado e confirme sua escolha na caixa de diálogo de confirmação.
Para mais informações sobre como habilitar o Modo de Desenvolvedor, confira Habilitar seu dispositivo para desenvolvimento.
2. Instalar o Visual Studio
Você usará o Visual Studio, o ambiente de desenvolvimento integrado (IDE) abrangente da Microsoft para criar seu aplicativo WinUI. Ela é 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 ajudarão você a começar a usar projetos para Windows e muitas outras plataformas.
Dica
Antes de instalar essas ferramentas, verifique se o computador de desempenho atende aos requisitos mínimos do sistema para desenvolvimento de aplicativos no Windows.
Use o link abaixo para baixar e instalar o Visual Studio mais recente. O instalador orientará você pelas etapas, mas se você achar que precisa de instruções detalhadas, consulte Instalar 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 desenvolver com o WinUI e o SDK de Aplicativo do Windows. Após a instalação, você pode abrir o aplicativo Instalador do Visual Studio e selecionar Modificar para adicionar cargas de trabalho e componentes.
Na guia Cargas de Trabalho do aplicativo Instalador do Visual Studio, selecione as seguintes cargas de trabalho e componentes:
- Para o desenvolvimento de aplicativos em C# usando o SDK do Aplicativo do Windows, selecione o desenvolvimento de aplicativos WinUI.
- Para o desenvolvimento de aplicativos C++ usando o SDK do Aplicativo do Windows, selecione o desenvolvimento de aplicativos WinUI.
- Em seguida, no painel Detalhes da instalação, sob o nó desenvolvimento de aplicativos WinUI, selecione ferramentas de desenvolvimento para aplicativos WinUI em C++. (Isso também selecionará qualquer componente adicional necessário.)
Uma captura de tela da interface do usuário do instalador do Visual Studio com as ferramentas de desenvolvimento de aplicativo C++ WinUI selecionadas.
Observação
No Visual Studio 17.10 – 17.12, essa carga de trabalho é chamada de desenvolvimento de aplicativos do Windows.
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 ser executado e então adicionar seu código.
Para criar um novo projeto usando o modelo de projeto de Aplicativo em Branco WinUI C#:
Inicie o Visual Studio e selecione Criar um projeto a partir da página de inicialização. (Se o Visual Studio já estiver aberto para o editor, selecione Arquivo>Novo>Projeto):
Crie um novo projeto
Pesquise
WinUI
e selecione oBlank App, Packaged (WinUI 3 in Desktop)
modelo de projeto C# e clique em Avançar:Aplicativo WinUI 3 C# em branco, empacotado na área de trabalho
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 aplicados. Nesta imagem, o projeto
Hello World
pertence a uma soluçãoHello World
, que residirá emC:\Projects\
:Especificar detalhes do projeto
Observação
Se você quiser usar este projeto para criar o aplicativo completo na seção Próximas etapas, nomeie o projeto
WinUINotes
.Clique no botão Depurar "Iniciar" para compilar e executar seu projeto:
Compilar e executar seu projeto
Seu projeto será compilado, implantado em seu computador local e executado no modo de depuração:
Projeto Olá mundo criado e em execução
Para interromper a depuração, feche a janela do aplicativo ou clique no botão "Parar" Depuração no Visual Studio.
4. Excluir código de exemplo
A MainWindow
classe incluída no modelo de projeto inclui alguns códigos de exemplo que precisam ser removidos para abrir espaço para seu conteúdo.
Clique duas vezes no Gerenciador de Soluções para abri-lo
MainWindow.xaml
. Você deve ver a marcação XAML para um controleStackPanel
.Exclua o XAML para o
StackPanel
. (Você adicionará seu próprio conteúdo 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 gerará um erro nas linhas de
The name 'myButton' does not exist in the current context
. Isso ocorre porque você excluiu oButton
controle nomeadomyButton
, mas ele ainda é referenciado noMainPage.xaml.cs
arquivo code-behind. Exclua a referência no arquivo de código também.Clique duas vezes no Gerenciador de Soluções para abri-lo
MainWindow.xaml.cs
.Exclua o
myButton_Click
manipulador de 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. }
Salve o arquivo pressionando CTRL + SHIFT + S, clicando no ícone Salvar Tudo na barra de ferramentas ou selecionando o menu Salvar>Tudo.
5. Atualizar para o SDK do Aplicativo WinUI/Windows 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 do Aplicativo Windows. Para garantir que você tenha os recursos e correções mais recentes, recomendamos que você atualize seus pacotes NuGet sempre que criar um novo projeto no Visual Studio.
Para atualizar o pacote NuGet do SDK do Aplicativo Windows para seu projeto:
- No Visual Studio, com seu projeto carregado, selecione Tools>Gerenciador de pacote 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.
Uma captura de tela do gerenciador de pacotes NuGet no Visual Studio mostrando uma atualização de pacote do SDK do Aplicativo Windows.
Agora seu projeto está usando os recursos WinUI mais recentes que estão disponíveis e ele está pronto para você o personalizar como quiser.
Próximas etapas
- Para ter uma ideia do que a WinUI tem a oferecer, confira o aplicativo Galeria da WinUI.
O aplicativo Galeria da WinUI 3 inclui exemplos interativos da maioria dos controles, recursos e funcionalidades da WinUI 3. Obtenha o aplicativo na Microsoft Store ou o código-fonte no GitHub
- Saiba mais sobre os Conceitos básicos sobre a WinUI.
- Explore os princípios do Fluent Design.
- Encontre exemplos e ferramentas para ajudar você a desenvolver aplicativos com mais eficiência.
Windows developer