CocoaPods最新安装&卸载&使用教程

网上关于cocoapods的安装可谓是不可胜数。但是对于新版的系统来说，的确存在很多的坑点，本文只是对网上资源做了整合和自己的一些使用见解。

一：卸载cocopods

1.卸载老版本cocopods

$ sudo gem uninstall cocoapods

2.查看本地安装过的cocopods相关东西

$ gem list --local | grep cocoapods

结果如下：

cocoapods (1.0.1)
cocoapods-core (1.0.1)
cocoapods-deintegrate (1.0.1)
...

3.然后使用命令逐个删除

$ sudo gem uninstall +你要删除的库名称
比如：$ sudo gem uninstall cocoapods-core

.cocopods 文件有可能因为权限问题删除不了，可以直接找到 .cocopods 文件（隐藏文件）删掉就好
显示隐藏文件 :

defaults write com.apple.finder AppleShowAllFiles -bool true
killall Finder

二：安装cocopods

1.终端输入

$ curl -L https://get.rvm.io | bash -s stable

2.载入 RVM 环境

$ source ~/.rvm/scripts/rvm

检查一下是否安装正确

$ rvm -v

打印结果为：rvm 1.27.0 (latest) by Wayne E. Seguin <wayneeseguin@gmail.com>, Michal Papis <mpapis@gmail.com> [https://rvm.io/]

3.用RVM安装Ruby环境

• 可以先查询已经安装的ruby

$ rvm list

• 如果你想卸载一个已安装版本

$ rvm remove 1.9.2

• 列出已知的ruby版本

$ rvm list known

• 可以选择现有的rvm版本来进行安装（下面以rvm 2.3.0版本的安装为例）

$ rvm install 2.3.0 

4. 设置Ruby版本

• RVM 装好以后，需要执行下面的命令将指定版本的 Ruby 设置为系统默认版本

$ rvm 2.3.0 --default

• 验证RVM

$ ruby -v

打印如下：ruby 2.3.0p0 (2015-12-25 revision 53290) [x86_64-darwin15]

5. 查看ruby源

$ gem sources -l 

• 可以查看当前是什么连接，然后替换方式如下：

$ gem source -r https://rubygems.org/
$ gem sources --add https://gems.ruby-china.com/

• 有多余的镜像可以移除

gem sources --remove 镜像链接

• 要想验证是否替换成功了，可以执行：

$ gem sources -l  

• 成功显示

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

6. 开始安装cocoapods

$ sudo gem install cocoapods  

等到提示:gems installed

$ pod setup 

• 如果报异常可先执行 $ sudo rm -fr ~/.cocoapods/repos/master 再执行 $ pod setup
• 如果报git相关异常估计是系统升级导致的，先执行$ xcode-select --install再执行 $ pod setup

漫长的等待，估计有五百多兆...
如果安装过程中报如下错误：
unable to access 'https://github.com/CocoaPods/Specs.git/': SSLRead() return error -9806
遇到这种问题的话，可以手动去克隆一份到repos目录下面。

• 步骤1.通过finder的前往文件夹进行查看 ~/.cocoapods/repos
• 步骤2.通过终端，进入到 ~/.cocoapods/repos
• 步骤3.然后通过 git clone https://github.com/CocoaPods/Specs.git

可怜的你发现，速度真是慢啊，你等不了，还有二个解决方法

• 直接打开仓库链接，下载下来拷贝到相应的问价夹
  可怜的你还是发现，下载速度也很慢啊，这里还有一个解决方案，等！等等就快了，笔者试了的确比克隆快

• 终极解决方案，找一台工作正常的电脑，到他的~/.cocoapods/repos目录下面拷贝出master文件到自己的Mac上的相应位置

  好了，现在我们重新检测一下是否能正常运行。

三：使用cocoapods

1. 终端进入项目目录下

cd 空格一下 + 文件路径（直接把项目拉入终端即可）
如：cd ~/Path/To/Folder/Containing/IceCreamShop

2. 创建一个PodFile

pod init

这将为你的项目创建一个PodFile文件

3. 输入下面的命令行打开PodFile，并使用Xcode进行编辑：

open -a Xcode Podfile

注意：你不能使用TextEdit来编辑Podfile，因为它有可能用图形化的更有吸引力的typeset quotes代替standard quotes，这可能导致CocoaPods不能理解并抛出错误，所以最好用Xcode或者别的编程文本编辑器来编辑你的Podfile。
默认的podFile看起来是这样的：

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'testProject' do
  # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
  use_frameworks!

  # Pods for testProject

end

4. 将# platform :ios, '9.0'的#号去掉，后面的9.0可以根据项目需要更改，这段话就告诉了CocoaPods--你的项目使用的是iOS 9.0，并且将使用框架来代替静态库。
5. 安装你的第一个库，将下面的内容添加到你的Podfile里面

pod 'Alamofire', '1.2.3'

保存并关闭podFile

6. 开始给项目安装CocoaPods

pod install

7. 如果库比较多，在重新导入库用pod install就比较慢，下面的2个命令在安装新的库的前面不会重新更新前面已经安装的库

 pod install --no-repo-update
或
 pod update --no-repo-update

四：Podfile的语法解释

示列一个稍微复杂的Podfile：

source 'ssh://git@gitlab.9ijx.com:9830/iOS/Specs.git'
source 'https://github.com/CocoaPods/Specs.git'
 
platform :ios, '7.0' 
use_frameworks!
inhibit_all_warnings! 
 
workspace 'JYCocoaPodsTest'
 
target 'JYCocoaPodsTest' do
 
pod 'AFNetworking'
pod 'JYCarousel', '0.0.1'
pod 'WCJCache', :git => "http://gitlab.9ijx.com/iOS/WCJCache.git"
 
target :JYCocoaPodsTestUITests do
    inherit! :search_paths
    pod 'YYText'
 
end
end

1.platform :iOS, '7.0'

• 指定了开源库应该被编译在哪个平台以及平台的最低版本。
• 若不指定平台版本，官方文档里写明各平台默认值为iOS：4.3,OS X：10.6,tvOS：9.0,watchOS：2.0

2. inhibit_all_warnings!

• 屏蔽cocoapods库里面的所有警告
• 这个特性也能在子target里面定义,如果你想屏蔽某pod里面的警告也是可以的:

pod 'JYCarousel', :inhibit_warnings => true

3. xcodeproj现在被project代替，这个变量就别使用了

• 允许你指定需要链接的工程

4. use_frameworks!
   使用frameworks动态库替换静态库链接

• swift项目cocoapods 默认 use_frameworks!
• OC项目cocoapods 默认 #use_frameworks!

5. workspace
   • 指定应该包含所有projects的Xcode workspace.
   • 如果没有显示指定workspace并且在Podfile所在目录只有一个project，那么project的名称会被用作于workspace的名称
6. project

默认情况下是没有指定的，当没有指定时，会使用Podfile目录下与target同名的工程：(我们只有一个工程JYCocoaPodsTest)
# JYCocoaPodsTest这个Target只有在JYCocoaPodsTest工程中才会链接
target 'JYCocoaPodsTest' do
project 'JYCocoaPodsTest'
...
end

7. target 'xxxx' do ...end

• 指定特定Target的依赖库
• 可以嵌套子Target的依赖库

8. inherit! :search_paths

• 明确指定继承于父层的所有pod，默认就是继承的

9. source

• 指定specs的位置,自定义添加自己的podspec。公司内部使用
  cocoapods 官方source是隐式的需要的，一旦你指定了其他source 你就需要也把官方的指定上
  例如：

source 'ssh://git@gitlab.9ijx.com:9830/iOS/Specs.git'
source 'https://github.com/CocoaPods/Specs.git'

10. 依赖库的基本写法：

pod 'JYCarousel', //不显式指定依赖库版本，表示每次都获取最新版本
pod 'JYCarousel', '0.01'//只使用0.0.1版本
pod 'JYCarousel', '>0.0.1' //使用高于0.0.1的版本
pod 'JYCarousel', '>=0.0.1' //使用大于或等于0.0.1的版本
pod 'JYCarousel', '<0.0.2' //使用小于0.0.2的版本
pod 'JYCarousel', '<=0.0.2' //使用小于或等于0.0.2的版本
pod 'JYCarousel', '~>0.0.1' //使用大于等于0.0.1但小于0.1的版本，相当于>=0.0.1&&<0.1
pod 'JYCarousel', '~>0.1' //使用大于等于0.1但小于1.0的版本
pod 'JYCarousel', '~>0' //高于0的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本

// 依赖库的自定义写法
pod 'JYCarousel', :path => '/Users/Dely/Desktop/JYCarousel'

end

查看最新CocoaPods的下载地址 https://ruby-china.org/