mac cocoapod安装过程

cocoapod: 自动化管理第三方开发包的一个插件, 废话不多说, 一个新手只需做如下几个步骤

1-> 安装ruby环境(可忽略, 不是必要)

1.1 首先我们先看看当前你机器上ruby的版本

ruby -v

ruby 2.4.0p0 (2016-12-24 revision 57164) [x86_64-darwin16]

1.2 接下来我们来看看服务器上的ruby版本 (建议用rvm)

RVM:Ruby Version Manager, Ruby版本管理器,包括Ruby的版本管理和Gem库管理(gemset)

1.2.1 安装rvm

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

注意: 如果安装结尾出现, 执行下面修复命令

rvm fix-permissions

如果出现

  * To start using RVM you need to run `source /Users/vp/.rvm/scripts/rvm`
    in all your open shell windows, in rare cases you need to reopen all shell windows.

执行下面命令, 再去安装

source ~/.rvm/scripts/rvm

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

source ~/.bashrc
source ~/.bash_profile
source ~/.profile
rvm -v

rvm 1.29.2 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io/]

1.2.3 获取rvm列表, 就能看到最新ruby版本了, 如果与你机器的ruby版本不一致可以选择升级(⊙o⊙)哦

rvm list known

1.3 安装最新ruby(当前如果当前ruby版本够用你可以选择不安装)

rvm install 2.4

1.3.1 安装的过程需要手动按一下enter(回车)键

1.3.2 按完enter之后系统还会提示要你开机密码做验证

注意: 如果安装失败提示

Error running 'requirements_osx_port_libs_install curl-ca-bundle automake libtool libyaml libffi libksba',showing last 15 lines of /Users/acewill/.rvm/log/1468253599_ruby-2.3.0/package_install_curl-ca-bundle_automake_libtool_libyaml_libffi_libksba.log

原因是需要安装Homebrew

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

安装完之后在跳到【1.3】

1.3.3 检查版本是否安装成功

ruby -v

2-> 更换gem源
gem是一个管理Ruby库和程序的标准包，它通过Ruby Gem(如 http://rubygems.org/ )源来查找、安装、升级和卸载软件包, 所以一定确保有ruby环境才能下面的操作.
国内人员不使用git自带的，因为自带的gem源是国外的网址，taobao为我们提供了一个很不错的'gem源', 现在的taobao源团队已经维护使用ruby-china, 所以现在推荐使用ruby-china

// 移除旧的
gem sources --remove https://rubygems.org/
// 添加新的
gem sources --add https://ruby.taobao.org/
// gem sources -ahttps://gems.ruby-china.org/ 
// 查看当前'源'
gem sources -l

3-> 更新升级gem

sudo gem update -n /usr/local/bin cocoapods -v 1.0.1

注意1: 如果升级提示 ERROR:  While executing gem ... (OpenSSL::SSL::SSLError)

可能是你的ruby版本问题  或者是  源不对 回到【1】

4-> 安装

4.1 安装cocoapods

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

注意1: 如果升级提示

While executing gem ... (Gem::DependencyError)
Unable to resolve dependencies: cocoapods requires cocoapods-core (= 1.2.1), cocoapods-downloader (< 2.0, >= 1.1.3), cocoapods-trunk (< 2.0, >= 1.2.0), molinillo (~> 0.5.7), xcodeproj (< 2.0, >= 1.4.4), colored2 (~> 3.1), ruby-macho (~> 1.1)

可能你的gem版本问题, 执行下面这句

sudo gem update --system

成功之后在返回4.1

注意2:

GemWrappers: Can not wrap missing file: pod
GemWrappers: Can not wrap missing file: sandbox-pod

表示你的 gem出问题了执行下面的命令

gem uninstall rubygems-update

4.2 查看本地所有cocoapod的版本列表

gem list

4.3 如果某个版本不需要可卸载

sudo gem uninstall cocoapods -v 0.35.0
sudo gem uninstall cocoapods-core -v 0.35.0
sudo gem uninstall cocoapods // 卸载所有

5-> pod初始化

pod 需要从指定的源中获取到第三方库, 所以需要对一个'pod源' 进行初始化, 把所有的库映射到本地

5.1 更换repo镜像为国内服务器

// 移除现有的镜像
pod repo remove master
// 添加新镜像源
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update

已知道的源有

https://gitcafe.com/akuandev/Specs.git
http://git.oschina.net/akuandev/Specs.git
https://git.coding.net/hging/Specs.git 

注意如果提示

MydeMacBook-Pro:~ taurin$ pod repo add master https://gitcafe.com/akuandev/Specs.git
[!] To setup the master specs repo, please run `pod setup`.

请执行5.2

5.2 初始化第三方库信息: 把第三方库映射到本地

pod setup

注意如果提示

error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress

Cloning into 'master'...
remote: Counting objects: 1975217, done.
remote: Compressing objects: 100% (401/401), done.
error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

执行下面指令

cd ~/.cocoapods/
sudo -rm -rf ~/.cocoapods/ 

返回到 5.2

5.3 查找第三方库

pod search tt

注意: 如果在查找的过程中出现Unable to find a pod with name, author, summary, or description matching `tt`

解决办法: 需要把以前查找过的json文件删掉

目录地址/Users/taojian/Library/Caches/CocoaPods/search_index.json

5.4 更新pod映射库

pod repo update

5.5 其他操作

5.4.1 查看当前pod版本

pod --version

5.4.2 查看repo

pod repo list

6-> 创建podfile文件集成第三方库

6.1 新建Podfile

vim Podfile

6.2 编辑podfile文件

- 输入i：进入编辑状态
- 输入dd：删除当前行
- 按ESC：退出编辑模式
- 输入:wq：保存并退出

6.3 Podfile文件的格式

以前你这么写是可以的, 应该是cocoapods0.35.0版本

```objc
platform :ios, '8.0'
pod '框架名字'
pod '框架名字', '~> 版本号'
```

1.0.0以后如果你还是那么写是报错的, pod不成功的, 需要下面的写法 (推荐这么写)

platform :ios, '8.0'
use_frameworks!

// SwiftAFNetwoking 是你APP里targets 名如下图所示
target 'SwiftAFNetwoking' do

pod 'AFNetworking', '~> 2.6'

end 

6.4 解析Podfile，安装第三方框架

pod install

6.5 升级第三方框架

pod update

6.6 手动创建podfile文件不用vim命令

直接在已有的项目里把podfile文件复制过来, 利用txt编辑器修改里面的内容, 最后pod install这样也可以的

7-> 出现的问题、与解决办法:

7.1. pod install 之后发现没有xcworkspace文件

解决办法

// 移除cocoapods
1. sudo gem uninstall cocoapods // 可能会让你选择一个版本
// 再安装cocoapods
2. sudo gem install -n /usr/local/bin cocoapods --pre
// 再install
3. pod install

7.2. 但如果cocoapod升级版本以后你会发现上面写的会提示

解决办法: 因为cocoapod 格式改了如下

platform :ios, '8.0'
use_frameworks!

// SwiftAFNetwoking 是你APP里targets 名如下图所示
target 'SwiftAFNetwoking' do

pod 'AFNetworking', '~> 2.6'

end 

再pod install