Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Each Microsoft.WindowsAppSDK.ML release includes a copy of the ONNX Runtime, so that your app can depend on an optional shared system-wide copy of the ONNX Runtime rather than distributing your own copy (if you choose framework-dependent deployment). See Install and deploy Windows ML for more details.
Versions of ONNX Runtime in Windows ML
The following table clarifies which ONNX Runtime commit was shipped with Microsoft.WindowsAppSDK.ML (or the Microsoft.Windows.AI.MachineLearning package which shares the same version numbers).
The 2.x versions of the Microsoft.WindowsAppSDK.ML package are currently shipping with ONNX Runtime versions 1.24.x, but might be updated to use 1.25 or greater in the future as new ONNX Runtime releases become available. Only the latest non-preview/experimental release is officially supported.
| Microsoft.WindowsAppSDK.ML version | Microsoft.WindowsAppSDK.ML release date | ONNX Runtime commit hash | ONNX Runtime date |
|---|---|---|---|
2.0.300 |
4/28/2026 | ef605cd (1.24.5) |
4/16/2026 |
2.0.297-preview |
3/31/2026 | 2d92497 (1.24.4) |
3/16/2026 |
2.0.255-experimental |
3/13/2026 | 058787c (1.24.2) |
2/18/2026 |
2.0.175-preview |
2/13/2026 | d7dffa0 (~1.24.0 RC) |
1/23/2026 |
2.0.171-experimental |
2/13/2026 | d5379f5 (~1.24.0) |
12/4/2025 |
2.0.169-experimental |
1/13/2026 | d5379f5 (~1.24.0) |
12/4/2025 |
Automatic updates for framework-dependent apps
If your app uses the framework-dependent version of Windows App SDK, your app will automatically receive updates across the revision version number without re-compiling and updating your app, but not across minor or major versions.
The following table shows how automatic updates work across different Windows App SDK version number changes:
| Version Component | Example Change | Automatic Update? | Description |
|---|---|---|---|
| Revision (x.y.Z) | 1.8.0 → 1.8.1 | ✅ Yes | Bug fixes and patches - automatically applied |
| Revision (x.y.Z) | 1.8.1 → 1.8.2 | ✅ Yes | Bug fixes and patches - automatically applied |
| Minor (x.Y.z) | 1.8.2 → 1.9.0 | ❌ No | Significant update - requires manual update |
| Major (X.y.z) | 1.9.0 → 2.0.0 | ❌ No | Breaking changes - requires manual update |
Version breakdown examples
| App Targets | Latest Available | App Actually Uses | Update Type |
|---|---|---|---|
| 1.8.0 | 1.8.3 | 1.8.3 | ✅ Automatic (revision) |
| 1.8.0 | 1.9.0 | 1.8.3* | ❌ Manual required (minor) |
| 1.8.0 | 2.0.0 | 1.8.3* | ❌ Manual required (major) |
*Latest revision within the same minor version
This means that if you target 1.8.0 of Windows App SDK and 1.8.1 is released, your app will automatically use 1.8.1 (and the corresponding Windows ML ONNX Runtime version). However, when 1.9.0 is released, your app will continue using 1.8.1 until you manually update your app to target 1.9.0.