iOS 安装 CocoaPods 步骤

---

CocoaPods 常用命令

1.先升级 Gem
sudo gem update --system

2.切换 Cocoapods 的数据源
【先删除，再添加，查看】
gem sources --remove https://rubygems.org/
gem sources -a https://gems.ruby-china.org/
gem sources -l

3.安装 Cocoapods
sudo gem install -n /usr/local/bin cocoapods
或 sudo gem install -n /usr/local/bin cocoapods -v 1.0.1

4.卸载
sudo gem uninstall -n /usr/local/bin cocoapods -v 1.0.1

5.将 Podspec 文件托管地址从 github 切换到国内的 oschina
【先删除，再添加，再更新】
pod repo remove master
pod repo add master http://git.oschina.net/akuandev/Specs.git
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update

6.设置pod仓库
pod setup

7.测试
【如果有版本号，则说明已经安装成功】
pod --version

8.利用cocoapods来安装第三方框架
01 进入要安装框架的项目的.xcodeproj同级文件夹
02 在该文件夹中新建一个Podfile文件：touch Podfile
03 在文件中告诉cocoapods需要安装的框架信息
    a.该框架支持的平台
    b.适用的iOS版本
    c.框架的名称
    d.框架的版本

9.安装
pod install --no-repo-update
pod update --no-repo-update

• 什么是CocoaPods?

CocoaPods是一个负责管理iOS项目中第三方开源库的工具。CocoaPods的项目源码在Github上管理。该项目开始于2011年8月12日，在这两年多的时间里，它持续保持活跃更新。开发iOS项目不可避免地要使用第三方开源库，CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间。
在我们有了CocoaPods这个工具之后，只需要将用到的第三方开源库放到一个名为Podfile的文件中，然后在命令行执行$ pod install
命令。CocoaPods就会自动将这些第三方开源库的源码下载下来，并且为我的工程设置好相应的系统依赖和编译参数。

• CocoaPods 的好处

1、在引入第三方库时它可以自动为我们完成各种各样的配置，包括配置编译阶段、连接器选项、甚至是ARC环境下的-fno-objc-arc配置等。
2、使用CocoaPods可以很方便地查找新的第三方库，方便项目开发。

• CocoaPods 安装步骤

1、升级 Ruby 环境

终端输入：$ sudo gem update -n /usr/local/bin --system

出现 RubyGems system software updated 字样，
恭喜你升级Ruby成功了！

---

可能上面升级Ruby环境失败，这个时候使用RVM对Ruby进行升级：

(1) 安装 RVM

RVM (Ruby Version Manager)，即Ruby版本管理器，包括Ruby的版本管理和Gem库管理。

终端输入：
$ curl -L get.rvm.io | bash -s stable
$ source ~/.bashrc
$ source ~/.bash_profile

若提示 -bash: /Users/***/.bash_profile: No such file or directory 找不到 .bash_profile 文件，直接在根目录创建一个即可：

终端输入：
$ cd ~
$ touch .bash_profile

安装成功后，可查看rvm版本：

$ rvm -v

(2) 用 RVM 升级 Ruby

查看当前ruby版本：$ ruby -v
列出已知的ruby版本：$ rvm list known
安装xcode command line：$ xcode-select --install
选择要安装的版本，如安装ruby 2.4.1：$ rvm install 2.4.1

---

2、更换 Ruby 镜像

• 移除现有的 Ruby 镜像

  终端输入：$ gem sources --remove https://rubygems.org/
  

• 添加国内最新镜像源

  终端输入：$ gem sources -a https://gems.ruby-china.org/
  

• 执行完毕之后输入gem sources -l来查看当前镜像

  终端输入：$ gem sources -l
  

输出结果如下：

    *** CURRENT SOURCES ***

    https://gems.ruby-china.org/

恭喜你添加成功啦

3、安装 CocoaPods

终端输入：$ sudo gem install -n /usr/local/bin cocoapods

安装成功

然后执行 pod setup

终端输入：$ pod setup

提示如下信息说明执行完成：
For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.4.0.beta.2

Setup completed

可以 command+n 新建一个终端窗口，执行 cd ~/.cocoapods/ 进入到该文件夹下，然后执行 du -sh * 来查看文件大小，当出现 Setup completed 的时候说明已经完成了。

4、CocoaPods 的使用

• 搜索第三方库

  终端输入：$ pod search ***
  

• 创建 Podfile 文件

  1. 终端输入：$ cd *.xcodeproj
  

  进入工程文件目录下，然后创建Podfile文件

  2. 终端输入：$ touch Podfile
  

• 使用 vim 编辑 Podfile 文件

  终端输入：$ vim Podfile
  

An example of a more complex Podfile can be:

  platform :ios, '9.0'
  inhibit_all_warnings!

  target 'MyApp' do
  pod 'ObjectiveSugar', '~> 0.5'

     target "MyAppTests" do
     inherit! :search_paths
     pod 'OCMock', '~> 2.0.1'
     end

  end

5、下载库到项目中

终端输入：$ pod install

or

终端输入：$ pod update

---

pod installted 完成后，工程目录会看到多了一个后缀名为 *.xcworkspace 文件。以后打开此文件即可开发啦~

---

6、文件和指令说明

• Podfile.lock 文件

  最后一次更新 Pods 时, 所有第三方框架的版本号
  

• 常用指令的区别

pod install 
1.会根据 Podfile.lock 文件中列举的版本号来安装第三方框架
2.如果一开始 Podfile.lock 文件不存在, 就会按照 Podfile 文件列举的版
  本号来安装第三方框架
3.安装框架之前, 默认会执行pod repo update指令

---

pod update
1.将所有第三方框架更新到最新版本, 并且创建一个新的 Podfile.lock 文件
2.安装框架之前, 默认会执行 pod repo update 指令

---

pod install --no-repo-update
pod update --no-repo-update
1.安装框架之前, 不会执行pod repo update指令

7、原理和说明

a. 第三方库会被编译成 .a 静态库供我们真正的工程使用

* CocoaPods 会将所有的第三方库以 target 的方式组成一个名为 Pod 的工程，该工程就放在刚才新生成的Pods目录下。整个第三方库工程会生成一个名称为 libPods.a 的静态库提供给自己的工程用。
* 对于资源文件，CocoaPods 提供了一个名为 Pods-resources.sh 的bash 脚本，该脚本在每次项目编译的时候都会执行，将第三方库的各种资源文件复制到目标目录中。

b. 我们的工程和第三方库所在的工程会由一个新生成的workspace 管理

为了方便我们直观的管理工程和第三方库，CocoaPodsTest 工程和Pods 工程会被以 workspace 的形式组织和管理，也就是我们刚才看到的*.xcworkspace文件。

c. 原来的工程设置已经被更改了，这时候我们直接打开原来的工程文件去编译就会报错，只能使用新生成的 workspace 来进行项目管理。

d.CocoaPods 通过一个名为 Pods.xcconfig 的文件来在编译时设置所有的依赖和参数。

8、其他

1、pod install 提速

每次执行 pod install 和 pod update 的时候，cocoapods 都会默认更新一次 spec 仓库。这是一个比较耗时的操作。在确认 spec 版本库不需要更新时，给这两个命令加一个参数跳过 spec 版本库更新,可以明显提高这两个命令的执行速度。

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

2、关于 Podfile 文件编辑时，第三方库版本号的各种写法

pod ‘AFNetworking’ //不显式指定依赖库版本，表示每次都获取最新版本
pod ‘AFNetworking’, ‘2.0’ //只使用2.0版本
pod ‘AFNetworking’, ‘>2.0′ //使用高于2.0的版本
pod ‘AFNetworking’, ‘>=2.0′ //使用大于或等于2.0的版本
pod ‘AFNetworking’, ‘<2.0′ //使用小于2.0的版本
pod ‘AFNetworking’, ‘<=2.0′ //使用小于或等于2.0的版本
pod ‘AFNetworking’, ‘~>0.1.2′ //使用大于等于0.1.2但小于0.2的版本，相当于>=0.1.2并且<0.2.0
pod ‘AFNetworking’, ‘~>0.1′ //使用大于等于0.1但小于1.0的版本
pod ‘AFNetworking’, ‘~>0′ //高于0的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本

---

---

1、查看 CocoaPods 组件安装位置：

$ which pod
结果：
/usr/bin/pod

2、手动移除这个组件：

 $ sudo rm -rf /usr/bin/pod

3、查看 gems 中本地程序包

$ gem list
结果:
    *** LOCAL GEMS ***

activesupport (4.2.10)
bigdecimal (default: 1.2.8)
CFPropertyList (2.3.5, 2.2.8)
claide (1.0.2)
cocoapods (1.3.1)
cocoapods-core (1.3.1)
cocoapods-deintegrate (1.0.1)
cocoapods-downloader (1.1.3)
cocoapods-plugins (1.0.0)
cocoapods-search (1.0.0)
cocoapods-stats (1.0.0)
cocoapods-trunk (1.3.0)
cocoapods-try (1.1.0)
colored2 (3.1.2)
concurrent-ruby (1.0.5)
did_you_mean (1.0.0)
escape (0.0.4)
fourflusher (2.0.1)
fuzzy_match (2.0.4)
gh_inspector (1.0.3)
i18n (0.9.0)
io-console (default: 0.4.5)
json (default: 1.8.3)
libxml-ruby (2.9.0)
ruby-macho (1.1.0)
rubygems-update (2.6.14)
sqlite3 (1.3.11)
thread_safe (0.3.6)
tzinfo (1.2.4)
xcodeproj (1.5.3)

可以发现当前 CocoaPods 的版本号是 1.3.1，
还可以输入如下命令查看：

 $ pod --version

4、移除程序包

有了版本号，就可以根据当前版本号移除 CocoaPods 了：

$ sudo gem uninstall cocoapods -v 1.3.1
结果:
Successfully uninstalled cocoapods-1.3.1

5、安装指定版本的 CocoaPods

$ sudo gem install cocoapods -v 1.3.1
结果:
Successfully installed cocoapods-1.3.1

PS: 参考 iOS安装CocoaPods详细过程CocoaPods的介绍、安装、使用和原理
平时自己经常要用到，所以这次记录整理下，懒得经常去找了~