Usar o SDK do Aplicativo do Windows em um projeto existente

  • Artigo

Se você tiver um projeto da área de trabalho no qual deseja usar o SDK do Aplicativo Windows, poderá instalar o pacote NuGet SDK do Aplicativo Windows em seu projeto (a versão mais recente ou qualquer versão necessária). 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 do Aplicativo Windows. Mas os aplicativos empacotados também podem fazer isso.

Importante

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

Observação

Esse procedimento tem suporte em projetos C# .NET 6 (e posteriores) e projetos da área de trabalho C++. Esses tipos de projeto podem usar pacotes NuGet do canal de versão estável, do canal de versão prévia ou do canal de versão experimental.

Pré-requisitos

  • Visual Studio 2019 ou posterior.
  • As cargas de trabalho e os componentes para o desenvolvimento de aplicativos do Windows. Para obter mais informações, consulte Instalar ferramentas para o SDK do Aplicativo Windows.

Instruções

  1. Abra um projeto existente no Visual Studio.

    Observação

    Se você tiver um projeto da á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 obter mais informações, consulte Chamar APIs do Tempo de Execução do Windows em aplicativos da área de trabalho. Além disso, você deve ter como alvo 18362 ou posterior, pois há um problema conhecido de bloqueio de aplicativos direcionados a 17763 (consulte Erros de build ao usar o TFM de 17763 no GitHub).

  2. Verifique se as referências de pacote estão habilitadas:

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

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

  4. Na janela Gerenciador de Pacotes NuGet, marque a caixa de seleção Incluir pré-lançamento perto da parte superior da janela, selecione a guia Procurar e pesquise um dos seguintes pacotes:

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

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

    Captura de tela do pacote NuGet SDK do Aplicativo Windows que está sendo instalado

    Observação

    O pacote NuGet SDK do Aplicativo Windows contém outros subpacotes (incluindo Microsoft.WindowsAppSDK.Foundation, Microsoft.WindowsAppSDK.WinUI e outros) que contêm as implementações para componentes específicos no SDK do Aplicativo 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 SDK do Aplicativo Windows principal, que inclui todos os componentes.

  6. Somente para aplicativos não empacotados. Antes que seu aplicativo não empacotado possa usar SDK do Aplicativo Windows APIs e componentes, seu aplicativo deve primeiro carregar o runtime SDK do Aplicativo Windows para fazer referência ao pacote de estrutura SDK do Aplicativo Windows. Para obter mais informações, consulte Usar o runtime SDK do Aplicativo Windows para aplicativos empacotados com local externo ou não empacotados e Tutorial: Usar a API bootstrapper em um aplicativo empacotado com local externo ou não empacotado que usa o SDK do Aplicativo Windows.

  7. Seu aplicativo agora pode usar SDK do Aplicativo Windows APIs e componentes que estão disponíveis no canal de lançamento que você instalou. Para obter a lista de recursos disponíveis, consulte canais de lançamento.

Mais informações

Se o projeto existente for um projeto C++ e você quiser chamar APIs do Tempo de Execução do Windows no SDK do Aplicativo 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 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 do Aplicativo Windows.

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

Confira também