Windows ML をインストールして展開する

フレームワークに依存する (推奨) 場合は、次をインストールします。

• Microsoft.WindowsAppSDK.ML
• Microsoft.WindowsAppSDK.Runtime
• 次に、ランタイム をデプロイする方法については、フレームワークに依存するアプリ の展開に関する説明を参照してください

自己完結型の場合 (アプリ のサイズを最大 41 MB 増やす):

• ビルド 18362 以降Windows 10対象のアプリの場合は、Microsoft.Windows をインストールします。Ai。MachineLearning
• または、ビルド 17763 以降Windows 10対象のアプリの場合は、Microsoftをインストールします。WindowsAppSDK.ML
• Microsoft.WindowsAppSDK.Runtime またはメイン Microsoft.WindowsAppSDK パッケージをインストールしないでください

フレームワークに依存する (推奨) 場合は、次をインストールします。

• Microsoft.WindowsAppSDK.ML
• Microsoft.WindowsAppSDK.Runtime
• 次に、ランタイム をデプロイする方法については、フレームワークに依存するアプリ の展開に関する説明を参照してください

自己完結型の場合 (アプリ のサイズを最大 41 MB 増やす):

• ビルド 18362 以降Windows 10対象のアプリの場合は、Microsoft.Windows をインストールします。Ai。MachineLearning
• または、ビルド 17763 以降Windows 10対象のアプリの場合は、Microsoftをインストールします。WindowsAppSDK.ML
• Microsoft.WindowsAppSDK.Runtime またはメイン Microsoft.WindowsAppSDK パッケージをインストールしないでください

自己完結型 (フレームワーク依存は C/C++ ではサポートされていません) については、Microsoft.Windows を参照してください。Ai。MachineLearningし、build/cmake ディレクトリを使用するように CMake を構成します。 完全な CMake セットアップについては、以下の 自己完結型インストール を参照してください。

フレームワークに依存する場合は、必要なパッケージをインストールします。

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

次に、 パッケージのバージョンに一致する wasdk-をインストールします。

• .NET 8 以上
• ターゲット フレームワーク モニカー net8.0-windows10.0.17763.0 以上を使用する場合は Microsoft.WindowsAppSDK.ML、またはターゲット フレームワーク モニカー net8.0-windows10.0.18362.0 以上を使用する場合は Microsoft.Windows.AI.MachineLearning を利用してください。

• C++20 以降

• Visual Studio 2022 と C++ ワークロード
• CMake 3.21 以降

• x64 または ARM64 の Python 3.10 – 3.13
• パッケージ化されていない Python インストール (microsoft Store ではなく python.org または winget)

プロジェクトで、次の NuGet パッケージをインストールまたは更新します。

• Microsoft.WindowsAppSDK.ML(これにより Windows ML API が追加されます)
• Microsoft.WindowsAppSDK.Runtime(フレームワーク依存モードが有効になります)

また、 .csproj ファイルで、フレームワークに依存する展開を使用するように、 WindowsAppSDKSelfContained が指定されていない (存在しない) か、 falseであることを確認します。

プロジェクトで、次の NuGet パッケージをインストールまたは更新します。

• Microsoft.WindowsAppSDK.ML(これにより Windows ML API が追加されます)
• Microsoft.WindowsAppSDK.Runtime(フレームワーク依存モードが有効になります)

また、プロジェクト ファイルで、 WindowsAppSDKSelfContained が指定されていない (存在しない) か、 falseされていることを確認して、フレームワークに依存する配置を使用できるようにします。

フレームワークに依存する C/C++ のサポートは現在使用できません。 C++/WinRT を使用するか、次に説明するように自己完結型を使用します。

必要なパッケージをインストールします。

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

次に、 パッケージのバージョンに一致する wasdk-をインストールします。

プロジェクトで、次の NuGet パッケージをインストールまたは更新します。

• ビルド 18362 以降Windows 10対象のアプリの場合:
  • Microsoft.Windows をインストールします。Ai。MachineLearning(Windows ML API とバイナリが追加され、既定では自己完結型になります)
• または、ビルド 17763 以降Windows 10対象のアプリの場合:
  • Microsoft.WindowsAppSDK.ML をインストールします（Windows ML API とバイナリが追加され、デフォルトで自己完結型になり、17763 に対する RegFree WinRT サポートが追加されます）
• Microsoft.WindowsAppSDK.Runtime をインストールしないでください (これによりフレームワーク依存モードが有効になります...現在インストールされている場合は削除してください)
• メインの Microsoft.WindowsAppSDK NuGet パッケージをインストールしないでください (これにより、フレームワーク依存モードが有効になります...現在インストールされている場合は削除してください)
• ランタイムまたはメイン パッケージをインストールしない限り、 Microsoft.WindowsAppSDK.AI などの他の Windows アプリ SDK コンポーネント パッケージを自由にインストールできます

プロジェクトで、次の NuGet パッケージをインストールまたは更新します。

• ビルド 18362 以降Windows 10対象のアプリの場合:
  • Microsoft.Windows をインストールします。Ai。MachineLearning(Windows ML API とバイナリが追加され、既定では自己完結型になります)
• または、ビルド 17763 以降Windows 10対象のアプリの場合:
  • Microsoft.WindowsAppSDK.ML をインストールします(Windows ML API とバイナリを追加し、デフォルトで自己完結型となり、17763 の RegFree WinRT サポートを追加します)
• Microsoft.WindowsAppSDK.Runtime をインストールしないでください (これによりフレームワーク依存モードが有効になります...現在インストールされている場合は削除してください)
• メインの Microsoft.WindowsAppSDK NuGet パッケージをインストールしないでください (これにより、フレームワーク依存モードが有効になります...現在インストールされている場合は削除してください)
• ランタイムまたはメイン パッケージをインストールしない限り、 Microsoft.WindowsAppSDK.AI などの他の Windows アプリ SDK コンポーネント パッケージを自由にインストールできます

C API は、Microsoft.Windows.AI.MachineLearning NuGet パッケージに付属しています。 パッケージには、直接使用するために、 build/cmake/ の下に CMake 構成ファイルが含まれています。

NuGet パッケージを使用するには...

1. NuGet パッケージをダウンロードまたは復元する (例: nuget restore または手動ダウンロード)
2. パッケージのルート ディレクトリを抽出または参照する
3. CMAKE_PREFIX_PATHパッケージの build/cmake サブディレクトリに設定する

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
)

ビルド コマンドの例

# 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

NuGet パッケージは、NuGet ディレクトリ構造 (build/cmake/ および lib/native/ のアーキテクチャ固有のディレクトリ) を理解する独自の cmake 構成をruntimes/に提供します。 アーキテクチャは、 CMAKE_GENERATOR_PLATFORM、 CMAKE_VS_PLATFORM_NAME、または CMAKE_SYSTEM_PROCESSORから決定されます。

vcpkg portfile は、標準の vcpkg レイアウト (lib/ と bin/) にマップされる別個の薄い構成ファイルを生成します。 どちらの構成も、IMPORTED ターゲットを定義する同じターゲット ファイル (microsoft.windows.ai.machinelearning-targets.cmake) を共有します。

両方の消費モードで同じターゲット (WindowsML::WindowsML、 WindowsML::Api、 WindowsML::OnnxRuntime、 WindowsML::DirectML) を使用できます。 標準の CMake 3.21 $<TARGET_RUNTIME_DLLS> ジェネレーター式を使用して、ランタイム DLL をビルド出力ディレクトリにコピーします。

自己完結型のデプロイは、Python には適用できません。 上記のフレームワークに依存する pip パッケージを使用します。