iOS问题记录 - CocoaPods is installed but broken

今天药忘吃喽~ 2024-05-24 21:43 13阅读 0赞

#### 文章目录 ####

*  前言
 *  开发环境
 *  问题描述
 *  问题分析
 *  解决方案
 *  总结
 *  最后

--------------------

## 前言 ##

一个老早的iOS项目修复了一个问题，需要打包一个内测版出来给测试人员，但是打包机正忙着打包其他项目，估计一时半会也空不出来。想起电脑上以前装过Jenkins，那何不在自己电脑上运行打包脚本。说干就干，远程登上打包机，把`jobs`目录下的打包任务复制到自己电脑上。这不轻轻松松就把打包脚本跑起来了，新的代码一拉，`pod install`一执行，结果问题来了。

## 开发环境 ##

*  Xcode: 14.0.1
 *  Cocoapods: 1.11.3
 *  Fastlane: 2.210.1
 *  Ruby: 2.6.8p205

## 问题描述 ##

执行`pod install`命令报错提示：

Warning: CocoaPods is installed but broken. Skipping pod install.
    You appear to have CocoaPods installed but it is not working.
    This can happen if the version of Ruby that CocoaPods was installed with is different from the one being used to invoke it.
    This can usually be fixed by re-installing CocoaPods.
    To re-install see https://guides.cocoapods.org/using/getting-started.html#installation for instructions.
    
    CocoaPods not installed or not in valid state.

## 问题分析 ##

这报错提示已经说的很详细了，问题出在了安装`CocoaPods`时使用的`Ruby`版本与现在调用的`Ruby`版本不同。

解决办法也在报错提示中说了，重新安装`CocoaPods`解决。那先尝试重装试试，我电脑上的`CocoaPods`是通过`Homebrew`安装的，所以先执行brew卸载命令：

brew uninstall cocoapods

接着执行安装命令：

brew install cocoapods

重装成功接下来测试问题是否解决，找到iOS项目根目录，执行`pod install`发现还是报错。难道这个报错提示不准确？

如果你通过重装已经解决了该问题，那下面的内容可以略过了?。

做开发呢，当一个项目之前还很正常，突然遇到奇怪的问题时首先要想到是不是版本升级不兼容了。这项目老早以前运行是正常的，不过因为第三方库没变化，所以很久没执行过`pod install`命令，不过`CocoaPods`版本升级过，难道是`CocoaPods`或`Ruby`的版本有所变化导致的问题？

先看看`CocoaPods`版本：

pod --version

执行输出：

1.11.3

再看看`Ruby`版本：

ruby -v

执行输出：

ruby 2.6.8p205 (2021-07-07 revision 67951)

当前使用的`Ruby`竟然是系统自带的，这有点不科学，我记得我用`Homebrew`装了3.0的版本，找到环境变量配置文件，发现之前配置的环境变量没了。再看看打包机上的`Ruby`版本是`3.1.2p20`，问题的原因看来就是这个了。

## 解决方案 ##

命令行执行：

echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc

设置完毕再来看看当前的`Ruby`版本：

ruby -v

执行输出：

ruby 3.1.2p20

到此，问题就解决啦?。

如果你用的是其他shell，请将`.zshrc`换成对应shell的环境变量配置文件。当然，你也可以打开环境变量配置文件手动加上`export PATH="/usr/local/opt/ruby/bin:$PATH"`。其实使用`Homebrew`安装`Ruby`时，安装成功后会教你修改环境变量，我记得我安装成功后改过，不知道为啥没了?。如果以上操作还是没有改变当前使用的`Ruby`版本，建议重新安装`Ruby`，按照安装成功以后的提示修改环境变量。

以上是我的最终解决方案，如果你不使用`Homebrew`，或者问题还没有得到解决，可以继续看看这篇文章[iOS问题记录 - CocoaPods is installed but broken（续）][iOS_ - CocoaPods is installed but broken]。

## 总结 ##

生命在于折腾。

## 最后 ##

如果这篇文章对你有所帮助，请不要吝啬你的点赞?加星?，谢谢～

[iOS_ - CocoaPods is installed but broken]: https://blog.csdn.net/crasowas/article/details/127629350