Why am I getting an IPHONEOS_DEPLOYMENT_TARGET warning for CocoaPods dependencies during iOS builds?
Last updated: August 26, 2026
Context
When building an iOS app using xcode-project build-ipa, you may encounter a warning like the following, even if your main project and Pods are set to a higher iOS deployment target in Xcode:
warning: The iOS deployment target 'IPHONEOS_DEPLOYMENT_TARGET' is set to 10.0, but the range of supported deployment target versions is 12.0 to 26.4.99. (in target 'GTMAppAuth-GTMAppAuth_Privacy' from project 'Pods')Answer
This warning comes from a CocoaPods dependency (such as GTMAppAuth), not your main project. Even if your project and Pods are configured to a higher iOS version in Xcode locally, the Pods project is regenerated during CI builds — so any manual changes made in Xcode will not persist.
To fix this, set the deployment target for all Pod targets using a post_install hook in your Podfile:
Open your
Podfile.Add the following
post_installblock at the end of the file (replace'16.0'with your desired minimum deployment target):post_install do |installer| installer.pods_project.targets.each do |target| target.build_configurations.each do |config| config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '16.0' end end endIf you already have a
post_installsection in yourPodfile, add the inner logic to the existing block rather than creating a second one.Run
pod installlocally to verify the change, then commit and push the updatedPodfileandPodfile.lock.
This ensures that all Pod targets use the correct deployment target during CI builds, eliminating the warning.