美文网首页
CocoaPods安装方法及避坑全过程-2020.07.12

CocoaPods安装方法及避坑全过程-2020.07.12

作者: heller灬 | 来源:发表于2020-07-12 23:32 被阅读0次

IOS开发装过很多次CocoaPod,中间遇到过各种烦人的问题,总结一下,供大家学习研究,以下过程经本人新机测试,一路畅通无任何错误,中间有网络不好的可能会下载中断出错,只要从新执行一下命令就行了。

CocoaPods是什么?

当你开发iOS应用时,会经常使用到很多第三方开源类库,比如JSONKit,AFNetWorking等等。可能某个类库又用到其他类库,所以要使用它,必须得另外下载其他类库,而其他类库又用到其他类库,“子子孙孙无穷尽也”,这也许是比较特殊的情况。总之小编的意思就是,手动一个个去下载所需类库十分麻烦。另外一种常见情况是,你项目中用到的类库有更新,你必须得重新下载新版本,重新加入到项目中,十分麻烦。如果能有什么工具能解决这些恼人的问题,那将“善莫大焉”。所以,你需要 CocoaPods。

CocoaPods应该是iOS最常用最有名的类库管理工具了,上述两个烦人的问题,通过cocoaPods,只需要一行命令就可以完全解决,当然前提是你必须正确设置它。重要的是,绝大部分有名的开源类库,都支持CocoaPods。所以,作为iOS程序员的我们,掌握CocoaPods的使用是必不可少的基本技能了。

CocoaPods安装前环境准备

CocoaPods是一个用Ruby写的,需要在Ruby环境下执行,虽然Mac电脑自带Ruby环境,然而默认情况下我们mac系统自带的Ruby环境版本比较低(大概是2.0.0或者其他较高版本),但是现在安装CocoaPods需要2.2.2版本及以上的,所以我们检查Ruby版本进行升级ruby。

打开终端:>_

1、查看当前Ruby版本

ruby -v

2、升级Ruby环境,首先需要安装rvm(RVM 是一个命令行工具,可以提供一个便捷的多版本 Ruby 环境的管理和切换,具体详见:https://ruby-china.org/wiki/rvm-guide)

gpg  --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E37D2BAF1CF37B13E2069D6956105BD0E739499BDB

\curl -sSL https://get.rvm.io | bash -s stable
source ~/.bashrc
source ~/.bash_profile

根据命令可看出,安装RVM,需要先安装GPG(GNU Privacy Guard【GnuPG或GPG】是一种加密软件),
要安装GPG,又需要先安装brew(Homebrew是Mac OS 不可或缺的套件管理器。是一款Mac OS平台下的软件包管理工具,拥有安装、卸载、更新、查看、搜索等很多实用的功能。简单的一条指令,就可以实现包管理,而不用你关心各种依赖和文件路径的情况,十分方便快捷。)

由此可见,先安装brew,再安装GPG,然后才安装RVM。
(1)安装Homebrew

-官网给出的安装方法:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

这种方法并不适用国内的Mac用户,因为网络资源的原因,电脑下载是龟速,实在是无法忍受
为了解决下载慢,推荐替换镜像源,将下载资源改为国内镜像资源即可。
步骤一: 获取install文件:

curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install >> brew_install

因为链接https://raw.githubusercontent.com/Homebrew/install/master/install我这里网络打不开,所以直接使用百度网盘下载到本地:(链接: https://pan.baidu.com/s/1KygTFr4y8LZ-3c49xr63bw 提取码: eu2m)
步骤二:安装,运行brew_install

/usr/bin/ruby  ~/brew_install
出现了如下界面: image.png

这个是因为源不通,代码无法下载到本地,解决方法是更换成国内中科院镜像源,执行如下命令安装brew:

git clone git://mirrors.ustc.edu.cn/homebrew-core.git/  /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core --depth=1

继续执行以下命令安装brew cask:

git clone git://mirrors.ustc.edu.cn/homebrew-cask.git/  /usr/local/Homebrew/Library/Taps/homebrew/homebrew-cask --depth=1

步骤三:把Homebrew-core的镜像源设置为中科院的国内镜像

cd "$(brew --repo)"
git remote set-url origin https://mirrors.ustc.edu.cn/brew.git
// 替换核心软件仓库
cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"
git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
//替换cask软件仓库
cd "$(brew --repo)/Library/Taps/homebrew/homebrew-cask"
git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
//替换Bottle源--bash用户
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.bash_profile
source ~/.bash_profile
//替换Bottle源--zsh用户(这个可选)
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc
source ~/.zshrc

步骤四:执行更新brew命令和检测命令

brew update
brew doctor

步骤四:查看安装结果版本号

brew -v
结果如下界面: image.png
(2)安装GPG
brew install gpg
(3)安装RVM

本来是使用上面GPG安装rvm的命令即可,但是我这里还是无法访问https://get.rvm.io,所以采取离线安装的方式。

步骤一:下载RVM
上github下载rvm,https://github.com/rvm/rvm.git

步骤二:双击打开下载下来文件夹中的/bin/rvm-installer

image.png

步骤三:配置到.bash_profile

export PATH="/Users/ccy/.rvm/  bin:$PATH"

注意:把命令中的ccy换成自己的用户
步骤四:查看安装结果版本号

rvm -v
结果如下界面: image.png
(4)升级Ruby

步骤一:切换Ruby镜像源

//查看gem源
gem sources -l
#删除默认的gem源或者之前的tabao源,添加rubyChina作为gem源
gem sources  --add https://gems.ruby-china.org/  --remove https://rubygems.org/
//查看当前gem源
gem sources -l
//清空源缓存
gem sources -c
//更新源缓存
gem sources -u

查看当前gem源显示如下页面:

image.png
注:国内的淘宝镜像源已经不更新维护,要使用rubyChina镜像源才行
步骤二:列出ruby可安装的版本信息
rvm list known

显示如下:

image.png
步骤三:安装一个ruby版本 安装ruby时,最好安装最新的正式版,即2.7.1
rvm install  2.7.1

步骤四:设置为默认版本

rvm use 2.7.1 --default

步骤五:查看已安装的ruby版本

rvm list
显示如下界面: image.png

至此,ruby环境已经升级成功。

CocoaPods安装

(1)执行安装命令
sudo gem install -n /usr/local/bin cocoapods
(2)如果安装了多个Xcode使用下面的命令选择(一般需要选择最近的Xcode版本)
sudo xcode -select -switch  /Applications/Xcode.app/Contents/Developer

注:执行前先安装Xcode命令行工具

(3)安装本地库
pod setup
最新版的MacOS Catalina系统命令行执行pod setup命令,直接结束啦!

我们手动安装:
执行命令1:

git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/trunk

或者命令2:

git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git  ~/.cocoapods/repos/trunk
(4)安装完成之后可执行下列命令检查是否可用(第一次使用可能要等一会)
pod search AFNetworking
(5)使用CocoaPods

步骤一:新建一个Xcode工程,使用终端cd到工程目录下,创建Podfile文件:

pod init

步骤二:打开Podfile文件,编辑添加:pod 'AFNetworking',保存后退出。

open Podfile

步骤三:下载AFNetworking使用

pod install

到此! 成功安装使用了CocoaPods!

如有问题可以先自行检索错误原因及解决办法

相关文章

网友评论

      本文标题:CocoaPods安装方法及避坑全过程-2020.07.12

      本文链接:https://www.haomeiwen.com/subject/yqvncktx.html