[net10.0] [dotnet] Use the 'ComputeRunArguments' target to compute properties for 'dotnet run'. #22816

rolfbjarne · 2025-05-16T07:03:02Z

In .NET 10 there's a new target we can hook into ("ComputeRunArguments") to do anything
we need to do before 'dotnet run' runs the target app.

For mobile (iOS and tvOS), we now run the "_PrepareRunMobile" target before "ComputeRunArguments",
and this will:

Install the app on device for device builds.
Run mlaunch to run launch the app on device or in the simulator.

For desktop (macOS and Mac Catalyst), we run the new "_PrepareRunDesktop" target
before "ComputeRunArguments" to set the RunCommand and RunArguments properties.
I've also added the capability to not launch apps on desktop with open, by setting
the property RunWithOpen=false.

Also add support for passing arguments to the app when running on iOS and tvOS (by
passing '-- <extra args' to mlaunch).

Fixes #12459.
Fixes #14845.

References:

…or 'dotnet run'. In .NET 10 there's a new target we can hook into ("ComputeRunArguments") to do anything we need to do before 'dotnet run' runs the target app. For mobile (iOS and tvOS), we now run the "_PrepareRunMobile" target before "ComputeRunArguments", and this will: * Install the app on device for device builds. * Run mlaunch to run launch the app on device or in the simulator. For desktop (macOS and Mac Catalyst), we run the new "_PrepareRunDesktop" target before "ComputeRunArguments" to set the `RunCommand` and `RunArguments` properties. I've also added the capability to _not_ launch apps on desktop with `open`, by setting the property `RunWithOpen=false`. Also add support for passing arguments to the app when running on iOS and tvOS (by passing '-- <extra args' to mlaunch). Fixes #12459. Fixes #14845. References: * dotnet/sdk#42155 * dotnet/android#9470

docs/building-apps/build-properties.md

dalexsoto · 2025-05-16T11:22:50Z

docs/building-apps/build-properties.md

+$ dotnet run -p:OpenNewInstance=false
+```
+
+### RunEnvironment


What about SetRunEnviromentVars or SetRunEnviromentArgs or SetEnviromentVars or SetEnviromentArgs? RunEnviroment seems easy to clash just like the case we had with NativeLibrary just my 2 cents, naming is hard heh

I removed this option completely, it's possible to do the same thing with the OpenArguments property, so document that instead.

vs-mobiletools-engineering-service2 · 2025-05-20T07:09:36Z

✅ [CI Build #783ffc0] Build passed (Build packages) ✅

Pipeline on Agent
Hash: 783ffc0142151c7faaeedad5125868e985790ea5 [PR build]

vs-mobiletools-engineering-service2 · 2025-05-20T07:11:37Z

✅ [PR Build #783ffc0] Build passed (Detect API changes) ✅

Pipeline on Agent
Hash: 783ffc0142151c7faaeedad5125868e985790ea5 [PR build]

vs-mobiletools-engineering-service2 · 2025-05-20T07:48:39Z

✅ API diff for current PR / commit

.NET ( No breaking changes )

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 ( No breaking changes )

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: 783ffc0142151c7faaeedad5125868e985790ea5 [PR build]

vs-mobiletools-engineering-service2 · 2025-05-20T08:56:30Z

✅ [CI Build #783ffc0] Build passed (Build macOS tests) ✅

Pipeline on Agent
Hash: 783ffc0142151c7faaeedad5125868e985790ea5 [PR build]

vs-mobiletools-engineering-service2 · 2025-05-20T09:07:41Z

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

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

Pipeline on Agent
Hash: 783ffc0142151c7faaeedad5125868e985790ea5 [PR build]

vs-mobiletools-engineering-service2 · 2025-05-20T09:09:15Z

💻 [CI Build #783ffc0] Tests on macOS M1 - Mac Monterey (12) passed 💻

✅ All tests on macOS M1 - Mac Monterey (12) passed.

Pipeline on Agent
Hash: 783ffc0142151c7faaeedad5125868e985790ea5 [PR build]

vs-mobiletools-engineering-service2 · 2025-05-20T09:10:22Z

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

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

Pipeline on Agent
Hash: 783ffc0142151c7faaeedad5125868e985790ea5 [PR build]

vs-mobiletools-engineering-service2 · 2025-05-20T09:10:49Z

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

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

Pipeline on Agent
Hash: 783ffc0142151c7faaeedad5125868e985790ea5 [PR build]

vs-mobiletools-engineering-service2 · 2025-05-20T11:47:05Z

🚀 [CI Build #783ffc0] Test results 🚀

Test results

✅ All tests passed on VSTS: test results.

🎉 All 124 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. 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 6 tests passed. Html Report (VSDrops) Download
✅ linker: All 44 tests passed. Html Report (VSDrops) Download
✅ monotouch (iOS): All 10 tests passed. Html Report (VSDrops) Download
✅ monotouch (MacCatalyst): All 11 tests passed. [attempt 2] Html Report (VSDrops) Download
✅ monotouch (macOS): All 12 tests passed. Html Report (VSDrops) Download
✅ monotouch (tvOS): All 10 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: 783ffc0142151c7faaeedad5125868e985790ea5 [PR build]

This comment has been minimized.

Sign in to view

dalexsoto requested changes May 16, 2025

View reviewed changes

Just use OpenArguments.

3d7efb4

This was linked to issues May 19, 2025

Add proper support for 'dotnet run' for mobile targets #12459

Closed

.NET: add support for passing arguments to mobile apps at launch #14845

Closed

This comment has been minimized.

Sign in to view

Merge remote-tracking branch 'origin/net10.0' into dev/rolf/dotnet-run

783ffc0

dalexsoto approved these changes May 20, 2025

View reviewed changes

This comment has been minimized.

Sign in to view

rolfbjarne merged commit df02b01 into net10.0 May 20, 2025
44 checks passed

rolfbjarne deleted the dev/rolf/dotnet-run branch May 20, 2025 11:57

[net10.0] [dotnet] Use the 'ComputeRunArguments' target to compute properties for 'dotnet run'. #22816

[net10.0] [dotnet] Use the 'ComputeRunArguments' target to compute properties for 'dotnet run'. #22816

Uh oh!

Conversation

rolfbjarne commented May 16, 2025

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.

Uh oh!

Uh oh!

dalexsoto May 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rolfbjarne May 19, 2025

Choose a reason for hiding this comment

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.

vs-mobiletools-engineering-service2 commented May 20, 2025

✅ [CI Build #783ffc0] Build passed (Build packages) ✅

Uh oh!

vs-mobiletools-engineering-service2 commented May 20, 2025

✅ [PR Build #783ffc0] Build passed (Detect API changes) ✅

Uh oh!

vs-mobiletools-engineering-service2 commented May 20, 2025

✅ API diff for current PR / commit

✅ API diff vs stable

ℹ️ Generator diff

Uh oh!

vs-mobiletools-engineering-service2 commented May 20, 2025

✅ [CI Build #783ffc0] Build passed (Build macOS tests) ✅

Uh oh!

vs-mobiletools-engineering-service2 commented May 20, 2025

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

Uh oh!

vs-mobiletools-engineering-service2 commented May 20, 2025

💻 [CI Build #783ffc0] Tests on macOS M1 - Mac Monterey (12) passed 💻

Uh oh!

vs-mobiletools-engineering-service2 commented May 20, 2025

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

Uh oh!

vs-mobiletools-engineering-service2 commented May 20, 2025

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

Uh oh!

This comment has been minimized.

vs-mobiletools-engineering-service2 commented May 20, 2025

🚀 [CI Build #783ffc0] Test results 🚀

Test results

Tests counts

Uh oh!

Uh oh!

Uh oh!

dalexsoto May 16, 2025 •

edited

Loading