Skip to content

[net10.0] [dotnet] Add a way to get help with how apps are launched on mobile. #22858

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
rolfbjarne merged 1 commit into from
May 21, 2025
Merged

[net10.0] [dotnet] Add a way to get help with how apps are launched on mobile. #22858

rolfbjarne merged 1 commit into from
May 21, 2025

Conversation

@rolfbjarne
Copy link
Member

@rolfbjarne rolfbjarne commented May 20, 2025

There are two ways:

dotnet build /t:ShowRunHelp

or

dotnet run -p:ShowRunHelp=true

either way results in something like this:

To run on physical device:
1. If the project has multiple target frameworks, select the desired target framework. Example: -f net10.0-ios
2. Pass a RuntimeIdentifier for a device. Example: -p:ios-arm64
3. Pass the name or identifier of the target device using '-p:DeviceName='
There are 3 device(s) connected to this Mac that can be used to run this app:
Rolf's iPad Pro 3rd Gen (00008027-00187158020A002E)
Rolf's iPhone 13 (00008110-000568491A92801E)
Rolf's iPhone 15 (00008130-0008490A3A12001C)
Example: -p:DeviceName=00008027-00187158020A002E or -p:DeviceName='Rolf's iPad Pro 3rd Gen'
For example:
dotnet run -f net10.0-ios -r ios-arm64 -p:DeviceName=00008027-00187158020A002E

To run in a simulator:
1. If the project has multiple target frameworks, select the desired target framework. Exmaple: -f net10.0-ios
2. Pass the name or identifier of the target simulator using '-p:DeviceName='
There are 27 simulators(s) on this Mac that can be used to run this app:
iPhone 15 Pro (026EF893-4F22-4504-BD82-CBDF3B86C01A)
iPhone 15 Pro Max (9E089019-5278-4CF2-93F6-AEB2F5061E1E)
iPhone 15 (79A76C51-F47A-44FA-B7EB-CFA6EEC1F1D7)
iPhone 15 Plus (E3934E95-D90A-455F-8D60-315BECC8DF1D)
iPhone SE (3rd generation) (A3D0D0CE-B8EB-406C-82AB-F60763161350)
iPhone 11 - iOS 17.5 (292B1EB1-6F98-4B66-8149-05976837C9A9)
iPhone 16 Pro (5FCFB2B7-0666-41B3-83E4-79021E8E99C2)
iPhone 16 Pro Max (02C48657-7A45-44BC-B45E-86204ACBD0D4)
iPhone 16 (4D709EA4-AAEA-4F8C-930F-9F0302346116)
iPhone 16 Plus (F2461C9F-DC53-4006-99D7-3B519C3A9791)
iPhone 14 (iOS 18.2) - created by XHarness (4FB93AD4-920A-4F7B-A7CD-8729FBE0F272)
iPhone SE (3rd generation) (D33018A8-BF65-429C-B060-CF562172CDE1)
iPhone 11 - iOS 18.2 (A91E6E62-554A-4441-A2B8-428E6D67AA7F)
iPhone 16 Pro (4DC76B0B-96A5-4868-9128-AEFFE8B8BBE5)
iPhone 16 Pro Max (A822A13B-03A5-4CB0-AD91-2F2072B1FB48)
iPhone 16e (53A397E9-2A11-4C89-9199-7E97181C7203)
iPhone 16 (31A707F5-FA6B-4475-AC17-66589A2486D6)
iPhone 16 Plus (9FD47A7D-5259-4303-A68C-7A40728C1690)
iPhone SE (3rd generation) (4DF703CC-1FB4-4572-9A93-C8BFC50B8ABF)
iPhone 11 - iOS 18.3 (41925928-ADF3-4E3C-8342-ECA518DD2696)
iPhone 16 Pro (AEA667DF-88DA-477F-892B-3C5917CC766A)
iPhone 16 Pro Max (96BD6EDE-3755-42F7-97A1-D3398ECF687F)
iPhone 16e (D7C1B5F6-B961-453C-806A-AF426B8AE468)
iPhone 16 (2A7EE827-1CC0-4E2C-9FB9-A0689AACB357)
iPhone 16 Plus (785DCF94-AA85-4325-9883-6390440CDAE1)
iPhone SE (3rd generation) (1C100C34-6FF1-45C0-A4CC-1C6416522326)
iPhone 11 - iOS 18.4 (BF08B70D-BAB1-47E4-BA3C-2A6FF9EDC5AC)
Example: -p:DeviceName=026EF893-4F22-4504-BD82-CBDF3B86C01A or -p:DeviceName='iPhone 15 Pro'
For example:
dotnet run -f net10.0-ios -p:DeviceName=026EF893-4F22-4504-BD82-CBDF3B86C01A

@rolfbjarne
[dotnet] Add a way to get help with how apps are launched on mobile.
a5ed712 
There are two ways:

> dotnet build /t:ShowRunHelp

or

> dotnet run -p:ShowRunHelp=true

either way results in something like this:

  To run on physical device:
      1. If the project has multiple target frameworks, select the desired target framework. Example: -f net10.0-ios
      2. Pass a RuntimeIdentifier for a device. Example: -p:ios-arm64
      3. Pass the name or identifier of the target device using '-p:DeviceName=<name or identifier of device>'
          There are 3 device(s) connected to this Mac that can be used to run this app:
              Rolf's iPad Pro 3rd Gen (00008027-00187158020A002E)
              Rolf's iPhone 13 (00008110-000568491A92801E)
              Rolf's iPhone 15 (00008130-0008490A3A12001C)
          Example: -p:DeviceName=00008027-00187158020A002E or -p:DeviceName='Rolf\'s iPad Pro 3rd Gen'
      For example:
          dotnet run -f net10.0-ios -r ios-arm64 -p:DeviceName=00008027-00187158020A002E

  To run in a simulator:
      1. If the project has multiple target frameworks, select the desired target framework. Exmaple: -f net10.0-ios
      2. Pass the name or identifier of the target simulator using '-p:DeviceName=<name or identifier of simulator>'
          There are 27 simulators(s) on this Mac that can be used to run this app:
              iPhone 15 Pro (026EF893-4F22-4504-BD82-CBDF3B86C01A)
              iPhone 15 Pro Max (9E089019-5278-4CF2-93F6-AEB2F5061E1E)
              iPhone 15 (79A76C51-F47A-44FA-B7EB-CFA6EEC1F1D7)
              iPhone 15 Plus (E3934E95-D90A-455F-8D60-315BECC8DF1D)
              iPhone SE (3rd generation) (A3D0D0CE-B8EB-406C-82AB-F60763161350)
              iPhone 11 - iOS 17.5 (292B1EB1-6F98-4B66-8149-05976837C9A9)
              iPhone 16 Pro (5FCFB2B7-0666-41B3-83E4-79021E8E99C2)
              iPhone 16 Pro Max (02C48657-7A45-44BC-B45E-86204ACBD0D4)
              iPhone 16 (4D709EA4-AAEA-4F8C-930F-9F0302346116)
              iPhone 16 Plus (F2461C9F-DC53-4006-99D7-3B519C3A9791)
              iPhone 14 (iOS 18.2) - created by XHarness (4FB93AD4-920A-4F7B-A7CD-8729FBE0F272)
              iPhone SE (3rd generation) (D33018A8-BF65-429C-B060-CF562172CDE1)
              iPhone 11 - iOS 18.2 (A91E6E62-554A-4441-A2B8-428E6D67AA7F)
              iPhone 16 Pro (4DC76B0B-96A5-4868-9128-AEFFE8B8BBE5)
              iPhone 16 Pro Max (A822A13B-03A5-4CB0-AD91-2F2072B1FB48)
              iPhone 16e (53A397E9-2A11-4C89-9199-7E97181C7203)
              iPhone 16 (31A707F5-FA6B-4475-AC17-66589A2486D6)
              iPhone 16 Plus (9FD47A7D-5259-4303-A68C-7A40728C1690)
              iPhone SE (3rd generation) (4DF703CC-1FB4-4572-9A93-C8BFC50B8ABF)
              iPhone 11 - iOS 18.3 (41925928-ADF3-4E3C-8342-ECA518DD2696)
              iPhone 16 Pro (AEA667DF-88DA-477F-892B-3C5917CC766A)
              iPhone 16 Pro Max (96BD6EDE-3755-42F7-97A1-D3398ECF687F)
              iPhone 16e (D7C1B5F6-B961-453C-806A-AF426B8AE468)
              iPhone 16 (2A7EE827-1CC0-4E2C-9FB9-A0689AACB357)
              iPhone 16 Plus (785DCF94-AA85-4325-9883-6390440CDAE1)
              iPhone SE (3rd generation) (1C100C34-6FF1-45C0-A4CC-1C6416522326)
              iPhone 11 - iOS 18.4 (BF08B70D-BAB1-47E4-BA3C-2A6FF9EDC5AC)
          Example: -p:DeviceName=026EF893-4F22-4504-BD82-CBDF3B86C01A or -p:DeviceName='iPhone 15 Pro'
      For example:
          dotnet run -f net10.0-ios -p:DeviceName=026EF893-4F22-4504-BD82-CBDF3B86C01A
@rolfbjarne rolfbjarne requested review from emaf and mauroa as code owners May 20, 2025 18:52
@vs-mobiletools-engineering-service2
Copy link
Collaborator

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

✅ [CI Build #a5ed712] Build passed (Build packages) ✅

Pipeline on Agent
Hash: a5ed7120a061528e3c881f41e63f0108a8b7df2b [PR build]

@vs-mobiletools-engineering-service2
Copy link
Collaborator

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

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

Pipeline on Agent
Hash: a5ed7120a061528e3c881f41e63f0108a8b7df2b [PR build]

@vs-mobiletools-engineering-service2
Copy link
Collaborator

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

✅ API diff for current PR / commit

.NET ( No breaking changes )

✅ API diff vs stable

.NET ( No breaking changes )

ℹ️ Generator diff

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

Pipeline on Agent
Hash: a5ed7120a061528e3c881f41e63f0108a8b7df2b [PR build]

@vs-mobiletools-engineering-service2
Copy link
Collaborator

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

✅ [CI Build #a5ed712] Build passed (Build macOS tests) ✅

Pipeline on Agent
Hash: a5ed7120a061528e3c881f41e63f0108a8b7df2b [PR build]

@vs-mobiletools-engineering-service2

This comment has been minimized.

Sign in to view
@vs-mobiletools-engineering-service2
Copy link
Collaborator

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

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

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

Pipeline on Agent
Hash: a5ed7120a061528e3c881f41e63f0108a8b7df2b [PR build]

@vs-mobiletools-engineering-service2
Copy link
Collaborator

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

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

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

Pipeline on Agent
Hash: a5ed7120a061528e3c881f41e63f0108a8b7df2b [PR build]

@vs-mobiletools-engineering-service2
Copy link
Collaborator

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

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

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

Pipeline on Agent
Hash: a5ed7120a061528e3c881f41e63f0108a8b7df2b [PR build]

@vs-mobiletools-engineering-service2

This comment has been minimized.

Sign in to view
@vs-mobiletools-engineering-service2
Copy link
Collaborator

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

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

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

Pipeline on Agent
Hash: a5ed7120a061528e3c881f41e63f0108a8b7df2b [PR build]

@vs-mobiletools-engineering-service2
Copy link
Collaborator

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

🚀 [CI Build #a5ed712] Test results 🚀

Test results

✅ All tests passed on VSTS: test results.

🎉 All 126 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 8 tests passed. Html Report (VSDrops) Download
✅ monotouch (MacCatalyst): All 15 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: a5ed7120a061528e3c881f41e63f0108a8b7df2b [PR build]

dalexsoto
dalexsoto approved these changes May 21, 2025
View reviewed changes
Copy link
Member

@dalexsoto dalexsoto left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Loving this!! Very welcome change!!

@rolfbjarne rolfbjarne merged commit df2d461 into net10.0 May 21, 2025
44 checks passed
@rolfbjarne rolfbjarne deleted the dev/rolf/dotnet-run-help branch May 21, 2025 14:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@dalexsoto dalexsoto dalexsoto approved these changes

@emaf emaf emaf approved these changes

@mauroa mauroa Awaiting requested review from mauroa mauroa is a code owner

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@rolfbjarne @vs-mobiletools-engineering-service2 @dalexsoto @emaf