Update Xcode setup in iOS deployment workflow

[davidmfinol]

Changes

• Per final comment at the end of [macos-15] iOS build fails on CI due to incorrect SDK targeting actions/runner-images#12758

Checklist

• Read the contribution guide and accept the
  code of conduct
• Readme (updated or not needed)
• Tests (added, updated or not needed)

Summary by CodeRabbit

• Documentation
  • Updated iOS deployment guide for GitHub Actions to automate Xcode selection, relocate the iOS platform download to the build step, and add an additional permission fix for tooling.
  • Clarifies CI steps while keeping existing processes (e.g., SSH setup, permission fixes, dependency install, release) intact.
  • Streamlines setup, reduces manual steps, and improves reliability of iOS releases.

[coderabbitai]

Walkthrough

Updates iOS deployment documentation to use a GitHub Action for Xcode setup, relocate the iOS platform download command, and add a specific file permission fix for usymtool. Other steps remain unchanged.

Changes

Cohort / File(s)	Summary
iOS Deployment Docs docs/03-github/06-deployment/ios.mdx	Replace manual xcode-select with maxim-lobanov/setup-xcode@v1 (xcode-version: 16.4); move xcodebuild -downloadPlatform iOS into the “Fix File Permissions and Run fastlane” step; add chmod +x for usymtool; retain other steps (ssh-agent, permissions, bundle install, fastlane).

Sequence Diagram(s)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• Include xcode/ios platform selection in docs #514 — Also adjusts docs around Xcode selection and ensuring xcodebuild -downloadPlatform iOS, overlapping the same workflow area.

Poem

In burrows deep, I tweak with glee,
Swap Xcode steps for Actions free.
A nibble here—permissions right,
Usymtool hops into the light.
Platforms fetched, lanes align—
Ship iOS, carrots fine! 🥕✨

Tip

🔌 Remote MCP (Model Context Protocol) integration is now available!

Pro plan users can now connect to remote MCP servers from the Integrations page. Connect with popular remote MCPs such as Notion and Linear to add more context to your reviews and chats.

✨ Finishing Touches

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch davidmfinol-patch-4

---

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.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

• Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  • I pushed a fix in commit <commit_id>, please review it.
  • Open a follow-up GitHub issue for this discussion.
• Files and specific lines of code (under the "Files changed" tab): Tag @coderabbit in a new review comment at the desired location with your query.
• PR comments: Tag @coderabbit in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  • @coderabbit gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
  • @coderabbit read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbit help to get the list of available commands.

Other keywords and placeholders

• Add @coderabbit ignore or @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
• Add @coderabbit summary or @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
• Add @coderabbit or @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

• You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
• Please see the configuration documentation for more information.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

• Visit our Status Page to check the current availability of CodeRabbit.
• Visit our Documentation for detailed information on how to use CodeRabbit.
• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.

[github-actions]

[github-actions]

Visit the preview URL for this PR (updated for commit 79d20b8):

https://game-ci-5559f--pr516-davidmfinol-patch-4-nsshgwb7.web.app

_{(expires Thu, 04 Sep 2025 01:55:59 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: 1f0574f15f83e11bfc148eae8646486a6d0e078b}

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (1)

docs/03-github/06-deployment/ios.mdx (1)

485-485: Add safe shell options so the step fails fast if the download fails.

xcodebuild -downloadPlatform iOS is the right workaround for the “iOS XX is not installed” error seen on macOS 15 images; add set -euo pipefail at the top of this run block to avoid continuing after a partial/failed download. (github.com, developer.apple.com)

         run: |
+          set -euo pipefail
           xcodebuild -downloadPlatform iOS

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

• MCP integration is disabled by default for public repositories
• Jira integration is disabled by default for public repositories
• Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 78682fd and 79d20b8.

📒 Files selected for processing (1)

• docs/03-github/06-deployment/ios.mdx (2 hunks)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)

• GitHub Check: build_and_preview

🔇 Additional comments (1)

docs/03-github/06-deployment/ios.mdx (1)

463-466: Good switch to setup-xcode; consider clarifying pinning strategy.

Pinning Xcode 16.4 is appropriate given current macos-latest defaults and the macOS 15 image state. To help readers adapt when runner images change, add a brief inline comment about why it’s pinned and that latest-stable is an alternative. (github.com)

Apply this inline doc tweak:

       - name: Select Xcode
         uses: maxim-lobanov/setup-xcode@v1
         with:
+          # Pin to a known-good version due to recent runner image changes; update as needed.
+          # Alternatively, use 'latest-stable' if you prefer auto-tracking.
           xcode-version: '16.4'