重点、重点、重点
重点:在执行安装过程中遇到中断、进度缓慢、各种失败报错 等问题时,///请按照以下顺序的进行处理,成功率保证 99.999999999999999999%1、重试、重试、重试,相信我,多试几次会有奇迹的;2、切换为手机移动网络,已验证过多次,此方法可行;3、到这里还不成功的话那就走科学上网的通道吧,注意切换成全局模式(建议放最后试吧,反正我没试过,都是听别人说的);4、到这一步都不成功,我只能建议你在凌晨左右的时候会好很多已验证过多次,此方法可行;5、如果遇到各种SSL报错等问题看看下面的终极解答6、你的人品是有多差啊,洗洗睡吧;
终极解答
关于执行pod install 或者 pod update 卡住、缓慢等问题的完美解决
—-------—-------—-------—-------—-------—-------—-------—-------
前言:
在需要安装CocoaPods时,总会有各种烦人的问题导致安装失败,这也促使自己在不断的摸索中学习到了很多,这里总结一下,供大家学习研究。如果你按照下面的步骤做基本都能保证成功,万一遇到报错请参看文章开头的重点强调
CocoaPods简介:
CocoaPods是一个用Ruby写的、负责管理iOS项目中第三方开源库的工具,CocoaPods能让我们集中的、统一管理第三方开源库,为我们节省设置和更新第三方开源库的时间。
CocoaPods安装;
注意:命令中间可能有空格看不出来,建议直接复制粘贴执行;
因为Mac电脑自带Ruby环境,我们就只需打开终端开始动手。然而又因为默认情况下我们mac系统自带的Ruby环境版本比较低(大概是2.0.0或者其他较高版本),但是现在安装CocoaPods需要2.2.2版本及以上的,所以我们不管三七二十一先直接先升级ruby。
打开终端:>_
1、查看当前Ruby版本
ruby -v
结果如下,或者你的可能是其它版本,没关系继续往下操作
ruby 3.0.0p0(2020-12-25 revision 95aff21468)[x86_64-darwin20]
2、安装rvm,我们要通过rvm来安装Ruby(第一步要下载一些东西等两分钟左右)
curl -L get.rvm.io | bash -s stable source ~/.bashrcsource ~/.bash_profile
3、查看rvm版本
rvm -v
显示如下(或者是其他版本)
rvm 1.29.12(latest)by Michal Papis,Piotr Kuczynski,Wayne E. Seguin [https://rvm.io]
4、列出ruby可安装的版本信息
rvm list known
显示如下
# MRI Rubies[ruby-]1.8.6[-p420][ruby-]1.8.7[-head] # security released on head[ruby-]1.9.1[-p431][ruby-]1.9.2[-p330][ruby-]1.9.3[-p551][ruby-]2.0.0[-p648][ruby-]2.1[.10][ruby-]2.2[.10][ruby-]2.3[.8][ruby-]2.4[.10][ruby-]2.5[.8][ruby-]2.6[.6][ruby-]2.7[.2][ruby-]3[.0.0]ruby-head.....
5、安装Homebrew
已安装的可跳过,遇到报错请参看文章开头的重点说明
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
6、安装ruby, 建议选择最新的3.0.0版本
rvm install 3.0.0
注意:
1、安装过程中需要两次按下 Enter 键, 第二次按下后需要输入电脑访问密码(不可见,只管输入就行);
2、如果你电脑没有安装以下三项
Xcode
Command Line Tools for Xcode
Homebrew
会自动下载安装,这里建议提前安装这三者
设为默认
rvm use 3.0.0 --default
7、更换源
sudo gem update --system
///这一步建议是先执行后续用到了再添加///例如,你使用Fastlane进行自动化部署这个是需要的gem sources--removehttps://rubygems.org/
gem sources--addhttps://gems.ruby-china.com/
8、验证你的Ruby镜像是并且仅是ruby-china
gem sources -l
如果是以下结果说明正确,如果有其他的请自行百度解决
***CURRENT SOURCES***https://gems.ruby-china.com/
9、开始安装CocoaPods
sudo gem install -n /usr/local/bin cocoapods
10、如果安装了多个Xcode使用下面的命令选择(一般需要选择最近的Xcode版本)
sudo xcode-select-switch/Applications/Xcode.app/Contents/Developer
11、安装本地库,这个内容有点多,建议先看完在操作
说明:该步骤是安装本地库,不安装也没事,项目可以照常pod install。
只不过不安装的话就不能使用pod search 命令了;如果你追求完美那就继续往下看;
/// 这个命令是官方提供的,貌似在新系统上面无效pod setup
在旧系统上面,执行以上命令后
Setting up CocoaPods master repo $ /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress Cloning into 'master'... remote: Counting objects: 1879515, done. remote: Compressing objects: 100% (321/321), done. Receiving objects: 21% (404525/1879515), 73.70 MiB | 22.00 KiB/
然后就是漫长的等待,当然,网络好的情况下会更快
查看安装进度
要查看文件下载进度的可以另外打开一个终端窗口(快捷键:选中终端按下Command+N组合键),输入以下两行命令回车执行
cd ~/.cocoapodsdu -sh *
执行du -sh *之后会显示已下载的文件大小,可以多次执行来监看下载进度,如果之前还有文件大小,后来变成0了,可能是网络问题,下载已经中断了,需要结束命令并从新执行 pod setup
重点来了!!!
根据经验发现在MacOS Catalina 及以后的系统命令行执行pod setup命令后直接就直接结束了;这显然不对劲。
我们手动安装本地库,速度绝对快
如果你开启了科学上网,建议直接从官方进行下载安装(参看文章开头的终极解答)
gitclonehttps://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
当然你也可以直接使用国内镜像进行下载安装,这个速度绝对跑满
gitclonehttps://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
目录结构见下图,如果不是就自己手动移动一下
Snip20191011_2.png
13、下载安装完成之后可执行下列命令检查是否可用(第一次使用可能要等一会)
pod search AFNetworking
14、CocoaPods的具体使用
新建一个Xcode工程,使用终端cd到工程目录下
创建Podfile文件:
podinit
之后就可以在项目目录里看到一个Podfile文件
打开Podfile文件:
openPodfile
添加:
pod 'Alamofire'
保存后退出
开始下载:
pod install
关于pod命令使用问题的一些问题请参看点击下面的链接
#######补种内容
// 安装最新版cocoapodssudo gem install cocoapods--pre// 移除本地mastersudo rm-fr~/.cocoapods/repos/master// 移除本地缓存sudo rm-fr~/Library/Caches/CocoaPods/// 重新setup,如果很慢可使用问题1的解决方法(git clone)pod setup--verbose// 移除trunkpod repo remove trunk
其它参考: