Instalar e implementar o Windows ML

Para dependente do framework (recomendado), instale:

• Microsoft.WindowsAppSDK.ML
• Microsoft.WindowsAppSDK.Runtime
• Depois, veja Deployment para aplicações dependentes do framework para saber como implementar o runtime

Para conteúdo autónomo (aumenta o tamanho da aplicação em ~41 MB):

• Para aplicações direcionadas a Windows 10 Build 18362 ou superior, instale Microsoft.Windows. IA. Aprendizagem Automática
• Ou, para aplicações direcionadas a Windows 10 Build 17763 ou superior, instale Microsoft. WindowsAppSDK.ML
• Não instale Microsoft.WindowsAppSDK.Runtime nem o pacote principal Microsoft.WindowsAppSDK

Para dependente do framework (recomendado), instale:

• Microsoft.WindowsAppSDK.ML
• Microsoft.WindowsAppSDK.Runtime
• Depois, veja Deployment para aplicações dependentes do framework para saber como implementar o runtime

Para conteúdo autónomo (aumenta o tamanho da aplicação em ~41 MB):

• Para aplicações direcionadas a Windows 10 Build 18362 ou superior, instale Microsoft.Windows. IA. Aprendizagem Automática
• Ou, para aplicações direcionadas a Windows 10 Build 17763 ou superior, instale Microsoft. WindowsAppSDK.ML
• Não instale Microsoft.WindowsAppSDK.Runtime nem o pacote principal Microsoft.WindowsAppSDK

Para autónomo (dependente do framework não é suportado para C/C++), consulte Microsoft.Windows. IA. MachineLearning e configurar o CMake para usar o seu diretório build/cmake. Veja Instalação autónoma abaixo para a configuração completa do CMake.

Para dependência do framework, instale os pacotes necessários:

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

E depois instalar o Windows App SDK Runtime que corresponde à versão dos wasdk- pacotes.

• .NET 8 ou superior
• O nome de framework alvo net8.0-windows10.0.17763.0 ou superior se usar Microsoft. WindowsAppSDK.ML, ou designação de framework alvo net8.0-windows10.0.18362.0 ou superior se usar Microsoft.Windows. IA. Aprendizagem Automática

• C++20 ou posterior

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

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

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

• Microsoft.WindowsAppSDK.ML(isto adiciona as APIs de ML do Windows)
• Microsoft.WindowsAppSDK.Runtime(isto ativa o modo dependente do framework)

Além disso, no seu .csproj ficheiro, certifique-se de que WindowsAppSDKSelfContained está ou não especificado (não presente), ou false, para que utilize a implementação dependente do framework.

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

• Microsoft.WindowsAppSDK.ML(isto adiciona as APIs de ML do Windows)
• Microsoft.WindowsAppSDK.Runtime(isto ativa o modo dependente do framework)

Além disso, no ficheiro do seu projeto, certifique-se de que WindowsAppSDKSelfContained não está especificado (não presente), ou false, para que use implementação dependente do framework.

O suporte C/C++ dependente do framework não está atualmente disponível. Use C++/WinRT, ou seja autónomo conforme descrito abaixo.

Instale os pacotes necessários:

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

E depois instalar o Windows App SDK Runtime que corresponde à versão dos wasdk- pacotes.

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

• Para aplicações direcionadas ao Windows 10 Build 18362 ou superior:
  • Instala Microsoft.Windows. IA. Aprendizagem Automática(isto adiciona as APIs e binários de ML Windows, por defeito é autónomo)
• Ou, para aplicações direcionadas ao Windows 10 Build 17763 ou superior:
  • Instala Microsoft. WindowsAppSDK.ML(isto adiciona as APIs e binários de ML Windows, passa a ser autónomo por defeito e adiciona suporte RegFree para WinRT 17763)
• NÃO instale o Microsoft.WindowsAppSDK.Runtime(isto permitiria o modo dependente do framework... remova-o se já o tiver instalado)
• NÃO instale o pacote principal Microsoft.WindowsAppSDKNuGet (isto ativaria o modo dependente do framework... remova-o se já o tiver instalado)
• Sinta-se à vontade para instalar outros pacotes de componentes do SDK de Aplicações Windows como Microsoft.WindowsAppSDK.AI, desde que não instale o Runtime ou o pacote principal

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

• Para aplicações direcionadas ao Windows 10 Build 18362 ou superior:
  • Instala Microsoft.Windows.AI.MachineLearning(isto adiciona as APIs e binários do Windows ML, por defeito é contido em si mesmo)
• Ou, para aplicações direcionadas ao Windows 10 Build 17763 ou superior:
  • Instala Microsoft. WindowsAppSDK.ML(isto adiciona as APIs e binários de ML Windows, passa a ser autónomo por defeito e adiciona suporte RegFree para WinRT 17763)
• NÃO instale o Microsoft.WindowsAppSDK.Runtime(isto permitiria o modo dependente do framework... remova-o se já o tiver instalado)
• NÃO instale o pacote principal Microsoft.WindowsAppSDKNuGet (isto ativaria o modo dependente do framework... remova-o se já o tiver instalado)
• Sinta-se à vontade para instalar outros pacotes de componentes do SDK de Aplicações Windows como Microsoft.WindowsAppSDK.AI, desde que não instale o Runtime ou o pacote principal

As APIs C são incluídas no pacote NuGet Microsoft.Windows.AI.MachineLearning NuGet. O pacote inclui ficheiros de configuração CMake sob build/cmake/ para consumo direto.

Para usar o pacote NuGet...

1. Descarregue ou restaure o pacote NuGet (por exemplo, através nuget restore ou descarregamento manual)
2. Extrair ou referenciar o diretório raiz do pacote
3. Defina CMAKE_PREFIX_PATH para o subdiretório build/cmake 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 build 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 contém a sua própria configuração cmake embaixo de build/cmake/ que reconhece a estrutura de diretórios NuGet (diretórios específicos de arquitetura sob lib/native/ e runtimes/). A arquitetura é determinada a partir de CMAKE_GENERATOR_PLATFORM, CMAKE_VS_PLATFORM_NAME, ou CMAKE_SYSTEM_PROCESSOR.

O portfile vcpkg gera um ficheiro de configuração separado e fino que corresponde ao layout padrão vcpkg (lib/ e bin/). Ambas as configurações partilham o mesmo ficheiro de alvos (microsoft.windows.ai.machinelearning-targets.cmake) que define os alvos IMPORTADOS.

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 CMake 3.21 $<TARGET_RUNTIME_DLLS> para copiar DLLs em tempo de execução para o diretório de saída da compilação.

A implementação autónoma não é aplicável para Python. Use os pacotes pip dependentes do framework descritos acima.