Flutter项目Cocoapods依赖版本与pub.dev同步校验问题咨询

核心问题先明确 #

不能直接认为pub.dev上的Flutter包版本和Xcode Pods目录下对应Pod的版本号一致：Flutter包的版本号是插件本身的迭代标识，其内部绑定的iOS原生Pod版本由插件作者在包内的ios/.podspec文件中指定，两者没有强制对齐的规则，可能存在Flutter包升级但Pod依赖版本不变，或者Pod依赖升级但Flutter包仅发小版本的情况。

本地Pod与Flutter依赖版本同步校验步骤 #

• 第一步：确认Flutter侧依赖版本符合预期
  执行flutter pub outdated命令，对比本地pubspec.lock的已安装版本与pub.dev最新版本，确认所有依赖已升级到你需要的版本。
• 第二步：获取Flutter插件绑定的Pod版本
  进入对应Flutter插件的本地缓存目录（默认路径为~/.pub-cache/hosted/pub.dev/[插件名+版本号]/ios/），打开目录下的.podspec文件，查看s.version字段值，该值就是当前版本Flutter插件要求的对应Pod版本。
• 第三步：校验本地已安装的Pod版本
  打开项目ios目录下的Podfile.lock文件，搜索对应Pod的名称，查看实际安装的版本号，与上一步获取的版本号对比，两者一致即说明Pod依赖和当前Flutter插件版本完全同步。

CocoaPods官网不可访问时的最新版本校验方法 #

无需访问cocoapods.org，直接执行pod search [目标Pod名] --sources=https://cdn.cocoapods.org/，即可从CocoaPods官方CDN源拉取该Pod的所有可用版本列表，直接对比即可确认本地安装的是否为最新版。

构建报错前置排查步骤 #

你遇到的Pod弃用相关报错，先按以下步骤排除版本异常问题：

• 执行flutter clean清除项目构建缓存
• 删除项目ios目录下的Pods文件夹、Podfile.lock文件
• 执行flutter pub get重新拉取Flutter依赖
• 进入ios目录执行pod install --repo-update重新安装所有Pod依赖
  如果执行完上述步骤仍有报错，基本可排除版本不一致问题，优先排查对应插件是否已适配Xcode 13与iOS 15的编译要求。

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