ruby源更改为ruby-china的cocoapods安装以及其中遇到的问题和解决办法

ruby-china更改域名后的更新。
由于国内网络原因,mac自带的ruby源https://rubygems.org/使用亚马逊云服务,访问速度太慢或者无法访问,需要将其移除更改为国内有人正在维护的源https://gems.ruby-china.com/

一、更改当前ruby源为ruby-china

1、查看当前ruby源

打开Terminal(Mac->Launchpad->其他->终端),输入以下命令:
$ gem sources -l

查询结果如图

之前已经安装过旧域名的源,https://rubygems.org/则显示为之前安装的https://gems.ruby-china.org/

2、移除已经存在的源,设置为ruby-china源

输入以下命令:
$ gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
已安装过的以上命令改为$ gem sources --add https://gems.ruby-china.com/ --remove https://gems.ruby-china.org/

设置如图

3、再次查看当前ruby源

输入以下命令:
gem sources -l

再次查询结果如图

此时ruby源已经设置成功了,Ruby镜像确保只有ruby-china。

二、更新gem为最新版本

ruby-china建议尽可能用比较新的 RubyGems 版本,如果gem版本太低则需要升级。

1、查询当前gem版本

输入以下命令:
$ gem -v

查询当前gem版本如图

2、更新gem

输入以下命令:
$ gem update --system

更新gem成功后如图

从后面的安装发现,此时gem并没有更新成功,输入以下命令:
$ sudo gem update --system
下面才是升级gem成功的图,内容太多只截取了开头和结尾:


升级gem成功如图

3、再次查询当前gem版本

输入以下命令:
$ gem -v

升级成功后的gem版本如图

三、安装cocoapods

1、输入安装命令

输入以下命令:
$ sudo gem install -n /usr/local/bin cocoapods
如果需要输入密码请输入本机密码(注:密码并不会显示,输入完成回车即可)
但是并没有安装成功,报错如下图:

安装报错如图

解决办法,输入以下命令:
$ sudo gem update --system
然后输入本机密码(注:密码并不会显示,输入完成回车即可)
ruby-china建议使用新的 RubyGems 版本,建议 2.6.x 以上。


更新新版gem成功如图

再次查询当前gem版本,输入以下命令:
$ gem -v

更新gem后的版本如图

再次输入安装命令:
$ sudo gem install -n /usr/local/bin cocoapods
如果需要输入密码请输入本机密码(注:密码并不会显示,输入完成回车即可)
之后就等着安装成功就好了,需要等几分钟的。
安装成功后如下图,由于内容太多这里只截取了后面的一部分:

安装cocoapads成功如图

使用另一个安装命令$ sudo gem install cocoapods会由于ssl证书问题导致报错。

ssl证书问题导致的报错如图

从ruby-china官网找到解决办法:

如果遇到 SSL 证书问题,你又无法解决,请直接用 http://gems.ruby-china.com 避免 SSL 的问题。

已经安装https的可以remove然后add即可换为http。
如果能解决ssl问题,请忽略上面的解决办法。
使用http://gems.ruby-china.com避免ssl的问题,再次安装还是会出现Gem::DependencyError的错误,解决办法同上。

2、初始化pod

输入以下命令:
$ pod setup
这里需要多等一段时间,完成后如下图:

setup失败如图

此时出现了报错,并没有安装完成,前往文件夹~/.cocoapods查看内容为空。不过没有关系,接下来看看能不能使用pod。也可以再次$ pod setup,出现Setup completed即为完成(再次$ pod setup后可省略下面的第4步:4、检查pod能不能使用)。

3、查看pod版本

输入以下命令:
$ pod --version

pod版本号如图

版本号为1.2.1,说明已经存在了pod。

4、检查pod能不能使用

使用pod的搜索功能验证,输入以下命令:
$ pod search AsyncSocket
由于上面setup没有成功,所以这里会再次自动setup,需要等一段时间,完成后如下图:

setup完成如图

但是此时搜索并没有成功,错误提示如下图:


搜索不成功报错如图

最后再解决搜索不成功的问题,这里先看看能不能下载三方库成功。

5、使用cocoapods下载三方库

使用cd命令进入创建好的项目总目录,下面是我的项目的目录,改成自己的项目目录就行:
$ cd Desktop/learn/CocoaAsyncSocket-pod/
然后在当前目录下用vim创建Podfile:
$ vim Podfile
按下i按键,Podfile文件变为可编辑状态,在其中输入以下内容,:

platform :ios, '8.0'
target 'CocoaAsyncSocket-pod' do
pod 'CocoaAsyncSocket', '~>7.6.1'
end

Podfile文件解释如下:
platform :ios, '8.0' # ios是开发平台,8.0是最低支持的版本,8.0不写默认为最新版本。
target 'CocoaAsyncSocket-pod' do # 引号里的CocoaAsyncSocket-pod是需要下载三方库的项目名称。
pod 'CocoaAsyncSocket', '~>7.6.1' # CocoaAsyncSocket是需要下载的三方库名称,7.6.1是三方库的版本号,不写默认为最新版本。

Podfile文件内容编辑如图

Podfile文件内容输入完成以后,按下esc按键退出编辑状态,接着输入以下命令回车保存并退出vim:
:wq

保存并退出如图

之后就发现项目总目录下多了一个Podfile文件,Podfile文件与工程文件.xcodeproj在同一个目录。

回到终端,在需要下载三方库的项目总目录下,输入以下命令:
$ pod install

下载成功后如图

下载三方库成功后,以后打开项目就用 .xcworkspace 打开,而不是之前的.xcodeproj文件,否则无法关联pod下来的类库。

6、三方库的更新

使用cd命令进入创建好的项目总目录,下面是我的项目的目录,改成自己的项目目录就行:
$ cd Desktop/learn/CocoaAsyncSocket-pod/
然后在当前目录下用vim创建Podfile:
$ vim Podfile
按下i按键,Podfile文件变为可编辑状态,在其中输入以下内容,:

platform :ios, '8.0'
target 'CocoaAsyncSocket-pod' do
pod 'CocoaAsyncSocket', '~>7.6.1'
end

'~>7.6.1'为想要更新得版本号,Podfile文件内容输入完成以后,按下esc按键退出编辑状态,接着输入以下命令保存并退出vim:
:wq
回到终端,在需要下载三方库的项目总目录下,输入以下命令:
$ pod update

7、搜索报错问题的解决

删除cocoapods的索引,输入以下命令:
$ rm ~/Library/Caches/CocoaPods/search_index.json
删除成功后再执行搜索:
$ pod search asyncsocket

搜索成功后如图

如果遇到了这里没有列的问题,可以到下面的参考链接找解决办法。
参考链接:
最新 macOS Sierra 10.12.3 安装CocoaPods及使用详解
更换ruby官方源到非taboo源的另一源:ruby-china源方法
CocoaPods安装和错误解决
OS X 10.11 安装Cocoapods 出现问题的解决方法
cocoapods 安装过程中的遇到的问题
macOS && Xcode8安装RVM,安装Ruby,安装/卸载Cococapods全程详解
CocoaPods: pod search 搜索类库失败的解决办法

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,830评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,992评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,875评论 0 331
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,837评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,734评论 5 360
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,091评论 1 277
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,550评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,217评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,368评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,298评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,350评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,027评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,623评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,706评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,940评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,349评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,936评论 2 341

推荐阅读更多精彩内容