经得起考验的CocoaPods安装教程

发布时间:2025-12-09 19:06:36 浏览次数:3

**前言**
这是我个人经验的记录下来的安装cocoaPods顺序,本来是记录下来放到云笔记方便以后翻阅的,是3年前写的,这不是新型病毒疫情,公司全体在家办公,需要给给家里的新电脑按照环境。遇到了些新的问题,又改了下,发到这里,与大家分享下我的经验。
安装CocoaPods涉及三方面:CocoaPods本身、Ruby环境、Ruby管理工具。原因:
1. CocoaPods是用Ruby实现的,所以,使用CocoaPods的前提是处于Ruby环境下。
2. 需要用到Ruby管理工具来安装Ruby。管理Ruby的工具有很多,rvm就是其中一个,它提供一个便捷的多版本 Ruby 环境的管理和切换。

安装步骤

**最重要的:**
保证iOS 系统版本为最新,XCode的版本也是最新。否则会有情况不明的问题。

1. Ruby管理工具rvm的安装

首先检测rvm是否安装:

    rvm -v

安装过程

    1. curl -L https://get.rvm.io | bash -s stable   // 安装rvm2. source ~/.rvm/scripts/rvm                         //载入rvm环境3. rvm -v //验证rvm是否正常安装

(    1. curl -L https://get.rvm.io | bash -s stable   // 安装rvm====>这个地址有时候会变,请到官网重新copy过来运行:https://rvm.io/)

2. 安装Ruby
虽然Mac都自带Ruby,但是CocoaPods的安装需要特定版本的Ruby。而Mac自带的Ruby的版本可能不合适。选哪个版本比较好呢?一般来说,用最新版本的Ruby是最保险的。

安装过程
1.首先,查看目前的所有Ruby版本。找到最新的版本号。

    rvm list known

2.安装最新版本的Ruby

    rvm install ruby-xx.xx(xx.xx表示版本号)


3.更改Ruby的软件源。
Ruby的软件源用的是亚马逊的云服务,访问不了。所以,在安装CocoaPods前,需要更改该软件源为我们可以访问的源。修改方式如下。

    Ruby源更改动态:2018.3月以前的时候,Ruby源要更改为:https://gems.ruby-china.org2018.3月后,Ruby源变了,要更改为:https://gems.ruby-china.com 

可以先用【gem sources -l】命令查看源是否为最新的Ruby源(目前是https://gems.ruby-china.com ) 。不是的话再按照3.1的方法把源改为最新的Buby源。

  3.1 更改Ruby源gem sources --remove https://rubygems.org/  (移除https://rubygems.org/下载地址)gem sources -a  https://gems.ruby-china.com (添加https://gems.ruby-china.org/为下载地址)注意:gem sources -a 后面的这个地址,要用https,而不是http3.2 检查更改是否成功**gem sources -l如果结果显示只有 https://ruby.taobao.org/ 这个下载地址。则表示我们的更改操作正确。


3.安装CocoaPods

1.安装CocoaPods

    sudo gem install cocoapods

2.检测安装是否正确

    which pod (which命令:查看可执行文件的位置)

3. pod setup(这个步骤,请直接看下面的Tips)

Tips: 下载速度太慢解决办法
备注:以下的(1)-(3)步骤,也可以简化为,拷贝同事的本地的/.cocoapods/repos/下的master文件,放到自己本机的/.cocoapods/repos目录下。

    (1.) 进入本机目录:/.cocoapods/repos(2.) 终端进入到目录/.cocoapods/repos,然后执行clone Specs项目的语句:  git clone https://github.com/CocoaPods/Specs.git 等待其clone完成。终端会显示有clone的进度,比直接执行po d setup更直观。(3. )将clone的Specs项目的文件夹改名为master,然后拖到/Users/用户名/.cocoapods/repos目录下。(4.) 运行 pod install --verbose --no-repo-update   或  pod setup (推荐使用pod install --verbose --no-repo-update。因为--no-repo-update参数禁止了pod setup默认执行的更新spec文件的行为)

所有的项目的 Podspec 文件都托管在https://github.com/CocoaPods/Specs。第一次执行pod setup时,CocoaPods 会将这些podspec索引文件更新到本地的 ~/.cocoapods/repos目录下,这个索引文件比较大。所以第一次更新时非常慢。
pod setup在执行时,会输出Setting up CocoaPods master repo,但是会等待比较久的时间。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods/repos目录下,如果你等太久,可以试着 cd 到那个目录,用du -sh *来查看下载进度。

遇到的问题

【问题1】
pod install 的时候,总是install openssl 失败。没有什么信息提示,只是有一大板的红色openssl 的配置文件信息。
【解决】
(1)用openssl-universal(修改podfile文件)。这个办法有点不好的是,有可能引入的其他库也引入了openssl。
(2)有可能是xcode不是最新版本所致(我就是这个问题,当时iOS 系统为10.1.6,xcode的版本为8--最新版本为10.13.2,xcode为9)

【问题2】
Failed to connect to raw.githubusercontent.com port 443: Connection refused
【解决】
这是由于该网址的域名解析被污染的缘故。通过修改hosts可以解决这个问题:
打开/etc/hosts 文件,添加语句:

    199.232.4.133 raw.githubusercontent.com

    

参考文档


1.https://blog.csdn.net/fengsh998/article/details/52172741
2.https://www.cnblogs.com/jiang-xiao-yan/p/5229608.html

需要做网站?需要网络推广?欢迎咨询客户经理 13272073477