WinUI

Prepare-se para desenvolver com o WinUI 3

Página atualizada :
Data de criação de página :

Ambiente operacional

Windows
  • janelas 11
Visual Studio
  • Visual Studio 2022 versão 17.9.3
.REDE
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
SDK do Aplicativo Windows
  • 1.4.230913002

Pré-requisitos

Em alguns casos, versões inferiores também podem funcionar.

Windows
  • janelas 10
  • janelas 11
Visual Studio
  • Visual Studio 2022 versão 17.9.3 ou posterior
.REDE
  • .NET 6
  • (.NET 8)
SDK do Aplicativo Windows
  • 1.4.230913002 ou posterior

Instalar o Visual Studio e configurar o WinUI

Os projetos de desenvolvimento do WinUI 3 podem ser adicionados com a instalação do Visual Studio. Esta seção fornece uma descrição simplificada do processo de instalação do Visual Studio. Para obter instruções detalhadas, consulte as dicas a seguir.

Inicie o instalador do Visual Studio 2022 da Internet ou da mídia. Ele suporta edições Community, Professional ou superiores.

Na seleção de carga de trabalho, selecione . NET Desenvolvimento de Área de Trabalho.

「. NET Desktop Development e verifique os modelos C# SDK do Aplicativo Windows nos Detalhes da instalação à direita.

Agora é só iniciar a instalação. Existem outras telas, mas não vou explicá-las até que criem um projeto.

Quando a instalação estiver concluída, crie um novo projeto.

Há um no item de pesquisa no winui canto superior direito, portanto, ao selecioná-lo, o modelo de projeto do WinUI 3 será exibido, portanto, selecione qualquer modelo e crie um projeto.

Agora você pode desenvolver aplicativos usando o WinUI 3.

Se você vir "Direcionando uma versão do .NET que não está instalada"

A partir da versão 17.9.1 2022 do Visual Studio, o .NET para WinUI 3 tem como destino o .NET 6. Se você não selecionar nenhum runtime adicional no Visual Studio 2022, somente o runtime do .NET 8 será instalado e você poderá ver um aviso como o abaixo.

Se você estiver preocupado, poderá instalar o runtime do .NET 6 ou simplesmente ignorar o aviso. Você não precisa instalar o runtime do .NET 6 para depurar.

Se você quiser adicionar um ambiente de desenvolvimento WinUI 3 posteriormente

Se você instalar o Visual Studio primeiro, poderá adicionar um ambiente de desenvolvimento WinUI 3 posteriormente.

Inicie o Visual Studio e selecione Ferramentas > Obter Ferramentas e Recursos no menu.

A mesma tela de quando você instalou o Visual Studio será exibida, para que você possa usar o . Verifique se "Desenvolvimento da Área de Trabalho do .NET" está marcado e marque "Modelo C# SDK do Aplicativo Windows" em "Detalhes da Instalação" à direita.

Ativar o modo de desenvolvedor

Os aplicativos WinUI são executados em um ambiente de segurança aprimorada, ao contrário de outros aplicativos da área de trabalho. Portanto, ele não pode ser executado como está. Ao tentar executá-lo, você verá uma caixa de diálogo como a abaixo e será solicitado a ativar o "Modo de desenvolvedor". Se você clicar no link, a tela de configuração será exibida, portanto, ative o "Modo de desenvolvedor".

Mesmo se você não estiver usando o Visual Studio, também poderá habilitar ou desabilitar o "Modo de Desenvolvedor" na tela de configurações. Selecione "Configurações" no menu Iniciar.

No menu Sistema, selecione Para desenvolvedores.

Há uma alternância para "Para desenvolvedores", então defina-a como "Ligado". Uma nota será exibida, então selecione "Sim" para ativá-la.

Se você quiser mudar para o .NET 8

Se você criar um projeto com esse modelo, ele será padronizado para o .NET 6. Mesmo se eu alterar a estrutura de destino para o .NET 8 das propriedades do projeto, a compilação ainda mostrará erros e avisos. No entanto, por volta de 13/03/2024, o SDK do Aplicativo Windows será atualizado para dar suporte oficial ao .NET 8.

No entanto, o modelo ainda está no .NET 6, portanto, você precisará trabalhar no .NET 8 depois de criar o projeto. Pode haver a possibilidade de que ele seja suportado em atualizações de versão futuras.

Primeiro, crie um projeto e, em seguida, use o NuGet para atualizar as versões relacionadas ao SDK do Aplicativo Windows.

Salvo disposição em contrário, tudo está atualizado. Microsoft.WindowsAppSDK deve ser pelo menos 1.5.XXXX.

Altere a estrutura de destino para .NET 8 nas propriedades do projeto.

Mesmo se você construir nesse estado, um erro será exibido porque as configurações do projeto estão desatualizadas.

Abra o arquivo de projeto como código.

RuntimeIdentifiersComo existe um parâmetro, remova o caractere da 10 seguinte forma Win10 .

Antes da modificação

<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>

↓

Após a correção

<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>

Ele também reescreve as configurações de publicação do programa. Abra cada .pubxml arquivo na pasta Propriedades > PublishProfiles.

RuntimeIdentifier Da mesma forma, remova o caractere de 10 no Win10 parâmetro de .

Depois disso, recompile e verifique se não há erros ou avisos. .pubxml (Haverá um aviso no arquivo, mas você não precisa se preocupar com isso porque é uma sintaxe diferente deste problema.) )

No entanto, por algum motivo, a biblioteca de classes WinUI continua a avisar mesmo que você faça a mesma coisa acima. Por enquanto, você pode executá-lo, então vamos esperar até que isso seja corrigido.