SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsupdate-ios-deployment-target

update-ios-deployment-target

Coding & development

View repository

Updated 10-16 05:47

About this skill

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)