Usar o SDK do Aplicativo do Windows em um projeto existente

Se você tiver um projeto de área de trabalho WPF, WinForms ou Win32 no qual deseja usar recursos do SDK do Aplicativo Windows, instale o pacote nuGet SDK do Aplicativo Windows em seu projeto.

Pré-requisitos

Antes de instalar e usar o pacote NuGet SDK do Aplicativo Windows em seu aplicativo, certifique-se de que esses requisitos sejam atendidos:

Instruções

  1. Abra um projeto WPF, WinForms ou Win32 existente no Visual Studio. Verifique se ele está configurado para Chamar APIs Windows Runtime.

  2. Em Visual Studio, abra o NuGet Gerenciador de Pacotes:

    1. Clique em Tools > NuGet Gerenciador de Pacotes > Gerenciar Pacotes NuGet para solução... .
      –OU–
    2. Clique com o botão direito do mouse no projeto em Gerenciador de Soluções e escolha Gerenciar Pacotes NuGet para a solução....

  3. Na janela NuGet Gerenciador de Pacotes selecione a guia Browse e pesquise o seguinte pacote:

    • Microsoft. WindowsAppSDK.

  4. Depois de encontrar o pacote NuGet SDK do Aplicativo Windows apropriado, marque o pacote, marque a caixa no painel direito da janela NuGet Gerenciador de Pacotes ao lado do projeto em que deseja instalar o pacote e clique em Instalar.

    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. Em geral, recomendamos que você instale o pacote NuGet principal do SDK do Aplicativo Windows, que inclui todos os componentes. Em alguns casos, você pode instalar um subpacote individualmente para fazer referência apenas a determinados componentes em seu projeto. Por exemplo, consulte Instalar e implantar Windows ML.

Etapas adicionais para aplicativos não empacotados

Se o aplicativo estiver descompactado (quais aplicativos da área de trabalho são por padrão), há algumas etapas adicionais necessárias para usar o SDK do Aplicativo Windows.

Para obter mais informações sobre os termos empacotados e desempacotados, consulte a visão geral do empacotamento.

1. Instalar o runtime do SDK do Aplicativo Windows

O SDK do Aplicativo Windows Runtime precisa ser instalado em qualquer computador em que o aplicativo será executado.

Para o seu computador de desenvolvimento, recomendamos que você visite Últimos downloads do SDK do Aplicativo Windows e, em seguida, baixe, descompacte e execute um deles:

  • A versão estável mais recente nos downloads do Runtime.
  • Um canal de versão e lançamento do runtime que corresponda à versão e ao canal de lançamento do pacote NuGet Microsoft.WindowsAppSDK que você instalou.

Escolha a opção do Instalador apropriada para a arquitetura do computador.

Importante

Quando seu aplicativo for implantado, você será responsável por implantar pacotes de runtime SDK do Aplicativo Windows necessários aos usuários finais. Para obter mais informações, consulte o guia de implantação do SDK do Aplicativo Windows para aplicativos que dependem de estrutura, empacotados com localização externa ou não empacotados.

2. Inicializar o runtime do SDK do Aplicativo Windows

Por padrão, um aplicativo de área de trabalho WPF, WinForms ou Win32 é descompactado. Um aplicativo não empacotado deve inicializar o runtime do SDK do Aplicativo Windows antes de usar qualquer outro recurso do SDK do Aplicativo Windows.

Você pode fazer isso automaticamente quando seu aplicativo é iniciado por meio da inicialização automática.

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e escolha Editar Arquivo de Projeto.

  2. Dentro do elemento PropertyGroup, adicione um elemento WindowsPackageType configurado para None.

<WindowsPackageType>None</WindowsPackageType>

Quando você cria seu projeto, esses arquivos são adicionados ao seu projeto no Visual Studio:

  • MddBootstrapAutoInitializer.cs
  • WindowsAppSDK-VersionInfo.cs

  1. Edite manualmente o arquivo .cxproj.

  2. Dentro do elemento <PropertyGroup Label="Globals">, adicione um elemento WindowsPackageType definido como None.

<WindowsPackageType>None</WindowsPackageType>

Observação

Se você tiver necessidades avançadas (como tratamento de erros personalizados ou carregar uma versão específica do SDK do Aplicativo Windows), em vez de auto-initialization você pode chamar a API bootstrapper explicitamente para obter mais informações, consulte Use o SDK do Aplicativo Windows runtime para aplicativos empacotados com local externo ou não empacotados e Tutorial: use a API bootstrapper em um aplicativo empacotado com local externo ou desempacotado que usa o SDK do Aplicativo Windows.

Mais informações

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

Confira também

  • Last updated on