Portar um aplicativo do Windows ML existente para o pacote NuGet (C++)

Artigo
03/14/2024

Neste tutorial, usaremos um aplicativo da área de trabalho do WinML existente e o portaremos usando o pacote NuGet redistribuível.

Pré-requisitos

Um aplicativo do WinML. Se você estiver criando um novo aplicativo, consulte Tutorial: Criar um aplicativo da área de trabalho do Windows Machine Learning (C++)
Windows 8.1 ou superior
Visual Studio 2019 (ou Visual Studio 2017, versão 15.7.4 ou posterior)
Baixar o pacote NuGet do CppWinRT

Adicionar o pacote NuGet ao seu projeto

No projeto do Visual Studio do seu aplicativo existente, navegue até o Gerenciador de Soluções e selecione Gerenciar pacotes NuGet para a Solução. Escolha o pacote NuGet Microsoft.AI.MachineLearning. Adicione ao projeto correto e pressione Instalar.

Em seguida, crie sua solução novamente. O kit de ferramentas do C++/WinRT analisará os novos cabeçalhos e metadados do pacote NuGet Microsoft.AI.MachineLearning, evitando confusão na próxima etapa.

Incluir o novo cabeçalho

Para melhores práticas, você deve adicionar um sinalizador de controle para permitir que seu aplicativo alterne entre usar o Windows ML nativo e o pacote NuGet.

#ifdef USE_WINML_NUGET
#include “winrt/Microsoft.AI.MachineLearning.h” 
#endif

Alterar o namespace

Em seguida, permita que o Windows::AI::Machinelearning alterne para o namespace Microsoft::AI::MachineLearning usando um sinalizador de controle. Fazendo essa alteração, seu código usará automaticamente o pacote NuGet, se aplicável.

#ifdef USE_WINML_NUGET 

Using namespace Microsoft::AI::MachineLearning 

#else 

Using namespace Windows::AI::MachineLearning 

#endif

Alterar as definições do pré-processador

Em seguida, clique com o botão direito do mouse no projeto no Gerenciador de Soluções e selecione Propriedades. Na janela Propriedades, escolha a página Pré-processador. Edite as Definições do Pré-processador e altere-as para USE_WINML_NUGET:_DEBUG.

Salvar configurações de build

Clique com o botão direito do mouse na solução no Gerenciador de Soluções e selecione Propriedades. Na janela Propriedades, selecione Gerenciador de Configurações. Abra o menu suspenso de Configuração da solução ativa e escolha <Novo...>. Insira o nome da nova configuração da solução e verifique se Criar configurações de projeto está marcado. Agora as definições de pré-processador podem ser salvas nas configurações de build desejadas.

Criar e executar

Seu aplicativo agora usa com êxito o pacote NuGet do WinML.

Partilhar via