Installieren und Bereitstellen von Windows ML

Windows ML unterstützt zwei Bereitstellungsmodi für die Windows ML-Runtime: eigenständig und frameworkabhängig. Wählen Sie basierend auf den Anforderungen für Größe, Aktualisierung und Abhängigkeit Ihrer App aus.

Weitere Informationen zu Windows ML finden Sie unter "Was ist Windows ML".

Schnellstart

Hier ist die kurze Version der Installation von Windows ML in Ihrem Projekt:

Für eigenständige Apps (erhöht die App-Größe um ~41 MB, wird nicht automatisch aktualisiert):

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

Für frameworkabhängige (kleinere App-Größe, automatische Updates) installieren Sie:

Microsoft.WindowsAppSDK.ML
Microsoft.WindowsAppSDK.Runtime
Dann finden Sie Informationen zur Bereitstellung der Windows App SDK Laufzeit (einschließlich der Windows ML-Runtime) unter Bereitstellung für Windows App SDK frameworkabhängige Apps.

Für eigenständige Apps (erhöht die App-Größe um ~41 MB, wird nicht automatisch aktualisiert):

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

Für frameworkabhängige (kleinere App-Größe, automatische Updates) installieren Sie:

Microsoft.WindowsAppSDK.ML
Microsoft.WindowsAppSDK.Runtime
Dann finden Sie Informationen zur Bereitstellung der Windows App SDK Laufzeit (einschließlich der Windows ML-Runtime) unter Bereitstellung für Windows App SDK frameworkabhängige Apps.

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.

Ausführliche Informationen zu den einzelnen Optionen finden Sie in den folgenden Abschnitten.

Anforderungen

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

Note

Mit .NET 6 können Sie den Microsoft.Windows.AI.MachineLearning-Namespace zum Installieren von Ausführungsanbietern verwenden, aber die Microsoft.ML.OnnxRuntime-APIs sind nicht verfügbar. Führen Sie ein Upgrade auf .NET 8 durch, um auf die vollständige Windows ML-API-Oberfläche zuzugreifen.

Was ist in der Windows ML Runtime?

Die Windows ML Runtime besteht aus diesen Binärdateien:

Binary	Beschreibung	Ca. Größe
`Microsoft.Windows.AI.MachineLearning.dll`	Windows ML-APIs (`ExecutionProviderCatalog` usw.)	~1 MB
`onnxruntime.dll`	Die ONNX-Laufzeitumgebung	~20 MB
`DirectML.dll`	DirectML – der enthaltene GPU-Ausführungsanbieter	~20 MB
	Gesamt	~41 MB

Anbieterausführungsanbieter (QNN, VitisAI, OpenVINO, NvTensorRtRtx, MIGraphX) sind nicht Teil der Windows ML Runtime. Sie werden separat bezogen – entweder über die ExecutionProviderCatalog zur Laufzeit oder von Ihnen selbst gebündelt. Siehe KI-Modelle beschleunigen.

Auswählen eines Bereitstellungsmodus

Bei Verwendung von Windows ML können Sie zwischen zwei Bereitstellungsmodi für die Windows ML-Runtime wählen: eigenständig und frameworkabhängig.

	Eigenständig	Framework-abhängig
Unterstützte Sprachen	C#, C++/WinRT, C/C++	C#, C++/WinRT, Python
Unterstützte Verpackungstypen	Entpackt und verpackt (MSIX)	Entpackt und verpackt (MSIX)
Unternehmenseinführung	Unterstützt	Unterstützt
App-Größe	Größer – Windows ML-Runtime-Binärdateien werden mit Ihrer App gebündelt (~41 MB)	Kleiner – Windows ML-Runtime-Binärdateien werden systemweit gemeinsam genutzt
Windows ML-Updates	Manuell – Sie versenden eine neue Version, wenn Sie wählen.	Automatisch – Benutzer erhalten Updates über die Windows App SDK-Wartung
Abhängigkeit von installierter Laufzeit	Nein – alle Abhängigkeiten befinden sich im App-Paket.	Ja – Windows App SDK-Laufzeit muss vorhanden sein
NuGet-Paket (C#/C++)	`Microsoft.Windows.AI.MachineLearning` oder `Microsoft.WindowsAppSDK.ML`	`Microsoft.WindowsAppSDK.ML` + `Microsoft.WindowsAppSDK.Runtime`
Am besten geeignet für	Strenge Versionskontrolle	Apps, die eine minimale Download-/Installationsgröße erfordern; Apps, die über den Microsoft Store versenden

Eigenständige Installation

Apps können die Windows ML-Runtime-Binärdateien direkt in der App selbst enthalten. Es ist keine externe Laufzeitabhängigkeit erforderlich, ihre App ist jedoch größer. Dies ist die Standardeinstellung, wenn Sie auf Microsoft.Windows.AI.MachineLearning oder Microsoft.WindowsAppSDK.ML verweisen, ohne auf das Hauptpaket Microsoft.WindowsAppSDK oder Microsoft.WindowsAppSDK.Runtime zu verweisen. Wenn Sie die Windows App SDK-Pakete verwenden, finden Sie im Bereitstellungshandbuch für eigenständige Apps ausführliche Informationen.

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.

Note

Wenn Sie das Hauptpaket Microsoft.WindowsAppSDK NuGet verwenden müssen, aktualisieren Sie es auf Version 1.8.1 oder höher, welches Windows ML und alle anderen Windows App SDK-APIs enthält, und legen Sie in Ihrer .csproj den Wert von WindowsAppSDKSelfContained auf true fest, um den eigenständigen Modus zu aktivieren.

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.

Note

Wenn Sie das Hauptpaket Microsoft.WindowsAppSDK NuGet verwenden müssen, aktualisieren Sie es auf Version 1.8.1 oder höher. Diese Version beinhaltet Windows ML und alle anderen APIs des Windows App SDK. Stellen Sie in Ihrem Projekt WindowsAppSDKSelfContained auf true ein, um den eigenständigen Modus zu aktivieren.

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

So verwenden Sie das NuGet-Paket...

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

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.

Minimieren der eigenständigen App-Größe durch Ausschließen von DirectML

Note

Diese Konfiguration wird nicht offiziell unterstützt. Es basiert auf dem internen Dateilayout des Microsoft.Windows. KI. MachineLearning-Paket, das sich in einer zukünftigen Version ändern könnte. Testen Sie sorgfältig nach einem Paketupdate.

Die eigenständige Windows ML-Runtime bündelt drei Binärdateien: die Windows ML-API (Microsoft.Windows.AI.MachineLearning.dll), das ONNX-Runtime-Modul (onnxruntime.dll) und den DirectML-Ausführungsanbieter (DirectML.dll, ~20 MB). Wenn Ihre App nur ONNX-Runtime-APIs direkt aufruft und nie den DirectML-Ausführungsanbieter anfordert, können Sie den eigenständigen Speicherbedarf reduzieren DirectML.dll und ungefähr halbieren.

Führen Sie die eigenständigen Installationsschritte für C# aus, und fügen Sie dann ihrem Postbuildziel .csproj ein, um die nicht verwendete Binärdatei aus dem Ausgabeverzeichnis zu entfernen. Wenn Sie nicht für eine bestimmte RuntimeIdentifierArchitektur erstellen oder veröffentlichen, enthält die Ausgabe auch eine Kopie von DirectML.dll unter runtimes\<rid>\native\ für jede unterstützte Architektur (win-x64, win-arm64, win-arm64ec), und entfernen Sie diese ebenfalls:

<Target Name="RemoveUnusedWindowsMLBinaries" AfterTargets="Build">
  <ItemGroup>
    <_UnusedDirectML Include="$(OutDir)DirectML.dll" Condition="Exists('$(OutDir)DirectML.dll')" />
    <_UnusedDirectML Include="$(OutDir)runtimes\win-*\native\DirectML.dll" />
  </ItemGroup>
  <Delete Files="@(_UnusedDirectML)" />
</Target>

<Target Name="RemoveUnusedWindowsMLBinariesFromPublish" AfterTargets="Publish">
  <ItemGroup>
    <_UnusedDirectMLPublish Include="$(PublishDir)DirectML.dll" Condition="Exists('$(PublishDir)DirectML.dll')" />
    <_UnusedDirectMLPublish Include="$(PublishDir)runtimes\win-*\native\DirectML.dll" />
  </ItemGroup>
  <Delete Files="@(_UnusedDirectMLPublish)" />
</Target>

Führen Sie die eigenständigen Installationsschritte für C++/WinRT aus, und fügen Sie dann ihrer Projektdatei ein MSBuild-Ziel nach dem Build hinzu,.vcxproj um die nicht verwendete Binärdatei aus dem Ausgabeverzeichnis zu entfernen:

<Target Name="RemoveUnusedWindowsMLBinaries" AfterTargets="Build">
  <Delete Files="$(OutDir)DirectML.dll" />
</Target>

Wenn Sie das Paket über CMake nutzen (siehe eigenständige Installation), DirectML.dll ist bereits standardmäßig ausgeschlossen: Es verfügt über keine Importbibliothek, sodass es niemals in den standardmäßigen $<TARGET_RUNTIME_DLLS:MyApp> Postbuildkopie-Befehl eingeschlossen ist, unabhängig davon, mit welchen WindowsML::* Zielen Sie eine Verknüpfung herstellen. Fügen Sie sie nur wieder hinzu, wenn Sie den DirectML-Ausführungsanbieter verwenden, wie in den Kommentaren von microsoft.windows.ai.machinelearning-config.cmake.

Wenn Sie das Paket direkt über MSBuild nutzen (ein .vcxproj Element, das auf das NuGet-Paket verweist, anstatt CMake zu verwenden), fügen Sie ihrer Projektdatei ein MSBuild-Ziel nach dem Build hinzu (.vcxproj), um die nicht verwendete Binärdatei aus dem Ausgabeverzeichnis zu entfernen:

<Target Name="RemoveUnusedWindowsMLBinaries" AfterTargets="Build">
  <Delete Files="$(OutDir)DirectML.dll" />
</Target>

Frameworkabhängige Installation

Die frameworkabhängige Version der Windows ML-Runtime ist in der Windows App SDK Laufzeit enthalten, die auf dem Computer des Endbenutzers installiert werden muss. Ausführliche Informationen finden Sie unter "Bereitstellung für Windows App SDK frameworkabhängige Apps".

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)

Note

Alternativ können Sie das Hauptpaket "Microsoft.WindowsAppSDK NuGet" auf Version 1.8.1 oder höher installieren/aktualisieren, das Windows ML und alle anderen Windows App SDK-APIs enthält und standardmäßig frameworkabhängig ist.

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)

Note

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.

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.

Sehen Sie sich schließlich die Bereitstellungsarchitektur für frameworkabhängige Apps an, um zu erfahren, wie Sie die Windows App SDK-Laufzeit zusammen mit Ihrer App auf den Geräten Ihres Benutzers bereitstellen.

Nächster Schritt

Erste Schritte mit Windows ML

Siehe auch

Feedback

War diese Seite hilfreich?

Last updated on 2026-08-13

Installieren und Bereitstellen von Windows ML

Schnellstart

Anforderungen

Was ist in der Windows ML Runtime?

Auswählen eines Bereitstellungsmodus

Eigenständige Installation

Minimieren der eigenständigen App-Größe durch Ausschließen von DirectML

Frameworkabhängige Installation

Nächster Schritt

Siehe auch

Feedback

Zusätzliche Ressourcen