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

Artigo
02/14/2025

Neste tutorial, pegaremos um aplicativo de desktop WinML existente e o portaremos para usar o pacote NuGet redistribuível .

Pré-requisitos

Um aplicativo WinML. Se você estiver criando um novo aplicativo, consulte Tutorial: Criar um aplicativo de á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)
Faça o download do pacote NuGet CppWinRT

Adicionar o pacote NuGet ao seu projeto

No projeto do Visual Studio para a sua aplicação existente, navegue até o Explorador de Soluções e selecione Gerir Pacotes NuGet para a Solução. Escolha o pacote NuGet Microsoft.AI.MachineLearning. Verifique se você está adicionando ao projeto correto e pressione Instalar.

Em seguida, crie sua solução novamente. O kit de ferramentas 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 seguir as práticas recomendadas, deve adicionar um indicador de controlo para permitir que a sua aplicação alterne entre o uso do Windows ML integrado 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. Ao fazer 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

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

Salvar configurações de compilação

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

Compilar e executar

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

Partilhar via