更新于 20230326
一、 替换 Ruby 源
CocoaPods 是基于 Ruby ecosystem 的,需要 Ruby 环境,使用 Ruby 的 gem 命令。所以我们的系统要有 Ruby 环境。然而 Mac 系统默认会安装好 Ruby 环境。可在终端 ruby -v
查看 Ruby 版本:
// 查看 ruby 版本
$ ruby -v
// 输出信息
ruby 3.0.0p0 (2020-12-25 revision 95aff21468) [x86_64-darwin19]
查看 Ruby 源
$ gem sources -l
默认情况下,终端会显示下面:
*** CURRENT SOURCES ***
https://rubygems.org/
当然这个源在墙内是访问不到的, 所以要更换到 ruby-china 的镜像
// 1.移除掉原有的源
$ gem sources --remove https://rubygems.org/
// 2.使用 ruby-china 的源 https://gems.ruby-china.com/ added to sources
:~ Shiran $ gem sources -a https://gems.ruby-china.com
// 3.验证是否替换成功
:~ Shiran$ gem sources -l
// 如果显示下面输出就说明正确:
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
二、更新升级 Gem 版本
Gem 是管理 Ruby 库和程序的标准包,如果它的版本过低也可能导致安装失败,解决方案自然是升级 Gem,执行下述命令即可:
// 更新升级 gem,国内需要切换源
$ sudo gem update —system
$ sudo gem update --system -n /usr/local/bin
查看 gem 版本
gem -v
3.1.4
三、 安装 CocoaPods
OS X 10.11 以前安装命令为:
$ sudo gem install cocoapods // 安装cocoapods
Mac 系统为 OS X EL Capitan 安装命令为:
// 安装最新版本
$ sudo gem install -n /usr/local/bin cocoapods
// 安装指定版本
$ sudo gem install -n /usr/local/bin cocoapods -v 1.0.0
// 安装最新的 release beta 版本
$ sudo gem install -n /usr/local/bin cocoapods --pre
如果你想卸载 CocoaPods 怎么办?看下面:
// 卸载 CocoaPods
$ sudo gem uninstall cocoapods
四、更新 Podspec 索引文件
如果按照上面三个步骤没问题,用命令 pod --version
查看是否安装成功,如果成功会显示 pods 的版本。
pod --version
1.12.0
pod setup 作用:将所有第三方的 Podspec 索引文件更新到本地的 ~/.cocoapods/repos
目录下
pod 安装成功之后一个首先的操作就是执行命令(不是必须的):
pod setup
所有的第三方开源库的 Podspec 文件都托管在https://github.com/CocoaPods/Specs
我们需要把这个 Podspec 文件保存到本地,这样才能让我们使用命令 pod search 开源库
搜索一个开源库,怎样才能把github上的Podspec文件保存本地呢?那就是 pod setup
执行 pod setup 时,CocoaPods 会将第三方的 podspec 索引文件更新到本地的 ~/.cocoapods/repos
目录下
如果没有执行过 pod setup,那用户根目录下~找不到
.cocoapods/repos
目录的,没有创建这个目录。如果执行 pod setup,并且命令没有执行成功,那么会创建
~/.cocoapods/repos
目录,只不过目录是空的。如果执行 pod setup,并且命令执行成功,说明把 github 上的 Podsepc 文件更新到本地,那么会创建
~/.cocoapods/repos
目录,并且repos目录
里有一个master目录
,这个 master 目录保存的就是 github 上所有第三方开源库的 Podspec 索引文件。
但是第一次执行 pod setup 时,这个 github 的 Podspec 索引文件比较大,有 300M 左右(以后会越来越大的),所以第一次更新时非常慢.要耐心等待......可以进去目录 ~/.cocoapods/repos
使用命令 du -sh *
来查看下载文件的大小了