CocoaPods安装教程

2016-10-25 本文已影响33人 Jjianshu

前言

由于升级到Xcode 8，原来那么多好用的插件都不能用了，其中也包括CocoaPods插件，无奈之下只得通过终端使用了
CocoaPods能让开发者非常方便的使用第三方类库，并且为我们的工程设置好相应的系统依赖和编译参数
其他介绍性的描述我就不说了，直接把我遇到的问题总结一下，以免重复踩坑~~~

准备工作

替换RubyGems 镜像
- 由于天朝网络管制的原因，正常安装的话会神慢，所以安装前需要先替换RubyGems 镜像，这里提供两个RubyGems 镜像供选择
  - 淘宝的源：https://ruby.taobao.org/
  - Ruby China：https://gems.ruby-china.org/

替换为其中一个就行了

// 移除原镜像
gem sources --remove https://rubygems.org/
// 替换成淘宝镜像
gem sources -a https://ruby.taobao.org/
// 查看当前镜像
gem sources -l

升级gem，如果gem版本过低也可能导致CocoaPods安装失败，在终端输入以下命令
- OS X EI Capitan之前
```
sudo gem update --system
```

OS X EI Capitan之后

sudo gem update -n /usr/local/bin --system

升级后通过gem -v命令检查下版本

安装CocoaPods

OS X EI Capitan之前
```
sudo gem install cocoapods
```

OS X EI Capitan之后

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

检查版本
```
pod --version
```
至此CocoaPods的壳已经安装完毕，下面需要初始化CocoaPods

初始化CocoaPods

不使用镜像（你看看就行了）
- 安装完CocoaPods后如果直接在终端输入pod setup，接着出现Setting up CocoaPods master repo，之后就是一个很漫长的等待...
- 会将数据下载到~/.cocoapods/repo/master目录中，可以cd ~/.cocoapods到此目录，用du -sh *每隔一段时间查看下下载下来的文件大小
- 初始化数据总共有400多兆，要这么下的话，一天也未必能下载下来
使用镜像
- coding镜像：https://git.coding.net/CocoaPods/Specs.git
  - 实际地址：https://coding.net/u/CocoaPods/p/Specs/git
- oschina镜像：https://git.oschina.net/akuandev/Specs.git
  - https好像有问题，一直是403
  - 可以用ssh的方式，这里需要到官网去配置ssh
  - 貌似这个镜像已经好久没更新了，果断放弃
- 替换镜像
```
// 先移除原specs仓库
pod repo remove master
// 国内镜像，每日自动更新
pod repo add master https://git.coding.net/CocoaPods/Specs.git
// 在下载完后执行这一句
pod repo update
```

第二步使用国能镜像下载可能出现的问题

问题1

问题描述

[!] To setup the master specs repo, please run pod setup.

解决办法，切记不要执行pod setup命令，执行此命令后会导致安装第三方会很慢

// 手动下载 
git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master 
// 初始化完成后执行一次
pod repo update

问题2

问题描述

img

解决办法，必须关闭Xcode

// 在终端中执行下面的命令，按照提示一步一步做完
// 执行完毕后，再次尝试下载，我通过此办法解决我的问题
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer

如果还是没有安装成功，可以尝试删除.cocoapods目录，然后重新安装

--------------删除 .cocoapods 目录--------------
cd ~/.cocoapods/
sudo -rm -rf ~/.cocoapods/
--------------重新安装--------------
// 国内镜像，每日自动更新
pod repo add master https://git.coding.net/CocoaPods/Specs.git
// 在下载完后执行这一句
pod repo update

检查是否安装成功
```
pod repo list
```

CocoaPods的使用

使用Xcode新建一个工程
打开终端，cd到工程目录下

生成Podfile文件

// 会产生一个模板文件
pod init

直接用文本打开Podfile文件，粘贴下面的内容进行测试，这两个库下载的快慢可以说明你的镜像是否设置成功
```
# platform :ios, '8.0'

target '项目名称' do

pod 'React', '0.13.0-rc' 
pod 'React/RCTText'

end
```
在终端中使用vim编辑器编辑Podfile
- vi podfile在vim编辑器中打开podfile文件
- 按i键进入编辑模式
- 编辑完成后，按esc键退出编辑模式
- 按:wq组合键并回车退出vim编辑器
回到终端执行以下命令，仅第一次执行pod install，之后都执行pod update，当然第一次也可以执行pod update，所以建议使用pod update
pod update/pod install命令有可能执行过慢（我没有遇到），如果遇到了大概原因是当执行以上两个命令的时候会升级CocoaPods的spec仓库，使用以下命令可以省略这一步，然后速度就会提升不少
```
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update
```
完成后进入工程目录，会发现多了.xcworkspace这个文件，即：工作区，以后都打开这个文件，而不要打开工程文件，然后Command+B编译一下，如果没有错误就表示成功添加了
以后要添加新的库，就编辑Podfile文件，打开终端，cd到工程根目录下，然后执行pod update命令就可以了

CocoaPods安装教程

前言

准备工作

安装CocoaPods

初始化CocoaPods

CocoaPods的使用

猜你喜欢

热点阅读