Add Apple install orchestrator

[rmarinho]

Apple Install Orchestrator

Adds AppleInstaller, an orchestrator class that drives Apple development environment setup.

What it does

1. Runs EnvironmentChecker.Check() to assess current state
2. Installs Command Line Tools if missing (xcode-select --install)
3. Triggers Xcode first-launch packages (xcodebuild -runFirstLaunch)
4. Downloads simulator runtimes for requested platforms
5. Re-runs environment check to report final state

Supports dryRun mode that reports what would happen without making changes.

Changes

File	Change
Xamarin.MacDev/AppleInstaller.cs	New — orchestrator class
Xamarin.MacDev/CommandLineTools.cs	Add InvalidOperationException catch clauses to GetCommandLineToolsPath and GetVersionFromPkgutil
tests/AppleInstallerTests.cs	New — constructor null-check + macOS dry-run smoke tests

API Surface

public class AppleInstaller {
    public AppleInstaller(ICustomLogger log);
    public EnvironmentCheckResult Install(IEnumerable<string>? requestedPlatforms = null, bool dryRun = false);
}

Review Feedback Addressed

• ✅ @rolfbjarne: No unnecessary whitespace changes to CommandLineTools.cs (only functional catch-clause additions)
• ✅ @rolfbjarne: Dependent PRs (Add runtime management APIs #159, Add environment check APIs #160) now merged — rebased cleanly on main
• ✅ Copilot: xcodeSelectPath uses static readonly instead of const (matches codebase convention)
• ✅ Copilot: DownloadPlatform return value is now checked and logged on failure
• ✅ Copilot: Removed duplicate DeriveStatus tests (already covered by EnvironmentCheckResultTests)
• ✅ Copilot: Unused using System.Linq not present

Tests

• 113 tests pass on both net472 and net10.0
• Constructor null-check test
• 3 macOS-only dry-run smoke tests (no side effects)

Dependencies

• Depends on Add environment check APIs #160 (EnvironmentChecker) ✅ Merged
• Depends on Add runtime management APIs #159 (RuntimeService) ✅ Merged

[rolfbjarne]

Let's wait with this until the dependent pull requests have been merged.

[Copilot]

Pull request overview

This PR adds AppleInstaller, an orchestrator class that drives Apple development environment setup by running EnvironmentChecker, installing missing Command Line Tools, triggering Xcode first-launch packages, and downloading simulator runtimes for requested platforms. It also adds EnvironmentChecker (aggregates results from CommandLineTools, XcodeManager, and RuntimeService) and refactors CommandLineTools.cs to use a file-scoped namespace and adds missing InvalidOperationException catch clauses. Tests are added for both EnvironmentChecker and AppleInstaller.

Changes:

• New Xamarin.MacDev/EnvironmentChecker.cs implementing environment state aggregation, license checking, first-launch, and platform detection
• New Xamarin.MacDev/AppleInstaller.cs orchestrating CLT installation, first-launch, and runtime downloads with dry-run support
• New test files tests/EnvironmentCheckerTests.cs and tests/AppleInstallerTests.cs, plus a namespace+catch-clause fix to CommandLineTools.cs

Reviewed changes

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

Show a summary per file

File	Description
Xamarin.MacDev/EnvironmentChecker.cs	New class: aggregates Xcode, CLT, runtime, and platform checks; exposes IsXcodeLicenseAccepted(), RunFirstLaunch(), and MapPlatformName()
Xamarin.MacDev/AppleInstaller.cs	New class: orchestrates environment setup, delegates to EnvironmentChecker, CommandLineTools, and RuntimeService with dry-run support
Xamarin.MacDev/CommandLineTools.cs	Refactored to file-scoped namespace; added InvalidOperationException catch in GetCommandLineToolsPath and GetVersionFromPkgutil
tests/EnvironmentCheckerTests.cs	10 parameterised tests for MapPlatformName covering all known platform name mappings
tests/AppleInstallerTests.cs	Constructor null-check test + 5 DeriveStatus tests (largely duplicated from EnvironmentCheckResultTests.cs)

---

You can also share your feedback on Copilot code review. Take the survey.

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.