Installieren und Bereitstellen von Windows ML

Installieren Sie Folgendes für frameworkabhängige (empfohlen):

• Microsoft.WindowsAppSDK.ML
• Microsoft.WindowsAppSDK.Runtime
• Dann finden Sie informationen zum Bereitstellen der Laufzeit unter Bereitstellung von frameworkabhängigen Apps.

Für eigenständig (erhöht die App-Größe um ~41 MB):

• Installieren Sie für Apps, die auf Windows 10 Build 18362 oder höher ausgerichtet sind, Microsoft.Windows. AI. MachineLearning
• Oder installieren Sie Microsoft.WindowsAppSDK.ML für Apps, die Windows 10 Build 17763 oder höher unterstützen.
• Installieren Sie nicht Microsoft.WindowsAppSDK.Runtime oder das Hauptpaket Microsoft.WindowsAppSDK

Installieren Sie Folgendes für frameworkabhängige (empfohlen):

• Microsoft.WindowsAppSDK.ML
• Microsoft.WindowsAppSDK.Runtime
• Dann finden Sie informationen zum Bereitstellen der Laufzeit unter Bereitstellung von frameworkabhängigen Apps.

Für eigenständig (erhöht die App-Größe um ~41 MB):

• Installieren Sie für Apps, die auf Windows 10 Build 18362 oder höher ausgerichtet sind, Microsoft.Windows. AI. MachineLearning
• Oder installieren Sie für Apps, die auf Windows 10 Build 17763 oder höher ausgelegt sind, Microsoft.WindowsAppSDK.ML
• Installieren Sie nicht Microsoft.WindowsAppSDK.Runtime oder das Hauptpaket Microsoft.WindowsAppSDK

Für eigenständige (framework-dependent wird für C/C++ nicht unterstützt), verweisen Sie auf Microsoft.Windows.AI.MachineLearning, und konfigurieren Sie CMake für die Verwendung des build/cmake Verzeichnisses. Siehe unten unter Eigenständige Installation für das vollständige CMake-Setup.

Für frameworkabhängige Installationen die erforderlichen Pakete installieren.

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

Installieren Sie dann die Windows App SDK-Runtime , die der Version der wasdk- Pakete entspricht.

• .NET 8 oder höher
• Target Framework Moniker net8.0-windows10.0.17763.0 oder höher, wenn Microsoft.WindowsAppSDK.ML verwendet wird, oder Target Framework Moniker net8.0-windows10.0.18362.0 oder höher, wenn Microsoft.Windows.AI.MachineLearning verwendet wird.

• C++20 oder höher

• Visual Studio 2022 mit C++-Workload
• CMake 3.21 oder höher

• Python 3.10–3.13 auf x64 oder ARM64
• Eine entpackte Python-Installation (python.org oder Winget – nicht der Microsoft Store)

Installieren oder aktualisieren Sie in Ihrem Projekt die folgenden NuGet-Pakete:

• Microsoft.WindowsAppSDK.ML(dadurch werden die Windows ML-APIs hinzugefügt)
• Microsoft.WindowsAppSDK.Runtime(Dadurch wird der frameworkabhängige Modus aktiviert)

Stellen Sie außerdem in Ihrer .csproj-Datei sicher, dass WindowsAppSDKSelfContained entweder nicht angegeben ist (nicht vorhanden) oder false, damit eine framework-abhängige Bereitstellung verwendet wird.

Installieren oder aktualisieren Sie in Ihrem Projekt die folgenden NuGet-Pakete:

• Microsoft.WindowsAppSDK.ML(dadurch werden die Windows ML-APIs hinzugefügt)
• Microsoft.WindowsAppSDK.Runtime(Dadurch wird der frameworkabhängige Modus aktiviert)

Stellen Sie außerdem in der Projektdatei sicher, dass WindowsAppSDKSelfContained entweder nicht angegeben (nicht vorhanden) ist oder false, um eine frameworkabhängige Bereitstellung zu ermöglichen.

Frameworkabhängige C/C++-Unterstützung ist derzeit nicht verfügbar. Verwenden Sie entweder C++/WinRT oder eine in sich abgeschlossene Version, wie unten beschrieben.

Installieren Sie die erforderlichen Pakete:

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

Installieren Sie dann die Windows App SDK-Runtime , die der Version der wasdk- Pakete entspricht.

Installieren oder aktualisieren Sie in Ihrem Projekt die folgenden NuGet-Pakete:

• Für Apps für Windows 10 Build 18362 oder höher:
  • Installieren Sie Microsoft.Windows.AI.MachineLearning(dies fügt die Windows ML-APIs und Binärdateien hinzu, wobei standardmäßig eigenständig eingestellt wird)
• Oder für Apps, die auf Windows 10 Build 17763 oder höher ausgerichtet sind:
  • Installieren Sie Microsoft.WindowsAppSDK.ML (dies fügt die Windows ML-APIs und Binärdateien hinzu, standardmäßig eigenständig und bietet RegFree WinRT-Unterstützung für 17763).
• Installieren Sie Microsoft.WindowsAppSDK.Runtime NICHT(dies würde den frameworkabhängigen Modus aktivieren... entfernen, wenn sie zurzeit installiert ist)
• Installieren Sie nicht das Hauptpaket "Microsoft.WindowsAppSDK NuGet" (dies würde den frameworkabhängigen Modus aktivieren... entfernen, wenn sie zurzeit installiert ist)
• Sie können andere Windows App SDK-Komponentenpakete wie Microsoft.WindowsAppSDK.AI installieren, solange Sie die Runtime oder das Hauptpaket nicht installieren.

Installieren oder aktualisieren Sie in Ihrem Projekt die folgenden NuGet-Pakete:

• Für Apps für Windows 10 Build 18362 oder höher:
  • Installieren Sie Microsoft.Windows.AI.MachineLearning(dies fügt die Windows ML-APIs und Binärdateien hinzu und wird standardmäßig als selbstständig eingerichtet)
• Oder für Apps, die auf Windows 10 Build 17763 oder höher ausgerichtet sind:
  • Installieren Sie Microsoft.WindowsAppSDK.ML(dies fügt die Windows ML-APIs und Binärdateien hinzu, stellt standardmäßig einen selbständigen Betrieb sicher und fügt RegFree WinRT-Unterstützung für 17763 hinzu)
• Installieren Sie Microsoft.WindowsAppSDK.Runtime NICHT(dies würde den frameworkabhängigen Modus aktivieren... entfernen, wenn sie zurzeit installiert ist)
• Installieren Sie nicht das Hauptpaket "Microsoft.WindowsAppSDK NuGet" (dies würde den frameworkabhängigen Modus aktivieren... entfernen, wenn sie zurzeit installiert ist)
• Sie können andere Windows App SDK-Komponentenpakete wie Microsoft.WindowsAppSDK.AI installieren, solange Sie die Runtime oder das Hauptpaket nicht installieren.

Die C-APIs werden im Microsoft.Windows.AI.MachineLearning NuGet-Paket ausgeliefert. Das Paket enthält CMake-Konfigurationsdateien für build/cmake/ die direkte Nutzung.

So verwenden Sie das NuGet-Paket...

1. Herunterladen oder Wiederherstellen des NuGet-Pakets (z. B. über nuget restore oder manuelles Herunterladen)
2. Extrahieren oder Verweisen auf das Paketstammverzeichnis
3. Auf CMAKE_PREFIX_PATH im Unterverzeichnis des Pakets build/cmake festlegen

BeispielCMakeLists.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
)

Beispiel-Buildbefehle

# 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

Das NuGet-Paket enthält eine eigene CMake-Konfiguration unter build/cmake/, die die NuGet-Verzeichnisstruktur versteht (architekturspezifische Verzeichnisse unter lib/native/ und runtimes/). Die Architektur wird aus CMAKE_GENERATOR_PLATFORM, CMAKE_VS_PLATFORM_NAME oder CMAKE_SYSTEM_PROCESSOR bestimmt.

Die vcpkg-Portdatei generiert eine separate, dünne Konfigurationsdatei, die dem standardmäßigen vcpkg-Layout (lib/ und bin/) zugeordnet ist. Beide Konfigurationen verwenden dieselbe Zieldatei (microsoft.windows.ai.machinelearning-targets.cmake), die die IMPORTIERTen Ziele definiert.

Die gleichen Ziele (WindowsML::WindowsML, WindowsML::Api, WindowsML::OnnxRuntime, WindowsML::DirectML) sind in beiden Verbrauchsmodi verfügbar. Verwenden Sie den standardmäßigen CMake 3.21-Generatorausdruck $<TARGET_RUNTIME_DLLS>, um Laufzeit-DLLs in das Build-Ausgabeverzeichnis zu kopieren.

Selbständige Bereitstellung ist nicht möglich für Python. Verwenden Sie die oben beschriebenen frameworkabhängigen Pip-Pakete.