| name | bump-ios-version |
| description | Bump iOS and Xcode versions in Eigen. Use when the user wants to upgrade iOS SDK version, update Xcode version, change simulator version, or update CI configuration for new iOS/Xcode releases. |
Bump iOS/Xcode Version
This skill guides you through bumping the iOS and Xcode version in Eigen.
Before You Start
Prompt the user for the target version:
- Ask which iOS version they want to bump to (e.g., "26.2")
- Ask which Xcode version they want to use (e.g., "26.2")
- Ask which iPhone model to use for simulators (e.g., "iPhone 17 Pro")
Verify version support before making changes:
CircleCI Support
Check supported Xcode versions at: https://circleci.com/developer/machine/image/xcode
Currently supported versions include:
- 26.2, 26.1.1, 26.1, 26.0.1, 26.0
- 16.4, 16.3, 16.2
GitHub Actions Support
Check macOS runner images at: https://github.com/actions/runner-images
For macOS 15 runners, available Xcode versions include:
- 26.2, 26.1.1, 26.0.1
- 16.4 (default), 16.3, 16.2, 16.1, 16.0
If the requested version is not supported by both CI systems, warn the user that CI builds may fail.
iPhone Device Compatibility
Different iOS versions require specific iPhone simulator models. You must verify the iPhone model is available for the target iOS version in CircleCI's image manifest.
How to verify:
- Go to https://circleci.com/docs/guides/test/testing-ios/#supported-xcode-versions
- Find the target Xcode version row
