Partilhar via

Usar o SDK do Aplicativo Windows em um projeto existente

Se você tiver um projeto de área de trabalho no qual deseja usar o SDK de Aplicativo Windows, poderá instalar o pacote NuGet do SDK de Aplicativo Windows em seu projeto (a versão mais recente ou qualquer versão necessária). Os aplicativos não empacotados (ou seja, aplicativos que não usam MSIX para sua tecnologia de implantação) devem seguir este procedimento se quiserem usar o SDK de Aplicativos Windows. Mas as aplicações empacotadas também podem fazê-lo.

Importante

Se você estiver trabalhando em um aplicativo UWP, consulte Migrar da UWP para o SDK do Aplicativo Windows.

Observação

Este procedimento é suportado em projetos C# .NET 6 (e posteriores) e projetos de área de trabalho C++. Esses tipos de projeto podem usar pacotes NuGet a partir do canal de lançamento estável, do canal de lançamento de pré-visualização ou do canal de lançamento experimental.

Pré-requisitos

Instruções

  1. Abra um projeto existente no Visual Studio.

    Observação

    Se você tiver um projeto de área de trabalho C#, verifique se o elemento TargetFramework no arquivo de projeto está definido como um moniker específico do Windows 10 (como net6.0-windows10.0.19041.0) para que você possa chamar APIs do Tempo de Execução do Windows. Para mais informações, consulte Chamar APIs do Windows Runtime em aplicações da área de trabalho.

  2. Certifique-se de que as referências de pacote estão ativadas.

    1. No Visual Studio, clique em Ferramentas >Gerenciador de Pacotes NuGet>Configurações do Gerenciador de Pacotes.
    2. Verifique se PackageReference está selecionado para o formato padrão de gestão de pacotes .

  3. Clique com o botão direito do mouse em seu projeto no Gerenciador de Soluções e escolha Gerenciar Pacotes NuGet.

  4. Na janela Gestor de Pacotes NuGet, marque a caixa de seleção Incluir pré-lançamento na parte superior da janela, selecione o separador Explorar e procure um dos seguintes pacotes:

    • Para instalar uma das versões 1.0 ou posteriores, procure o pacote de Microsoft.WindowsAppSDK.
    • Para instalar uma das versões 0.8, procure o pacote Microsoft.ProjectReunion.

  5. Depois de encontrar o pacote NuGet apropriado do Windows App SDK, selecione o pacote e clique em Instalar no painel direito da janela do Gerenciador de Pacotes NuGet.

    Captura de ecrã do pacote NuGet do SDK de Aplicações Windows que está a ser instalado

    Observação

    O pacote NuGet do SDK de Aplicativos Windows contém outros subpacotes (incluindo Microsoft.WindowsAppSDK.Foundation, Microsoft.WindowsAppSDK.WinUIe outros) que contêm as implementações para componentes específicos no SDK de Aplicativos Windows. Você não pode instalar esses subpacotes individualmente para fazer referência apenas a determinados componentes em seu projeto. Você deve instalar o pacote NuGet principal do SDK de Aplicativo Windows, que inclui todos os componentes.

  6. Apenas para aplicações não empacotadas. Antes que a sua aplicação desempacotada possa usar as APIs e componentes do Windows App SDK, a sua aplicação deve primeiro carregar o runtime do Windows App SDK para fazer referência ao pacote de estrutura do Windows App SDK. Para obter mais informações, consulte Use o runtime do Windows App SDK para aplicativos empacotados com localização externa ou não empacotados e Tutorial: Use a API de bootstrapper em um aplicativo empacotado com localização externa ou não empacotado que usa o Windows App SDK.

  7. Agora, seu aplicativo pode usar APIs e componentes do SDK de Aplicativos Windows disponíveis no canal de lançamento que você instalou. Para ver a lista de recursos disponíveis, consulte os canais de lançamento da versão .

Mais informações

Se o seu projeto existente for um projeto C++ e você quiser chamar APIs do Tempo de Execução do Windows no SDK de Aplicativos Windows, precisará adicionar suporte para C++/WinRT. Consulte suporte do Visual Studio para C++/WinRT, XAML, a extensão VSIX e o pacote NuGet. Procure informações sobre o pacote de NuGet Microsoft.Windows.CppWinRT. Sem esse pacote, seu projeto não poderá encontrar os arquivos de cabeçalho de namespace para APIs do Tempo de Execução do Windows no SDK de Aplicativos Windows.

Se você encontrar um erro de Classe não registrada ao tentar usar um componente do Windows App SDK, talvez seja necessário adicionar ao seu projeto uma dependência dinâmica no Windows App SDK Framework. Para obter mais informações, consulte pacotes de estrutura MSIX e dependências dinâmicas.

Ver também

  • Last updated on