Mendistribusikan aplikasi Anda yang menggunakan Windows ML

2025-07-08

Saat Anda siap mendistribusikan aplikasi C# atau C++ yang menggunakan Windows ML, Anda perlu memastikan bahwa kerangka kerja Windows App SDK disebarkan dengan benar ke perangkat pengguna Anda. Runtime Windows ML didistribusikan sebagai bagian dari Windows App SDK.

Penting

API Windows ML saat ini bersifat eksperimental dan tidak didukung untuk digunakan di lingkungan produksi. Aplikasi yang mencoba API ini tidak boleh diterbitkan ke Microsoft Store.

penyebaran Framework-Dependent

Windows ML dikirimkan sebagai komponen yang bergantung pada kerangka kerja melalui Windows App SDK. Ini berarti aplikasi Anda harus menyertakan referensi yang tepat untuk memastikan runtime Windows App SDK sudah dijalankan.

Untuk aplikasi paket (MSIX)

Untuk aplikasi paket MSIX, Anda perlu menyertakan dependensi pada paket kerangka kerja Windows App SDK dalam manifes aplikasi Anda.

Untuk detail selengkapnya, lihat Mengemas dan menyebarkan aplikasi Windows.

Untuk aplikasi yang tidak dikemas

Untuk aplikasi yang tidak dikemas (non-MSIX), Windows ML membutuhkan bootstrapper Windows App SDK untuk menginisialisasi komponen yang diperlukan. Tambahkan properti berikut ke file proyek Anda:

<PropertyGroup>
  <WindowsPackageType>None</WindowsPackageType>
</PropertyGroup>

Bootstrapper Windows App SDK akan menangani inisialisasi kerangka kerja saat runtime. Penginstal aplikasi Anda bertanggung jawab untuk menyebarkan versi SDK Aplikasi Windows yang kompatibel. Lihat panduan penyebaran Windows App SDK untuk detail selengkapnya.

Referensi paket NuGet

Anda harus menyertakan salah satu referensi paket NuGet berikut:

Mereferensikan paket Windows App SDK utama (disarankan)
```
<PackageReference Include="Microsoft.WindowsAppSDK"/>
```
Ini akan secara otomatis disertakan Microsoft.WindowsAppSDK.ML sebagai dependensi transitif.

Atau, referensikan Runtime ML dan WindowsAppSDK secara langsung

<PackageReference Include="Microsoft.WindowsAppSDK.ML"/>
<PackageReference Include="Microsoft.WindowsAppSDK.Runtime"/>

Penting

Jika Anda hanya mereferensikan Microsoft.WindowsAppSDK.ML tanpa Microsoft.WindowsAppSDK.Runtime, aplikasi Anda tidak akan berjalan dengan benar.

Python requirements.txt

--index-url https://aiinfra.pkgs.visualstudio.com/PublicPackages/_packaging/ORT-Nightly/pypi/simple
--extra-index-url https://pypi.org/simple
onnxruntime-winml==1.22.0.post2
winrt-runtime==3.2.1
winrt-Windows.Foundation==3.2.1
winrt-Windows.Foundation.Collections==3.2.1
winui3-Microsoft.Windows.AI.MachineLearning==1!1.8.250702007.dev4
winui3-Microsoft.Windows.ApplicationModel.DynamicDependency.Bootstrap==1!1.8.250702007.dev4

Bootstrapper SDK Aplikasi Windows

Bootstrapper Windows App SDK menangani inisialisasi dan pemuatan komponen kerangka kerja Windows App SDK, termasuk Windows ML. Bootstrapper secara otomatis disertakan saat Anda mereferensikan paket NuGet Windows App SDK melalui kombinasi paket Microsoft.WindowsAppSDK.Foundation dan Microsoft.WindowsAppSDK.Runtime.

Sumber daya tambahan

Untuk informasi lebih rinci tentang penyebaran aplikasi Windows App SDK, lihat sumber daya berikut: