CocoaPods的安装及使用

Posted 2020-08-28 我是一只小小bird

一、前言

　　2016年4月15日，为什么我会记得这个日子呢，因为这一天，是我接触ios开始的一天。也是因为项目的需要，就投入到iOS的开发中了，在接到说要我去开发iOS，当时的心情既激动也忐忑，激动是觉得自己除了android，又有iOS可以去学习了，可以开拓思维，也就多了一门技术。忐忑是因为说以前都没接触过，不知道能不能做好。带着这样的心情，开始了我的iOS之旅了。好了，听我扯了这么多，还没讲到今天的主角，是不是有些犯困了呢。那就有请我们的主角闪亮登场。掌声响起来。。。。。

二、什么是CocoaPods？？？

CocoaPods is an application level dependency manager for the Objective-C, Swift and any other languages that run on the Objective-C runtime, such as RubyMotion, that provides a standard format for managing external libraries. It was developed by Eloy Durán and Fabio Pelosin, who continue to manage the project with the help and contributions of many others. They began development in August 2011 and made the first public release on September 1, 2011. CocoaPods is strongly inspired by a combination of the Ruby projects RubyGems and Bundler.

CocoaPods focuses on source-based distribution of third party code and automatic integration into Xcode projects.

CocoaPods runs from the command line and is also integrated in JetBrains‘ AppCode integrated development environment. It installs dependencies (e.g. libraries) for an application by specification of dependencies rather than manual copying source files. Besides installing from many different sources, a “master” spec repository—containing metadata for many Open-Source libraries—is maintained as a git repository and hosted on GitHub. Over 3000 libraries are currently available for use.

其实上面一大段英文不用管它，我只是想装一把Bilit。简而言之，就是我们第三方开源库管理工具。在没有使用CocoaPods之前，我们在使用第三方类库的时候，需要配置这，配置那的，很是麻烦。有了CocoaPads，就不需要我们再去配置了，大大提高了效率，避免了在配置过程中产生的一些错误。

三、搞定Ruby

由于CocoaPods是Ruby写的，所以需要在Ruby环境下运行，好在Mac系统默认安装好了Ruby环境，虽然默认有Ruby环境，但是还是需要做些调整。

首先打开我们的Terminal(也就是我们的终端)，输入以下命令行，查看当前Ruby的版本：

$gem -v

此时在终端会出现Ruby的版本号，如不是最新版本，请升级版本。

$gem update --system

以上命令行的就是升级Ruby环境的，可能在终端输入命令行回车后，会出现一个错误，这个错误应该说的是没有权限去升级Ruby，如若遇到此种情况，请输入以下命令行：

$sudo gem update --system

至此，Ruby就升级成功了。

再来就是Ruby源的替换了，首先输入以下命令行，检查当前的Ruby源：

$gem sources -l

默认情况下，终端输入的是以下信息：

*** CURRENT SOURCES ***

https://rubygems.org/

上面的Ruby源墙内无法访问的，所以得换成国内的源，之前我一直使用的是淘宝的(https://ruby.taobao.org)，但是后来去到这个网站看个下，RubyGems 镜像的管理工作已经交由RubyChina负责了，所以之前淘宝的那个不再提供更新了，不建议使用了。所以我们需要经过以下操作，来替换我们的Ruby源。

$gem sources --remove https://rubygems.org/
$gem sources -a https://gems.ruby-china.org

经过以上两个步骤，我们的Ruby源就已经成功替换了，为了确保我们的Ruby源替换成功，输入以下命令行：

$gem sources -l

此时，我们在终端可以看到以下信息就表示成功了

*** CURRENT SOURCES ***

https://gems.ruby-china.org

四、CocoaPods的安装

CocoaPods的安装就很简单了，输入以下命令行：

$sudo gem install cocoapods
$pod setup

这一步会很慢，很慢.........需要耐心等待，再等待........

五、CocoaPods的使用

首先需要创建或者打开一个Xcode项目，其次在终端cd到该项目的根目录，输入以下命令行创建Podfile文件：

$pod init

然后就是编辑Podfile文件：

$vim Podfile

学过命令行的同学肯定知道要怎么编辑和保存该文件，所以知道的同学请略过。要获得编辑权限，需要在键盘上按下"i"键，此时就可以编辑了，键盘上的上下左右键，可以选择在哪一行上输入。

现假设我们需要使用"AFNetworking"网络请求库，就可以在Podfile文件里输入以下代码：

pod ‘AFNetworking‘,‘~>3.1.0‘

第一次使用CocoaPods的人也许会有个疑问，上面代码中的3.1.0是从哪来的？是什么意思？

我相信很多同学肯定知道3.1.0是什么意思，没错，是版本号。还有就是你怎么知道就是这个版本呢，下面就来揭晓是怎么来的。

我们在终端输入以下命令行：

$pod search AFNetworking

就会在终端看到以下信息：

-> AFNetworking (3.1.0)
   A delightful iOS and OS X networking framework.
   pod ‘AFNetworking‘, ‘~> 3.1.0‘
   - Homepage: https://github.com/AFNetworking/AFNetworking
   - Source:   https://github.com/AFNetworking/AFNetworking.git
   - Versions: 3.1.0, 3.0.4, 3.0.3, 3.0.2, 3.0.1, 3.0.0, 3.0.0-beta.3,
   3.0.0-beta.2, 3.0.0-beta.1, 2.6.3, 2.6.2, 2.6.1, 2.6.0, 2.5.4, 2.5.3, 2.5.2,
   2.5.1, 2.5.0, 2.4.1, 2.4.0, 2.3.1, 2.3.0, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0,
   2.1.0, 2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1, 1.3.4,
   1.3.3, 1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1, 1.0, 1.0RC3, 1.0RC2,
   1.0RC1, 0.10.1, 0.10.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0, 0.5.1 [master repo]
   - Subspecs:
     - AFNetworking/Serialization (3.1.0)
     - AFNetworking/Security (3.1.0)
     - AFNetworking/Reachability (3.1.0)
     - AFNetworking/NSURLSession (3.1.0)
     - AFNetworking/UIKit (3.1.0)

现在知道这个版本号是怎么来了吧。

编辑完Podfile，接下来就是保存Podfile文件了，知道的同学再次略过。首先按下键盘上的"ESC"，其次按下":",最后输入"wq"，点击回车，就保存好文件了。

这样还没有完成哦，还差最后一步，在终端输入以下命令行：

$pod install

好了，到这呢，进入我们项目的根目录，会发现在我们项目的根目录下有一个.xcworkspace文件。

至此，CocoaPods的安装和使用就讲完了。