修改Flutter iOS最小部署目标版本

当在Flutter项目中遇到iOS部署目标版本警告时，您可能会看到类似以下的错误信息：

warning: The iOS deployment target 'IPHONEOS_DEPLOYMENT_TARGET' is set to 8.0, but the range of supported deployment target versions is 9.0 to 14.0.99.

这些警告表明您的项目或依赖项配置了不再受支持的iOS部署目标版本。以下是解决此问题的全面指南。

问题原因

Flutter默认将iOS部署目标设置为8.0，但较新版本的Xcode（特别是Xcode 12及以上）仅支持iOS 9.0及以上版本。当您的CocoaPods依赖项也需要更高版本的iOS时，会出现此兼容性问题。

解决方案

方法一：更新Podfile配置（推荐）

这是最彻底且持久的解决方案，通过在ios/Podfile中添加后安装脚本来统一设置所有pod的部署目标。

打开ios/Podfile文件

确保已取消注释并设置平台版本：

ruby

platform :ios, '9.0' # 或您需要的最低支持版本

在文件末尾添加后安装脚本：

ruby

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '9.0'
    end
  end
end

TIP

对于macOS、tvOS或watchOS项目，使用相应的部署目标设置：

macOS: MACOSX_DEPLOYMENT_TARGET
tvOS: TVOS_DEPLOYMENT_TARGET
watchOS: WATCHOS_DEPLOYMENT_TARGET

方法二：更新Xcode项目设置

通过Xcode打开ios/Runner.xcworkspace
在项目导航器中选择Runner目标
在"General"选项卡中，将"Deployment Target"设置为9.0或更高版本
同样检查并更新Pods项目中各依赖项的目标版本

方法三：更新Flutter配置

编辑ios/Flutter/AppFrameworkInfo.plist文件
将MinimumOSVersion值从8.0改为9.0或更高版本
在ios/Runner.xcodeproj/project.pbxproj文件中，将所有IPHONEOS_DEPLOYMENT_TARGET = 8.0实例替换为IPHONEOS_DEPLOYMENT_TARGET = 9.0

方法四：清理并重建项目

在执行上述更改后，运行以下命令清理并重新构建项目：

bash

flutter clean
rm ios/Podfile.lock pubspec.lock
rm -rf ios/Pods ios/Runner.xcworkspace
flutter pub get

其他可能解决方案

INFO

如果上述方法均无效，可以尝试以下备选方案：

更新Flutter版本：确保使用Flutter 1.22或更高版本，这些版本更好地支持Xcode 12和iOS 14
重新激活全局包：有时全局包失效会导致此问题，尝试重新激活：
bash
```
dart pub global activate flutterfire_cli
```
修复pub缓存：
bash
```
flutter pub cache repair
```
检查不兼容的包：确保没有导入dart:html等不兼容的包

注意事项

WARNING

提高部署目标版本意味着您的应用将不再支持较旧的iOS设备
在提高部署目标前，请评估您的用户群体和使用设备

重要提示

这些警告通常不会导致构建失败。如果构建失败，请检查真正的错误原因（在输出中搜索"error"关键字），部署目标警告可能只是误导信息。

结论

通过更新Podfile配置、Xcode项目设置和Flutter配置，您可以轻松解决iOS部署目标版本不匹配的问题。推荐使用方法一（更新Podfile配置），因为它是最全面且易于维护的解决方案。

完成更改后，记得执行清理和重建操作，确保所有更改正确应用。

相关文章

修改Flutter iOS最小部署目标版本 ​

问题原因 ​

解决方案 ​

方法一：更新Podfile配置（推荐） ​

方法二：更新Xcode项目设置 ​

方法三：更新Flutter配置 ​

方法四：清理并重建项目 ​

其他可能解决方案 ​

注意事项 ​

结论 ​