Instalación e implementación de Windows ML

Para dependiente del entorno (recomendado), instale:

• Microsoft.WindowsAppSDK.ML
• Microsoft.WindowsAppSDK.Runtime
• A continuación, consulte Implementación para aplicaciones dependientes del marco para obtener información sobre cómo implementar el entorno de ejecución.

Para autocontenido (aumenta el tamaño de la aplicación en ~41 MB)::

• Para las aplicaciones destinadas a Windows 10 compilación 18362 o posterior, instale Microsoft.Windows. IA. MachineLearning
• O bien, para las aplicaciones destinadas a Windows 10 compilación 17763 o posterior, instale Microsoft. WindowsAppSDK.ML
• No instale Microsoft.WindowsAppSDK.Runtime ni el paquete principal de Microsoft.WindowsAppSDK

Para dependiente del entorno (recomendado), instale:

• Microsoft.WindowsAppSDK.ML
• Microsoft.WindowsAppSDK.Runtime
• A continuación, consulte Implementación para aplicaciones dependientes del marco para obtener información sobre cómo implementar el entorno de ejecución.

Para autocontenido (aumenta el tamaño de la aplicación en ~41 MB)::

• Para las aplicaciones destinadas a Windows 10 compilación 18362 o posterior, instale Microsoft.Windows. IA. MachineLearning
• O bien, para las aplicaciones destinadas a Windows 10 compilación 17763 o posterior, instale Microsoft. WindowsAppSDK.ML
• No instale Microsoft.WindowsAppSDK.Runtime ni el paquete principal de Microsoft.WindowsAppSDK

Para autocontenido (no se admite dependiente del marco para C/C++), haga referencia a Microsoft.Windows.IA.MachineLearning y configure CMake para usar su directorio build/cmake. Consulte Instalación independiente a continuación para obtener la configuración completa de CMake.

En el caso de los componentes dependientes del marco, instale los paquetes necesarios:

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

A continuación, instale el SDK de Aplicaciones para Windows Runtime que coincida con la versión de los wasdk- paquetes.

• .NET 8 o superior
• Identificador del marco de destino net8.0-windows10.0.17763.0 o superior si se usa Microsoft.WindowsAppSDK.ML o identificador del marco de destino net8.0-windows10.0.18362.0 o superior si se usa Microsoft.Windows.AI.MachineLearning

• C++20 o posterior

• Carga de trabajo de Visual Studio 2022 con C++
• CMake 3.21 o posterior

• Python 3.10–3.13 en x64 o ARM64
• Una instalación de Python desempaquetada (python.org o winget, no microsoft Store)

En el proyecto, instale o actualice los siguientes paquetes NuGet:

• Microsoft.WindowsAppSDK.ML(esto agrega las API de Windows ML)
• Microsoft.WindowsAppSDK.Runtime(esto permite el modo dependiente del marco)

Además, en su archivo .csproj, asegúrese de que WindowsAppSDKSelfContained esté sin especificar (no esté presente), o que sea false, para que use la implementación dependiente del entorno.

En el proyecto, instale o actualice los siguientes paquetes NuGet:

• Microsoft.WindowsAppSDK.ML(esto agrega las API de Windows ML)
• Microsoft.WindowsAppSDK.Runtime(esto permite el modo dependiente del marco)

Además, en el archivo del proyecto, asegúrese de que WindowsAppSDKSelfContained no está especificado (no está presente) o false, para que use la implementación dependiente del marco.

La compatibilidad dependiente del marco con C/C++ no está disponible actualmente. Use C++/WinRT o de manera independiente, como se describe a continuación.

Instale los paquetes necesarios:

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

A continuación, instale el SDK de Aplicaciones para Windows Runtime que coincida con la versión de los wasdk- paquetes.

En el proyecto, instale o actualice los siguientes paquetes NuGet:

• Para las aplicaciones destinadas a Windows 10 compilación 18362 o posterior:
  • Instale Microsoft.Windows.AI.MachineLearning(esto agrega las API y archivos binarios de ML de Windows, el valor predeterminado es autocontenido)
• O bien, para las aplicaciones destinadas a Windows 10 compilación 17763 o posterior:
  • Instale Microsoft. WindowsAppSDK.ML(esto agrega las API y archivos binarios de Windows ML, el valor predeterminado es independiente y agrega compatibilidad con RegFree WinRT para 17763)
• No instale Microsoft.WindowsAppSDK.Runtime(esto habilitaría el modo dependiente del marco... quítelo si actualmente lo tiene instalado)
• No instale el paquete NuGet Microsoft.WindowsAppSDK principal (esto habilitaría el modo dependiente del marco... quítelo si actualmente lo tiene instalado)
• No dude en instalar otros paquetes de componentes de SDK de Aplicaciones para Windows como Microsoft.WindowsAppSDK.AI, siempre y cuando no instale el runtime o el paquete principal.

En el proyecto, instale o actualice los siguientes paquetes NuGet:

• Para las aplicaciones destinadas a Windows 10 compilación 18362 o posterior:
  • Instale Microsoft.Windows.AI.MachineLearning(esto agrega las API y archivos binarios de ML de Windows, el valor predeterminado es autocontenido)
• O bien, para las aplicaciones destinadas a Windows 10 compilación 17763 o posterior:
  • Instale Microsoft. WindowsAppSDK.ML(esto agrega las API y archivos binarios de Windows ML, el valor predeterminado es independiente y agrega compatibilidad con RegFree WinRT para 17763)
• No instale Microsoft.WindowsAppSDK.Runtime(esto habilitaría el modo dependiente del marco... quítelo si actualmente lo tiene instalado)
• No instale el paquete NuGet Microsoft.WindowsAppSDK principal (esto habilitaría el modo dependiente del marco... quítelo si actualmente lo tiene instalado)
• No dude en instalar otros paquetes de componentes de SDK de Aplicaciones para Windows como Microsoft.WindowsAppSDK.AI, siempre y cuando no instale el runtime o el paquete principal.

Las API de C se incluyen en el paquete NuGet Microsoft.Windows.AI.MachineLearning. El paquete incluye archivos de configuración de CMake en build/cmake/ para el consumo directo.

Para usar el paquete NuGet...

1. Descargar o restaurar el paquete NuGet (por ejemplo, mediante nuget restore o descarga manual)
2. Extracción o referencia al directorio raíz del paquete
3. Establezca CMAKE_PREFIX_PATH en el build/cmake subdirectorio del paquete.

Ejemplo de 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 compilación de ejemplo

# 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

El paquete NuGet incluye su propia configuración de cmake en build/cmake/ que entiende la estructura de directorios de NuGet (directorios específicos de la arquitectura en lib/native/ y runtimes/). La arquitectura se determina a partir de CMAKE_GENERATOR_PLATFORM, CMAKE_VS_PLATFORM_NAMEo CMAKE_SYSTEM_PROCESSOR.

El archivo de puerto vcpkg genera un archivo de configuración fino independiente que se asigna al diseño estándar de vcpkg (lib/ y bin/). Ambas configuraciones comparten el mismo archivo de destinos (microsoft.windows.ai.machinelearning-targets.cmake) que define los destinos IMPORTADOs.

Los mismos objetivos (WindowsML::WindowsML, WindowsML::Api, WindowsML::OnnxRuntime, WindowsML::DirectML) están disponibles en ambos modos de consumo. Use la expresión de generador de CMake 3.21 $<TARGET_RUNTIME_DLLS> estándar para copiar archivos DLL en tiempo de ejecución en el directorio de salida de compilación.

La implementación independiente no es aplicable a Python. Use los paquetes pip dependientes del marco descritos anteriormente.