Instalar e implantar o Windows ML

Para dependentes de estrutura (recomendado), instale:

• Microsoft.WindowsAppSDK.ML
• Microsoft.WindowsAppSDK.Runtime
• Em seguida, consulte Implantação para aplicativos dependentes da estrutura para saber como implantar o runtime

Para autossuficiente (aumenta o tamanho do aplicativo em aproximadamente 41 MB):

• Para aplicativos direcionados para Windows 10 Build 18362 ou superior, instale Microsoft.Windows.AI.MachineLearning
• Ou, para aplicativos direcionados para o Windows 10 Build 17763 ou superior, instale Microsoft.WindowsAppSDK.ML
• Não instale Microsoft.WindowsAppSDK.Runtime ou o pacote principal Microsoft.WindowsAppSDK

Para dependentes de estrutura (recomendado), instale:

• Microsoft.WindowsAppSDK.ML
• Microsoft.WindowsAppSDK.Runtime
• Em seguida, consulte Implantação para aplicativos dependentes da estrutura para saber como implantar o runtime

Para autossuficiente (aumenta o tamanho do aplicativo em torno de 41 MB):

• Para aplicativos direcionados para o Windows 10 Build 18362 ou superior, instale Microsoft.Windows.AI.MachineLearning
• Ou, para aplicativos direcionados para Windows 10 Build 17763 ou superior, instale Microsoft.WindowsAppSDK.ML
• Não instale Microsoft.WindowsAppSDK.Runtime ou o pacote principal Microsoft.WindowsAppSDK

Para autossuficiente (não há suporte para dependentes de estrutura para C/C++), referencie Microsoft.Windows.AI.MachineLearning e configure o CMake para usar seu diretório build/cmake. Consulte a instalação autocontida abaixo para obter a configuração completa do CMake.

Para dependentes da estrutura, instale os pacotes necessários:

pip install wasdk-Microsoft.Windows.AI.MachineLearning[all] wasdk-Microsoft.Windows.ApplicationModel.DynamicDependency.Bootstrap onnxruntime-windowsml

Em seguida, instale o SDK do Aplicativo Windows Runtime que corresponde à versão dos wasdk- pacotes.

• .NET 8 ou superior
• Identificador de estrutura de destino net8.0-windows10.0.17763.0 ou superior se estiver usando Microsoft.WindowsAppSDK.ML ou identificador de estrutura de destino net8.0-windows10.0.18362.0 ou superior se estiver usando Microsoft.Windows.AI.MachineLearning

• C++20 ou posterior

• Visual Studio 2022 com carga de trabalho do C++
• CMake 3.21 ou posterior

• Python 3.10–3.13 no x64 ou ARM64
• Uma instalação do Python não empacotada (python.org ou winget — não a Microsoft Store)

Em seu projeto, instale ou atualize os seguintes pacotes NuGet:

• Microsoft.WindowsAppSDK.ML(isso adiciona as APIs do Windows ML)
• Microsoft.WindowsAppSDK.Runtime(isso permite o modo dependente da estrutura)

Além disso, em seu .csproj arquivo, verifique se WindowsAppSDKSelfContained não está especificado (não está presente) ou false, para usar a implantação dependente da estrutura.

Em seu projeto, instale ou atualize os seguintes pacotes NuGet:

• Microsoft.WindowsAppSDK.ML(isso adiciona as APIs do Windows ML)
• Microsoft.WindowsAppSDK.Runtime(isso permite o modo dependente da estrutura)

Além disso, no arquivo de projeto, verifique se WindowsAppSDKSelfContained não está especificado (não está presente) ou false, para que use a implantação dependente de framework.

O suporte a C/C++ dependente de framework não está disponível atualmente. Use C++/WinRT ou então uma abordagem independente, conforme descrito abaixo.

Instale os pacotes necessários:

pip install wasdk-Microsoft.Windows.AI.MachineLearning[all] wasdk-Microsoft.Windows.ApplicationModel.DynamicDependency.Bootstrap onnxruntime-windowsml

Em seguida, instale o SDK do Aplicativo Windows Runtime que corresponde à versão dos wasdk- pacotes.

Em seu projeto, instale ou atualize os seguintes pacotes NuGet:

• Para aplicativos destinados a Windows 10 Build 18362 ou superior:
  • Instale Microsoft.Windows.AI.MachineLearning(isso adiciona as APIs e binários do Windows ML, com padrão autodeterminado como autocontido)
• Ou, para aplicativos direcionados ao Windows 10 Build 17763 ou superior:
  • Instale Microsoft.WindowsAppSDK.ML(isso adiciona as APIs e os binários do Windows ML, o padrão é autocontido e adiciona suporte ao RegFree WinRT para 17763)
• NÃO instale Microsoft.WindowsAppSDK.Runtime(isso habilitaria o modo dependente da estrutura... remova-o se você o tiver instalado no momento)
• NÃO instale o pacote NuGet Microsoft.WindowsAppSDK principal (isso habilitaria o modo dependente da estrutura... remova-o se você o tiver instalado no momento)
• Fique à vontade para instalar outros pacotes de componentes do SDK do Aplicativo Windows, como Microsoft.WindowsAppSDK.AI, desde que você não instale o Runtime ou o pacote principal.

Em seu projeto, instale ou atualize os seguintes pacotes NuGet:

• Para aplicativos direcionados a Windows 10 Build 18362 ou superior:
  • Instale Microsoft.Windows.AI.MachineLearning(isso adiciona as APIs e binários do Windows ML, com padrão para autocontido)
• Ou, para aplicativos direcionados a Windows 10 compilação 17763 ou superior:
  • Instale Microsoft.WindowsAppSDK.ML(isso adiciona as APIs e binários do Windows ML, como padrão autocontido, e adiciona suporte ao RegFree WinRT para 17763)
• NÃO instale Microsoft.WindowsAppSDK.Runtime(isso habilitaria o modo dependente da estrutura... remova-o se você o tiver instalado no momento)
• NÃO instale o pacote NuGet Microsoft.WindowsAppSDK principal (isso habilitaria o modo dependente da estrutura... remova-o se você o tiver instalado no momento)
• Fique à vontade para instalar outros pacotes de componentes do SDK do Aplicativo Windows, como Microsoft.WindowsAppSDK.AI, desde que você não instale o Runtime ou o pacote principal.

As APIs C são enviadas no Microsoft.Windows.AI.MachineLearning pacote NuGet. O pacote inclui arquivos de configuração do CMake em build/cmake/ para consumo direto.

Para usar o pacote NuGet...

1. Baixar ou restaurar o pacote NuGet (por exemplo, por meio nuget restore ou download manual)
2. Extrair ou referenciar o diretório raiz do pacote
3. Definir CMAKE_PREFIX_PATH como o build/cmake subdiretório do pacote

Exemplo CMakeLists.txt

cmake_minimum_required(VERSION 3.21)
project(MyApp LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(microsoft.windows.ai.machinelearning CONFIG REQUIRED)

add_executable(MyApp main.cpp)
target_link_libraries(MyApp PRIVATE WindowsML::Api WindowsML::OnnxRuntime)

add_custom_command(TARGET MyApp POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different
        $<TARGET_RUNTIME_DLLS:MyApp> $<TARGET_FILE_DIR:MyApp>
    COMMAND_EXPAND_LISTS
    VERBATIM
)

Comandos de construção de exemplo

# Point CMAKE_PREFIX_PATH to the NuGet package's cmake directory
cmake -B build -S . -DCMAKE_PREFIX_PATH="C:/packages/Microsoft.Windows.AI.MachineLearning/build/cmake"
cmake --build build --config Release

O pacote NuGet inclui sua própria configuração CMake em build/cmake/, a qual entende a estrutura do diretório NuGet (diretórios específicos da arquitetura em lib/native/ e runtimes/). A arquitetura é determinada de CMAKE_GENERATOR_PLATFORM, CMAKE_VS_PLATFORM_NAMEou CMAKE_SYSTEM_PROCESSOR.

O portfile do vcpkg gera um arquivo de configuração separado e leve que mapeia para o layout padrão do vcpkg (lib/ e bin/). Ambas as configurações compartilham o mesmo arquivo de destino (microsoft.windows.ai.machinelearning-targets.cmake) que define os destinos IMPORTED.

Os mesmos alvos (WindowsML::WindowsML, WindowsML::Api, WindowsML::OnnxRuntime, WindowsML::DirectML) estão disponíveis em ambos os modos de consumo. Use a expressão geradora padrão do CMake 3.21 $<TARGET_RUNTIME_DLLS> para copiar DLLs de tempo de execução para o diretório de saída da compilação.

A implantação autônoma não é aplicável ao Python. Use os pacotes pip dependentes da estrutura descritos acima.