CocoaPods安装、使用及常见问题解决

简介

官网 https://guides.cocoapods.org
CocoaPods是OS X和iOS下的一个第三方开源类库管理工具，通过CocoaPods工具我们可以为项目添加被称 为“Pods”的依赖库（这些类库必须是CocoaPods本身所支持的），并且可以轻松管理其版本。

优点

1、在引入第三方库时它可以自动为我们完成各种各样的配置，包括配置编译阶段、连接器选项、甚至是ARC环境下的-fno-objc-arc配置等。

2、使用CocoaPods可以很方便地查找新的第三方库，这些类库是比较“标准的”，而不是网上随便找到的，这样可以让我们找到真正好用的类库。

原理

CocoaPods的原理是将所有的依赖库都放到另一个名为Pods的项目中，然后让主项目依赖Pods项目，这样，源码管理工作都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件，主项目只需要依赖这个.a文件即可。

安装

安装Homebrew

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

如果报错 Failed to connect to raw.githubusercontent.com port 443: Connection refused 安装不了
先执行

sudo gem install redis

然后重新安装Homebrew
还是安装不了的话, 就换源, 使用国内源

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

安装rvm

curl -L [get.rvm.io](http://get.rvm.io/) | bash -s stable

加载文件,测试是否安装正常(按照提示操作)

source ~/.bashrc

source ~/.bash_profile

source ~/.profile

rvm -v

获取rvm列表

rvm list known

image.png

安装ruby3.0

rvm install 3.0

设置ruby的软件源

gem sources -l #查看当前ruby的源

gem sources --remove https://rubygems.org/ #移除当前ruby的源

gem sources -a https://gems.ruby-china.com/ #设置当前ruby的源, 淘宝镜像已经不能用了,可以用https://gems.ruby-china.com

gem sources -l #再次查看当前ruby的源

如果输出：
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
表示切换成功

设置gem为最新版本

gem update --system

如果出现
ERROR: While executing gem ... (OpenSSL::SSL::SSLError)
hostname "upyun.gems.ruby-china.org" does not match the server certificate

原因是之前用的ruby镜像源是淘宝的,需要切换成https://gems.ruby-china.com,输入

gem sources —remove https://ruby.taobao.org/

gem sources -a https://gems.ruby-china.com/

安装CocoaPods

sudo gem install -n /usr/local/bin cocoapods

pod setup

会输出Setting up CocoaPods master repo，但是会等待比较久的时间。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods目录下，如果你等太久，可以试着 cd 到那个目录，用du -sh *来查看下载进度。
然后再执行pod search 第三方框架

pod search Moya

如果出现 [!] CDN: trunk Repo update failed
执行

pod repo remove trunk

如果出现 [!] Unable to find a pod with name, author, summary, or description matching Moya
执行下面操作, 删除索引

rm ~/Library/Caches/CocoaPods/search_index.json

然后重新执行

pod search Moya

看到下面信息就说明安装成功了

image.png

使用

新建工程, 并cd到工程目录

cd ~/Desktop/test

新建Podfile文件

pod init

打开Podfile文件, 添加相关的第三库

image.png

导入第三方库

pod install

如果无论是执行pod install还是pod update都卡在了Analyzing dependencies不动, 原因在于当执行以上两个命令的时候会升级CocoaPods的spec仓库，加一个参数可以省略这一步，然后速度就会提升不少。加参数的命令如下：

pod install --verbose --no-repo-update

pod update --verbose --no-repo-update

成功后, 会在目录下生成一个跟工程名一样但是后缀为.xcworkspace的文件和一个Pods文件夹, 需要打开后缀为.xcworkspace的工程文件, 以后编码也是在此文件中进行操作, 使用时, 先import对应的第三方库就行