Usar o SDK do Aplicativo Windows em um projeto existente

Se tiver um projeto de ambiente de trabalho WPF, WinForms ou Win32 em que queira usar funcionalidades do SDK de Aplicações Windows, então pode instalar o pacote NuGet do SDK de Aplicações Windows no seu projeto.

Pré-requisitos

Antes de instalar e usar o pacote NuGet do SDK de Aplicações Windows na sua aplicação, certifique-se de que estes requisitos são cumpridos:

Instruções

  1. Abra um projeto WPF, WinForms ou Win32 existente no Visual Studio. Certifique-se de que está configurado para Call Windows Runtime APIs.

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

    1. Clique Ferramentas NuGet Gestor de Pacotes Gerir Pacotes NuGet para Solução...
      – OU –
    2. Clique com o botão direito do seu projeto em Explorador de Soluções e escolha Gerir Pacotes NuGet para Solução... .

  3. Na janela NuGet Gestor de Pacotes selecione o separador Browse e procure o seguinte pacote:

    • Microsoft. WindowsAppSDK.

  4. Depois de encontrares o pacote SDK de Aplicações Windows NuGet apropriado, seleciona o pacote, marca a caixa no painel direito da janela NuGet Gestor de Pacotes ao lado do projeto onde queres instalar o pacote, depois clica em Instalar.

    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. De um modo geral, recomendamos que instale o pacote principal NuGet do SDK de Aplicações Windows, que inclui todos os componentes. Em alguns casos, pode instalar um sub-pacote individualmente para referenciar apenas certos componentes do seu projeto. Por exemplo, veja Install and deploy Windows ML.

Passos adicionais para aplicações não embaladas

Se a sua aplicação não estiver empacotada (como é o caso das aplicações de ambiente de trabalho por defeito), então são necessários alguns passos adicionais para usar o SDK de Aplicações Windows.

Para mais informações sobre os termos empacotados e não embalados, consulte Resumo da Embalagem.

1. Instalar o runtime do SDK de Aplicações Windows

O SDK de Aplicações Windows Runtime precisa de ser instalado em qualquer máquina onde a aplicação vá correr.

Para a sua máquina de desenvolvimento, recomendamos que visite Downloads mais recentes do SDK de Aplicações Windows, depois descarregue, descompacte e execute uma das opções:

  • A versão estável mais recente em downloads de tempo de execução.
  • Uma versão e canal de lançamento do runtime que correspondem à versão e ao canal de lançamento do pacote NuGet do Microsoft.WindowsAppSDK que instalaste.

Escolha a opção de Instalador apropriada para a arquitetura da sua máquina.

Importante

Quando a sua aplicação for implementada, será responsável por implementar os pacotes de execução necessários do SDK de Aplicações Windows para os seus utilizadores finais. Para mais informações, consulte o guia de implementação SDK de Aplicações Windows para aplicações dependentes do framework empacotadas com localização externa ou não empacotadas.

2. Inicialize o Runtime do SDK de Aplicações Windows

Por padrão, uma aplicação de ambiente de trabalho WPF, WinForms ou Win32 não está empacotada. Uma aplicação não empacotada deve inicializar o runtime do SDK de Aplicações Windows antes de usar qualquer outra funcionalidade do SDK de Aplicações Windows.

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

  1. Em Explorador de Soluções, clique com o botão direito no seu projeto e escolha Editar Ficheiro de Projeto.

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

<WindowsPackageType>None</WindowsPackageType>

Quando constrói o seu projeto, estes ficheiros são adicionados ao seu projeto no Visual Studio:

  • MddBootstrapAutoInitializer.cs
  • WindowsAppSDK-VersionInfo.cs

  1. Edita manualmente o teu ficheiro .cxproj.

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

<WindowsPackageType>None</WindowsPackageType>

Observação

Se tiver necessidades avançadas (como gestão personalizada de erros ou carregar uma versão específica do SDK de Aplicações Windows), então em vez de autoinicialização pode chamar explicitamente a API do bootstrapper — para mais informações, veja Use o SDK de Aplicações Windows Runtime para aplicações empacotadas com localização externa ou não empacotadas e Tutorial: Use a API bootstrapper numa aplicação empacotada com localização externa ou não empacotada que use o SDK de Aplicações Windows.

Mais informações

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

Ver também

  • Last updated on