KMM接入CocoaPods报错：cocoapods-generate要求CocoaPods>=1.5.0如何解决

你遇到的报错本质是旧版本cocoapods-generate 1.4.1对高版本CocoaPods的识别逻辑存在缺陷，同时高版本cocoapods-generate与Ruby 3存在依赖冲突，可根据你的情况选择以下两种方案解决：

方案一：升级cocoapods-generate到最新版本（推荐，无后续兼容问题） #

• 安装Ruby版本管理工具（rbenv或rvm均可），避免修改系统自带Ruby导致权限异常
• 通过版本管理工具安装Ruby 2.7.x系列版本，示例操作：

  # rbenv操作示例
  rbenv install 2.7.8
  rbenv local 2.7.8
  

• 切换到Ruby 2.7环境后，直接执行gem install cocoapods-generate，即可自动安装最新的2.2.2版本，无依赖冲突
• 回到KMM项目重新执行构建命令即可正常完成CocoaPods依赖集成

方案二：不改动Ruby环境的临时适配方案 #

如果你暂时不想调整本地Ruby版本，可以通过修改KMM配置绕开报错：

• 打开项目shared模块的构建配置文件（build.gradle.kts或build.gradle）
• 在cocoapods配置块中，明确添加pod版本号配置：

  cocoapods {
      // 原有配置保留，新增以下行
      version = "1.0"
      // 其余配置不变
  }
  

• 删除shared模块下build目录内的所有cocoapods相关缓存文件
• 重新执行构建，旧版本cocoapods-generate 1.4.1即可正常运行

注意事项 #

• 不要使用sudo执行gem安装命令，用版本管理器安装的Ruby无需管理员权限，也不会出现权限冲突
• 若在IDE内置终端中执行构建，需确认终端加载的Ruby版本和你配置的版本一致，避免环境变量不生效导致安装无效

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