如何在使用xcodebuild构建时固定目标iOS SDK版本

方法1：通过flutter build命令直接指定SDK版本 #

flutter build ipa支持传递额外参数给底层的xcodebuild，你可以用--extra-xcode-args指定固定的SDK版本：

flutter build ipa --extra-xcode-args="-sdk iphoneos17.1"

将iphoneos17.1替换为你需要固定的目标SDK版本（比如iphoneos17.0、iphoneos16.4），前提是CI服务器的Xcode已经安装了该版本的SDK。

方法2：修改Xcode项目配置长期固定 #

如果希望项目默认使用指定SDK，无需每次命令加参数，可以修改项目配置：

• 打开项目的ios/Runner.xcodeproj或ios/Runner.xcworkspace
• 在Xcode的Build Settings中，找到Base SDK选项，选择你要固定的iOS SDK版本
• 或者直接编辑ios/Runner.xcodeproj/project.pbxproj文件，找到SDKROOT字段，设置为目标SDK：

  SDKROOT = iphoneos17.1;
  

注意事项 #

• 先在CI服务器上用xcodebuild -showsdks命令确认已安装的SDK列表，确保你指定的版本存在
• 如果Xcode更新后旧SDK被移除，可以通过Xcode偏好设置（Preferences）的Components标签页重新安装对应版本的iOS SDK
• 确认你的Flutter版本与指定的SDK版本兼容，避免出现兼容性报错

内容的提问来源于stack exchange，提问作者wujek