Repository navigation
fix(cli): guide Xcode 27 simulator recovery - #3995
Conversation
|
Warning Review limit reachedYou've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository. Next included review available in 8 minutes. View limit details
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
Merging this PR will not alter performance
Comparing Footnotes
|
|



Summary (AI generated)
When Xcode 27 provides Device Hub but Capacitor's installed
native-runstill expectsSimulator.app, the CLI, doctor, and OTA onboarding now report the incompatibility and provide a manual Xcode launch path. MCP onboarding waits until the user confirms the baseline app is running before proceeding to the OTA test.The check follows the selected Xcode and resolves
native-runfrom the app's installed@capacitor/cli, including hoisted and symlinked installs. It recognizes the upstream package-manager patch and leaves physical-device selection available. CLI help, published usage skills, README, and webdocs include recovery and upgrade guidance.Motivation (AI generated)
Xcode 27 replaced
Simulator.appwith Device Hub. The upstream fix is merged, but as of October 29, 2026, npm still publishesnative-run2.0.3 and Capacitor CLI 8.6.0 still depends on it. There is no released minimum Capacitor version to recommend for this fix yet. Recommending a Capacitor upgrade alone would leave users stuck.Sources: ionic-team/capacitor#8620 and ionic-team/native-run#408.
Business Impact (AI generated)
Users setting up Capgo with a recent Xcode can continue through Xcode or the documented upstream patch instead of repeatedly failing simulator launches. Confirming the baseline app opens prevents onboarding from advancing to an OTA test with no running native app.
Test Plan (AI generated)
bun run --cwd cli lintbun run --cwd cli buildbun run --cwd cli test:mcpbun run --cwd cli test:bundlebun run --cwd cli test:onboarding-run-targets, including 16 compatibility tests and compiled CLI/doctor checksbun run --cwd cli test:mcp-live-update-onboarding, including the manual-launch confirmation gatebun run --cwd cli test:run-device-commandbun run --cwd cli test:doctor-analyticsbun run --cwd cli test:cli-helpgit diff --checkCompatibility coverage uses filesystem fixtures for Xcode applications and installed dependencies. A live Xcode 27 simulator session was not run.
Generated with AI
Need help on this PR? Tag
@codesmith-botwith what you need.