Support
Supported platforms
Support for each Window host and runtime identifier (RID). Runtime
identifiers that are not listed are unsupported. Run dotnet runic doctor --rid <rid> to check a project against
the same data.
Matrix
Hosts and runtime identifiers
| RID | Runic Desktop | CS-WebUI |
|---|---|---|
linux-x64 | CI-verified | CI-verified |
win-x64 | CI-verified | CI-verified |
osx-arm64 | CI-verified | CI-verified |
linux-arm64 | Packaged, not CI-verified | Packaged, not CI-verified |
linux-musl-x64 | Packaged, not CI-verified | Unsupported |
linux-musl-arm64 | Packaged, not CI-verified | Unsupported |
win-arm64 | Packaged, not CI-verified | Unsupported |
osx-x64 | Packaged, not CI-verified | Packaged, not CI-verified |
- CI-verified
- Runic CI builds and runs the host's native window layer on this RID for changes that affect it.
- Packaged, not CI-verified
- The packages ship native assets for it, but Runic CI does not run it. Test the published application on a real target machine.
- Unsupported
- Runic does not ship the native assets the host needs.
Target machines
Platform requirements
| OS | Host | Requirement | Notes |
|---|---|---|---|
| Windows | Runic Desktop, CS-WebUI | Windows 11, or a Windows 10 release that .NET 10 supports | The .NET 10 supported-OS policy. |
| Windows | Runic Desktop, CS-WebUI | Microsoft Edge WebView2 Runtime | Evergreen runtime; Windows 11 includes it. CS-WebUI uses it only when no Chromium-family browser is installed. |
| macOS | Runic Desktop | macOS 15 or newer | The oldest macOS in the .NET 10 supported-OS policy. WKWebView is part of macOS. |
| macOS | CS-WebUI | macOS 15 or newer | The bundled native library loads on macOS 15 (cs-webui package smoke on macos-15). |
| Linux | CS-WebUI | glibc 2.34 or newer | The CsWebUi.Native Linux library; musl distributions are unsupported. |
| Linux | Runic Desktop, CS-WebUI | GTK 3 and WebKitGTK 4.1 | Runic Desktop's default Linux host, and CS-WebUI's fallback when no Chromium-family browser is installed. |
| Linux | Runic Desktop | GTK 4.12 or newer | With Runic.Desktop.Gtk4. |
| Linux | Runic Desktop | WebKitGTK 6.0 or newer | With Runic.Desktop.Gtk4. |
Details
Targets that CI does not verify
- Runic Desktop,
linux-arm64(Packaged, not CI-verified): Uses the system GTK and WebKitGTK libraries; no arm64 Linux CI runner. - Runic Desktop,
linux-musl-x64(Packaged, not CI-verified): Uses the system GTK and WebKitGTK libraries; no musl CI runner. - Runic Desktop,
linux-musl-arm64(Packaged, not CI-verified): Uses the system GTK and WebKitGTK libraries; no musl CI runner. - Runic Desktop,
win-arm64(Packaged, not CI-verified): Ships the arm64 WebView2 loader; no Windows on Arm CI runner. - Runic Desktop,
osx-x64(Packaged, not CI-verified): Uses the system WKWebView; no Intel macOS CI runner. - CS-WebUI,
linux-arm64(Packaged, not CI-verified): CsWebUi.Native ships a glibc linux-arm64 library; no arm64 Linux CI runner. - CS-WebUI,
linux-musl-x64(Unsupported): CS-WebUI ships no native library for linux-musl-x64; its Linux library needs glibc 2.34 or newer. Publish for a glibc distribution (linux-x64 or linux-arm64), or use the Runic Desktop host. - CS-WebUI,
linux-musl-arm64(Unsupported): CS-WebUI ships no native library for linux-musl-arm64; its Linux library needs glibc 2.34 or newer. Publish for a glibc distribution (linux-x64 or linux-arm64), or use the Runic Desktop host. - CS-WebUI,
win-arm64(Unsupported): CS-WebUI ships no native library for win-arm64. Publish for win-x64, which runs under emulation on Windows on Arm, or use the Runic Desktop host. - CS-WebUI,
osx-x64(Packaged, not CI-verified): CsWebUi.Native ships an osx-x64 library; no Intel macOS CI runner.
Choose a host with the host selection guide. The matrix comes from eng/support.json in the SDK, which also generates the SDK README table and the data that dotnet runic doctor reads.