手把手教你CocoaPods安装教程和使用

Posted 2021-04-30 iOS进阶

作为一个ioser，在日常开发过程中经常会使用到第三方库，我们可以用 CocoaPods 来统一管理这些第三方库，以提升我们的工作效率。 今天就带领大家重温一遍CocoaPods的安装过程以及在使用过程中遇到问题的解决办法。

安装CocoaPods

一、搭建CocoaPods环境

打开Mac自带的终端

1、查看电脑当前Ruby版本

ruby -v

2、升级Ruby环境，首先需要安装rvm

curl -L get.rvm.io | bash -s stable

source ~/.bashrc

source ~/.bash_profile

3、查看rvm版本

rvm -v 

显示如下(或者是其他版本)

rvm 1.29.9 (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[.6][ruby-]2.5[.5][ruby-]2.6[.3] //安装这个版本[ruby-]2.7[.0-preview1] //这个版本是测试版ruby-head.........

5、选择一个版本安装Ruby。

如果你电脑没有安装Xcode和Command Line Tools for Xcode以及Homebrew 会自动下载安装。

rvm install 2.6.3

6、更新 Mac 的 Gem

Gem是管理Ruby库和程序的标准包，这一步需要输入管理员权限密码（电脑密码，看不到输入结果的，输完密码之后直接回车）

sudo gem update --system 

7、更换源

Ruby的默认使用源使用的是cocoapods.org，国内访问这个网址的时候可能会有问题，所以以前使用源都是淘宝的。 但是淘宝的源已经不更新了，改用ruby-china源

gem sources --remove https://rubygems.org/

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

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

8、验证是否成功替换Ruby的默认源

gem sources -l

输出以下结果说明正确

*** CURRENT SOURCES ***
https://gems.ruby-china.com/

二、安装CocoaPods

1、开始安装CocoaPods

sudo gem install cocoapods

或者（Mac OSX 10.11之后）

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

2、安装本地库

pod setup

3、执行以上命令后，开始漫长的下载过程

Setting up CocoaPods master repo

在下载过程中，可以随时查看下载进度，重新打开一个终端窗口，然后执行下面两句指令：

cd ~/.cocoapods

du -sh *

执行完这两句指令之后就可以看到已经下载了多少，可以多次执行du -sh *指令多次查看下载进度，我安装时安装包是1.3G。 如果下载中断,需要结束命令并从新执行 pod setup。

4、查找自己需要添加的第三方库

pod search AFNetworking

CocoaPods的具体使用

1、创建Podfile文件

新建一个Xcode工程，使用终端cd到工程目录下，然后通过终端指令创建Podfile文件：

pod init

之后就可以在项目目录里看到一个Podfile文件

2、编辑需要安装的第三方库信息

这一步有多种方式，这里只为大家介绍其中一种：
双击打开Podfile文件，在文件内输入

platform :ios, '8.0'target “工程名称” dopod 'AFNetworking', '~> 3.1.0'end

3、开始下载第三方库

然后关闭Podfile文件，回到终端执行下载的指令：

pod install

又是漫长的等待时间，如果下载的第三方库文件大，可能要花很长时间。

其他一些指令

查看CocoaPods版本

pod --version

升级CocoaPods版本

sudo gem install -n /usr/local/bin cocoapods -v 版本号

常见问题解决方案

执行pod search 第三方库名称搜索找不到第三方库

执行下面命令清理一下CocoaPods本地的搜索索引缓存，再搜索就能搜出你想找到第三方库

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

当然CocoaPods这么强大的一个工具，还有其他作用，后续会为大家带来有关CocoaPods的其他教程。

—————————End—————————

客官别走，您再看看别的菜？

“客官，我觉得您应该点个在看”