Update IOS Deployment Target

Update iOS Minimum Deployment Target

This skill updates the minimum iOS deployment target across all Salesforce Mobile SDK Templates that support iOS.

When to Use

• After the iOS SDK repo has bumped its minimum iOS version
• When creating a new SDK release that requires a higher iOS version
• Templates should always match or exceed the iOS SDK minimum deployment target

What This Skill Does

Updates the iOS deployment target in all iOS templates:

1. Podfiles - Updates platform declaration in all template Podfiles
2. Xcode Project Files - Updates IPHONEOS_DEPLOYMENT_TARGET in all .pbxproj files

Usage

When invoked, ask the user for:

• Current minimum iOS version (e.g., "16.0")
• New minimum iOS version (e.g., "17.0")

Affected Templates

Native iOS Templates (7 templates)

• iOSIDPTemplate
• iOSNativeLoginTemplate
• iOSNativeSwiftEncryptedNotificationTemplate
• iOSNativeSwiftTemplate
• iOSNativeTemplate
• iOSNativeSwiftPackageManagerTemplate (no Podfile, only .pbxproj)
• MobileSyncExplorerSwift

React Native Templates (4 templates)

React Native templates have iOS projects in ios/ subdirectory:

• MobileSyncExplorerReactNative
• ReactNativeDeferredTemplate
• ReactNativeTemplate
• ReactNativeTypeScriptTemplate

Step-by-Step Process

1. Update Native iOS Template Podfiles

Update platform :ios, "X.0" in:

• iOSIDPTemplate/Podfile
• iOSNativeLoginTemplate/Podfile
• iOSNativeSwiftEncryptedNotificationTemplate/Podfile
• iOSNativeSwiftTemplate/Podfile
• iOSNativeTemplate/Podfile
• MobileSyncExplorerSwift/Podfile

Note: iOSNativeSwiftPackageManagerTemplate does NOT have a Podfile (uses SPM instead)

2. Update React Native Template Podfiles

Update platform :ios, "X.0" in:

• MobileSyncExplorerReactNative/ios/Podfile
• ReactNativeDeferredTemplate/ios/Podfile
• ReactNativeTemplate/ios/Podfile
• ReactNativeTypeScriptTemplate/ios/Podfile

3. Update Native iOS Xcode Project Files

Update IPHONEOS_DEPLOYMENT_TARGET = X.0; in all .pbxproj files:

• iOSIDPTemplate/Authenticator.xcodeproj/project.pbxproj
• iOSNativeLoginTemplate/iOSNativeLoginTemplate.xcodeproj/project.pbxproj
• iOSNativeSwiftEncryptedNotificationTemplate/EncryptedNotificationTemplate.xcodeproj/project.pbxproj
• iOSNativeSwiftTemplate/iOSNativeSwiftTemplate.xcodeproj/project.pbxproj
• iOSNativeTemplate/iOSNativeTemplate.xcodeproj/project.pbxproj
• iOSNativeSwiftPackageManagerTemplate/iOSNativeSwiftPackageManagerTemplate.xcodeproj/project.pbxproj
• MobileSyncExplorerSwift/MobileSyncExplorerSwift.xcodeproj/project.pbxproj

4. Update React Native Xcode Project Files

Update IPHONEOS_DEPLOYMENT_TARGET = X.0; in all .pbxproj files:

• MobileSyncExplorerReactNative/ios/MobileSyncExplorerReactNative.xcodeproj/project.pbxproj
• ReactNativeDeferredTemplate/ios/ReactNativeDeferredTemplate.xcodeproj/project.pbxproj
• ReactNativeTemplate/ios/ReactNativeTemplate.xcodeproj/project.pbxproj
• ReactNativeTypeScriptTemplate/ios/ReactNativeTypeScriptTemplate.xcodeproj/project.pbxproj

Post-Update Tasks

1. Test templates: Use test_template.sh to verify all iOS templates build successfully

   # Test all iOS templates
   ./test_template.sh --platform ios
   
   # Test specific template
   ./test_template.sh --template iOSNativeSwiftTemplate --platform ios
   

2. Test React Native templates: Test both iOS and Android platforms

   ./test_template.sh --template ReactNativeTemplate --platform ios
   

3. Coordinate with iOS SDK: Ensure this change is made AFTER the iOS SDK has bumped its deployment target

Important Notes

• STOP and FLAG for human review: This is a breaking change that affects all iOS app developers using the SDK
• Release timing: Only bump deployment target at major releases, never patches
• Breaking change: Document this in migration guide and release notes
• iOS SDK dependency: The iOS SDK (SalesforceMobileSDK-iOS) must be updated FIRST before updating templates
• Xcode version requirements: Higher iOS deployment targets may require newer Xcode versions - ensure documentation reflects this

Historical References

• PR #439: iOS 16.0 → iOS 17.0 bump (January 2025)

Checklist

Before marking complete:

• All 6 native iOS template Podfiles updated (iOSNativeSwiftPackageManagerTemplate has no Podfile)
• All 4 React Native template Podfiles (in ios/ subdirs) updated
• All 7 native iOS template .pbxproj files updated
• All 4 React Native template .pbxproj files (in ios/ subdirs) updated
• Templates build successfully with test_template.sh
• iOS SDK has already been updated to the new deployment target
• Breaking change documented for release notes

Finding Files Programmatically

Use these commands to find all affected files:

# Find all Podfiles (should find 10)
find . -name "Podfile" -not -path "*/mobile_sdk/*" | sort

# Find all .pbxproj files (should find 11)
find . -name "project.pbxproj" -not -path "*/mobile_sdk/*" | sort

# Verify current iOS version in Podfiles
grep -r "platform :ios" --include="Podfile"

# Verify current iOS version in .pbxproj files
grep -r "IPHONEOS_DEPLOYMENT_TARGET" --include="project.pbxproj" | grep -v "mobile_sdk"

Related Skills

See SalesforceMobileSDK-iOS/.claude/skills/update-ios-deployment-target/SKILL.md for the iOS SDK version of this skill, which handles:

• CocoaPods specifications (podspec files)
• Build configuration files
• Installation scripts
• Documentation
• GitHub Actions workflows
• Code cleanup (removing obsolete version checks)