[dotnet] Add support for ReadyToRun. #24437

rolfbjarne · 2025-12-12T17:47:18Z

Description

This PR adds ReadyToRun support for CoreCLR.

Changes

Introduce ReadyToRun configuration in Xamarin.Shared.Sdk.props.
Add ReadyToRun targets to Microsoft.Shared.R2R.targets (a new file).
Update bundler environment variables in Xamarin.Shared.Sdk.targets to support ReadyToRun
Add host_runtime_contract.h to the build process in Makefile
Update coreclr-bridge.m and runtime.m for R2R image handling and logging
Update runtime.h to reflect changes in the xamarin_pinvoke_override function signature
Add support in the CompileAppManifest target to create the Info.plist for frameworks.
Enable CoreCLR tests run R2R.
Add a test variation for CoreCLR for the app size test.

Fixes dotnet/runtime#120052.

Copilot

Pull request overview

This PR adds ReadyToRun (R2R) support for CoreCLR on Apple mobile platforms (iOS, tvOS). ReadyToRun is an ahead-of-time (AOT) compilation technology that improves app startup performance by pre-compiling managed assemblies to native code. The implementation involves integrating CoreCLR's R2R infrastructure through a new host runtime contract interface, generating composite R2R images into frameworks or dynamic libraries, and enabling the feature by default for non-macOS CoreCLR builds.

Key Changes

Added infrastructure to pass PublishReadyToRun configuration through the build pipeline
Implemented native code integration for R2R via the host_runtime_contract interface
Created MSBuild targets to build R2R composite images and link them into frameworks or dylibs
Removed libclrjit.dylib dependency when R2R is enabled (replaced with R2R interpretation)

Reviewed changes

Copilot reviewed 17 out of 18 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
tools/dotnet-linker/LinkerConfiguration.cs	Adds parsing for PublishReadyToRun configuration property
tools/common/Target.cs	Generates extern declarations for RTR_HEADER symbol in generated main.m file
tools/common/Application.cs	Adds PublishReadyToRun nullable boolean property to Application class
runtime/xamarin/runtime.h	Changes xamarin_pinvoke_override return type to const void*
runtime/xamarin/main.h	Declares xamarin_rtr_header global variable
runtime/runtime.m	Implements R2R integration via host_runtime_contract and adds dyld image size calculation
runtime/coreclr-bridge.m	Fixes logging bug where wrong variable was being accessed
runtime/Makefile	Updates to download host_runtime_contract.h header from dotnet/runtime
runtime/.gitignore	Ignores the downloaded host_runtime_contract.h file
msbuild/Xamarin.MacDev.Tasks/Tasks/CompileAppManifest.cs	Adds IsFramework property and CFBundlePackageType support for frameworks
dotnet/targets/Xamarin.Shared.Sdk.targets	Passes PublishReadyToRun to linker, removes libclrjit.dylib, imports R2R targets
dotnet/targets/Xamarin.Shared.Sdk.props	Sets R2R as default for CoreCLR mobile builds, adds environment variable fallback
dotnet/targets/Microsoft.Sdk.R2R.targets	New file implementing R2R composite image building and framework/dylib creation
dotnet/Makefile	Includes new Microsoft.Sdk.R2R.targets in SDK package
tests/dotnet/UnitTests/AppSizeTest.cs	Removes test ignore attribute and fixes assertion message logic
tests/dotnet/UnitTests/expected/iOS-CoreCLR-R2R-size.txt	New baseline for R2R app sizes
tests/dotnet/UnitTests/expected/iOS-CoreCLR-Interpreter-size.txt	Updated baseline reflecting removal of libclrjit.dylib

dotnet/targets/Microsoft.Sdk.R2R.targets

runtime/runtime.m

tools/common/Target.cs

dotnet/targets/Microsoft.Sdk.R2R.targets

vs-mobiletools-engineering-service2 · 2025-12-15T19:57:37Z

💻 [CI Build #55f9501] Tests on macOS M1 - Mac Ventura (13) passed 💻

✅ All tests on macOS M1 - Mac Ventura (13) passed.

Pipeline on Agent
Hash: 55f95010f0e7d43d3303265aa29fff58fd313896 [PR build]

…e're in Release.

vs-mobiletools-engineering-service2 · 2026-01-14T12:16:22Z

✅ [CI Build #09ce0a5] Build passed (Build packages) ✅

Pipeline on Agent
Hash: 09ce0a526dcea397ef8456afe51e4332af6d5cf0 [PR build]

vs-mobiletools-engineering-service2 · 2026-01-14T12:42:56Z

✅ [PR Build #09ce0a5] Build passed (Detect API changes) ✅

Pipeline on Agent
Hash: 09ce0a526dcea397ef8456afe51e4332af6d5cf0 [PR build]

vs-mobiletools-engineering-service2 · 2026-01-14T12:51:07Z

✅ [CI Build #09ce0a5] Build passed (Build macOS tests) ✅

Pipeline on Agent
Hash: 09ce0a526dcea397ef8456afe51e4332af6d5cf0 [PR build]

vs-mobiletools-engineering-service2 · 2026-01-14T13:00:29Z

💻 [CI Build #09ce0a5] Tests on macOS X64 - Mac Sonoma (14) passed 💻

✅ All tests on macOS X64 - Mac Sonoma (14) passed.

Pipeline on Agent
Hash: 09ce0a526dcea397ef8456afe51e4332af6d5cf0 [PR build]

vs-mobiletools-engineering-service2 · 2026-01-14T13:06:00Z

💻 [CI Build #09ce0a5] Tests on macOS arm64 - Mac Sequoia (15) passed 💻

✅ All tests on macOS arm64 - Mac Sequoia (15) passed.

Pipeline on Agent
Hash: 09ce0a526dcea397ef8456afe51e4332af6d5cf0 [PR build]

vs-mobiletools-engineering-service2 · 2026-01-14T13:33:01Z

✅ API diff for current PR / commit

NET (empty diffs)

iOS: vsdrops gist ( No breaking changes )
tvOS: vsdrops gist ( No breaking changes )
MacCatalyst: vsdrops gist ( No breaking changes )
macOS: vsdrops gist ( No breaking changes )

✅ API diff vs stable

NET (empty diffs)

iOS: vsdrops gist ( No breaking changes )
tvOS: vsdrops gist ( No breaking changes )
MacCatalyst: vsdrops gist ( No breaking changes )
macOS: vsdrops gist ( No breaking changes )

ℹ️ Generator diff

Generator Diff: vsdrops (html) vsdrops (raw diff) gist (raw diff) - Please review changes)

Pipeline on Agent
Hash: 09ce0a526dcea397ef8456afe51e4332af6d5cf0 [PR build]

vs-mobiletools-engineering-service2 · 2026-01-14T13:47:42Z

💻 [CI Build #09ce0a5] Tests on macOS arm64 - Mac Tahoe (26) passed 💻

✅ All tests on macOS arm64 - Mac Tahoe (26) passed.

Pipeline on Agent
Hash: 09ce0a526dcea397ef8456afe51e4332af6d5cf0 [PR build]

vs-mobiletools-engineering-service2 · 2026-01-14T17:18:53Z

🚀 [CI Build #09ce0a5] Test results 🚀

Test results

✅ All tests passed on VSTS: test results.

🎉 All 123 tests passed 🎉

Tests counts

✅ cecil: All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (iOS): All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (MacCatalyst): All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (macOS): All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (Multiple platforms): All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (tvOS): All 1 tests passed. Html Report (VSDrops) Download
✅ framework: All 2 tests passed. Html Report (VSDrops) Download
✅ fsharp: All 4 tests passed. [attempt 2] Html Report (VSDrops) Download
✅ generator: All 5 tests passed. Html Report (VSDrops) Download
✅ interdependent-binding-projects: All 4 tests passed. Html Report (VSDrops) Download
✅ introspection: All 4 tests passed. Html Report (VSDrops) Download
✅ linker: All 44 tests passed. Html Report (VSDrops) Download
✅ monotouch (iOS): All 9 tests passed. Html Report (VSDrops) Download
✅ monotouch (MacCatalyst): All 17 tests passed. Html Report (VSDrops) Download
✅ monotouch (macOS): All 9 tests passed. Html Report (VSDrops) Download
✅ monotouch (tvOS): All 9 tests passed. Html Report (VSDrops) Download
✅ msbuild: All 2 tests passed. Html Report (VSDrops) Download
✅ windows: All 3 tests passed. Html Report (VSDrops) Download
✅ xcframework: All 4 tests passed. Html Report (VSDrops) Download
✅ xtro: All 1 tests passed. Html Report (VSDrops) Download

Pipeline on Agent
Hash: 09ce0a526dcea397ef8456afe51e4332af6d5cf0 [PR build]

kotlarmilos

LGTM, thanks!

rolfbjarne requested a review from Copilot December 12, 2025 17:47

Copilot started reviewing on behalf of rolfbjarne December 12, 2025 17:47 View session

Copilot AI reviewed Dec 12, 2025

View reviewed changes

rolfbjarne force-pushed the dev/rolf/coreclr-r2r branch from 5d67786 to 270a76b Compare December 12, 2025 18:08

This comment has been minimized.

Sign in to view

kotlarmilos and others added 3 commits January 14, 2026 12:26

[dotnet] Exclude user assemblies from ReadyToRun compilation unless w…

f7b4957

…e're in Release.

[xharness] Add missing flags for a few CoreCLR variations.

33cafbb

[tests] Enable ReadyToRun app size test.

09ce0a5

rolfbjarne force-pushed the dev/rolf/coreclr-r2r branch from cee6af5 to 09ce0a5 Compare January 14, 2026 11:47

This comment has been minimized.

Sign in to view

kotlarmilos self-requested a review January 15, 2026 09:04

kotlarmilos approved these changes Jan 15, 2026

View reviewed changes

mauroa approved these changes Jan 15, 2026

View reviewed changes

rolfbjarne merged commit 3a2ccef into net11.0 Jan 15, 2026
43 checks passed

rolfbjarne mentioned this pull request Jan 15, 2026

[clr-ios] Update iOS SDK build to use R2R for startup path dotnet/runtime#120052

Closed

7 tasks

[dotnet] Add support for ReadyToRun. #24437

[dotnet] Add support for ReadyToRun. #24437

Uh oh!

Conversation

rolfbjarne commented Dec 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Changes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Key Changes

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

vs-mobiletools-engineering-service2 commented Dec 15, 2025

💻 [CI Build #55f9501] Tests on macOS M1 - Mac Ventura (13) passed 💻

Uh oh!

This comment has been minimized.

vs-mobiletools-engineering-service2 commented Jan 14, 2026

✅ [CI Build #09ce0a5] Build passed (Build packages) ✅

Uh oh!

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

vs-mobiletools-engineering-service2 commented Jan 14, 2026

✅ [PR Build #09ce0a5] Build passed (Detect API changes) ✅

Uh oh!

vs-mobiletools-engineering-service2 commented Jan 14, 2026

✅ [CI Build #09ce0a5] Build passed (Build macOS tests) ✅

Uh oh!

vs-mobiletools-engineering-service2 commented Jan 14, 2026

💻 [CI Build #09ce0a5] Tests on macOS X64 - Mac Sonoma (14) passed 💻

Uh oh!

vs-mobiletools-engineering-service2 commented Jan 14, 2026

💻 [CI Build #09ce0a5] Tests on macOS arm64 - Mac Sequoia (15) passed 💻

Uh oh!

vs-mobiletools-engineering-service2 commented Jan 14, 2026

✅ API diff for current PR / commit

✅ API diff vs stable

ℹ️ Generator diff

Uh oh!

vs-mobiletools-engineering-service2 commented Jan 14, 2026

💻 [CI Build #09ce0a5] Tests on macOS arm64 - Mac Tahoe (26) passed 💻

Uh oh!

This comment has been minimized.

vs-mobiletools-engineering-service2 commented Jan 14, 2026

🚀 [CI Build #09ce0a5] Test results 🚀

Test results

rolfbjarne commented Dec 12, 2025 •

edited

Loading