Expose simulator extras (privacy, appearance, status-bar, openurl, push, location, add-media, screenshot, record-video) via maui apple simulator

[Copilot]

Summary

Exposes 9 new simulator extras commands under maui apple simulator, wrapping the upstream SimulatorService APIs from Xamarin.Apple.Tools.MaciOS:

• privacy grant|revoke|reset — manage app privacy permissions (location, photos, camera, etc.)
• appearance get|light|dark — get/set simulator appearance mode
• status-bar override|clear — override status bar (time, battery, network, etc.)
• openurl — open a URL in the simulator
• push — send a push notification via APNs payload JSON
• location set|clear — set/clear simulated GPS coordinates
• add-media — add photos/videos to the simulator photo library
• screenshot — capture simulator screenshot (png/tiff/bmp/gif/jpeg)
• record-video — record simulator screen (mp4/fmp4)

Changes

• AppleCommands.cs — 9 new command registrations with full --json support
• IAppleProvider.cs / AppleProvider.cs — 13 new provider methods delegating to upstream services
• FakeAppleProvider.cs — test fake with call tracking
• SimulatorEnumParsing.cs — shared token→enum mappers for privacy services, data networks, cell bars, wifi bars, battery state
• MauiCliJsonContext.cs — JSON serialization contexts for new response models
• ErrorCodes.cs — 5 new error codes (E2211–E2215)
• AppleSimulatorCommandsTests.cs — 93 unit tests covering all commands
• apple-cli-smoke-test.sh — updated smoke test script

Fixes Applied During Review

1. appearance refactored to subcommands — changed from appearance <mode> <udid> (positional args) to appearance get|light|dark <udid> (proper subcommands), consistent with all other simulator commands
2. location set negative longitude — Argument<double> failed to parse -122.009 (System.CommandLine interpreted -1 as option flag). Fixed with Argument<string> + manual double.TryParse using InvariantCulture
3. record-video JSON signal — now emits {"status":"recording",...} before the blocking wait, so JSON consumers know recording started
4. TryParseDataNetwork comment — added explanatory comment about + token survival through Normalize()

Local Testing (macOS, iPhone 17 Pro simulator)

All commands tested successfully on a booted simulator:

=== appearance get ===
{ "udid": "55A9D63B-...", "appearance": "light", "action": "get" }

=== appearance dark ===
{ "udid": "55A9D63B-...", "appearance": "dark", "action": "set" }

=== appearance get (verify dark) ===
{ "udid": "55A9D63B-...", "appearance": "dark", "action": "get" }

=== appearance light (restore) ===
{ "udid": "55A9D63B-...", "appearance": "light", "action": "set" }

=== openurl ===
{ "udid": "55A9D63B-...", "url": "https://dotnet.microsoft.com", "success": true }

=== location set (negative longitude) ===
{ "udid": "55A9D63B-...", "action": "set", "latitude": 37.3349, "longitude": -122.00902, "success": true }

=== location clear ===
{ "udid": "55A9D63B-...", "action": "clear", "success": true }

=== status-bar override --time "9:41" ===
{ "udid": "55A9D63B-...", "action": "override", "success": true }

=== status-bar clear ===
{ "udid": "55A9D63B-...", "action": "clear", "success": true }

=== screenshot (png, 363KB) ===
{ "udid": "55A9D63B-...", "output_path": "/tmp/sim_screenshot.png", "format": "png", "success": true }

Unit Tests

93/93 tests passing:

dotnet test src/Cli/Microsoft.Maui.Cli.UnitTests/ --filter "FullyQualifiedName~AppleSimulatorCommands"
Passed! - Failed: 0, Passed: 93, Skipped: 0

[Copilot]

Pull request overview

Adds new “simulator extras” commands under maui apple simulator, exposing additional xcrun simctl-backed functionality via Xamarin.Apple.Tools.MaciOS and extending JSON output + tests accordingly.

Changes:

• Adds 9 new maui apple simulator subcommands (privacy, appearance, status-bar, openurl, push, location, add-media, screenshot, record-video).
• Extends IAppleProvider/AppleProvider and introduces shared enum/token parsing for simulator-related options.
• Adds JSON output models + source-gen context registrations and expands unit/smoke-test coverage.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/Cli/Microsoft.Maui.Cli/Providers/Apple/SimulatorEnumParsing.cs	New shared token→enum parsing helpers for simulator commands.
src/Cli/Microsoft.Maui.Cli/Providers/Apple/IAppleProvider.cs	Extends provider interface with simulator extras operations.
src/Cli/Microsoft.Maui.Cli/Providers/Apple/AppleProvider.cs	Implements new simulator extras operations via SimulatorService.
src/Cli/Microsoft.Maui.Cli/Output/MauiCliJsonContext.cs	Registers new simulator extras JSON models for source-gen serialization.
src/Cli/Microsoft.Maui.Cli/Output/JsonOutputModels.cs	Adds JSON result records for new simulator extras commands.
src/Cli/Microsoft.Maui.Cli/Errors/ErrorCodes.cs	Adds new error codes for simulator extras failures.
src/Cli/Microsoft.Maui.Cli/DevFlow/DevFlowCommands.cs	Updates DevFlow permission flow to use shared parsing + provider privacy API.
src/Cli/Microsoft.Maui.Cli/Commands/AppleCommands.cs	Adds command handlers for simulator extras subcommands.
src/Cli/Microsoft.Maui.Cli.UnitTests/Fakes/FakeAppleProvider.cs	Extends test fake with new APIs + call tracking.
src/Cli/Microsoft.Maui.Cli.UnitTests/AppleSimulatorCommandsTests.cs	Adds unit coverage for command tree, parsing, JSON models, and handler behavior.
plugins/dotnet-maui/skills/maui-devflow-debug/references/ios-and-mac.md	Documents new maui apple simulator … wrappers vs raw simctl.
eng/smoke-tests/apple-cli-smoke-test.sh	Extends smoke tests to cover new simulator extras commands.

[jfversluis]

This option currently exposes formats that simctl recordVideo no longer accepts. The MacDev wrapper maps RecordingOptions.Format to xcrun simctl io <udid> recordVideo --type=<value>, but current simctl io help only supports recordVideo [--codec=h264|hevc]; it does not accept --type, mp4, fmp4, or gif. As a result, any invocation with --format will cause simctl to exit immediately, while StartRecording() can still return a process handle and this command will wait for Ctrl-C before reporting success.

Can we switch this surface to a --codec h264|hevc option or update the provider/package to emit --codec=... and reject unsupported values? It would also be good to detect early simctl process exit before blocking/reporting success.