1、安装
- 打开Finder/应用程序/实用工具/终端;
- CocoaPods 是用 Ruby 写的,所以运行需要安装 Ruby 环境。Mac 中已经自带 Ruby 环境,如果认为 Ruby 环境不够新,可以先在终端输入以下命令进行更新:
gem update –system复制代码
由于安装 CocoaPods 时要访问,因为可能被屏蔽了,因此用淘宝的Ruby镜像来访问该网站,在终端输入以下命令进行替换镜像:
gem sources --remove https://rubygems.org/gem sources -a https://ruby.taobao.org/复制代码
成功后,使用以下命令查看:
gem sources –l复制代码
可以看到替换镜像成功:
*** CURRENT SOURCES ***https://ruby.taobao.org/复制代码
接下来是真正的安装,在终端输入以下命令(如果 Ruby 版本过低,以下命令会报错):
sudo gem install cocoapods复制代码
如果 Ruby 版本过低导致无法安装,则运行以下命令进行升级:
curl -L get.rvm.io | bash -s stable // 安装 rvmsource ~/.bashrc // 更新source ~/.bash_profile // 更新ruby -v // 查看当前 ruby 版本rvm list known // 列出可安装版本rvm install 2.2 // 安装 ruby 2.2 版本复制代码
等待安装成功后使用以下命令配置 cocoapods:
pod setup复制代码
- 安装指定版本的cocoapod:
sudo gem install cocoapods -v 0.34.4复制代码
2、创建工程并配置第三方类库
- 首先打开 Xcode 新建一个工程,假设为 Desktop/CocoaPodsDemo ,并且我们要往该工程中导入 AFNetworking 这个类库。 AFNetworking 在 Github 中的地址为:https://github.com/AFNetworking/AFNetworking 这里也说明了如何使用CocoaPods配置该类库:
- 以上说明是我们应该如何书写 Podfile 文件。一般非常流行和成熟的类库都得到了 CocoaPods 的支持,并且有这个说明。如何确定 CocoaPods 是否支持我们想要加入的目标类库?使用
Search
命令搜索类库名:
pod search AFNetworking复制代码
如果 CocoaPods 支持,将会输出搜索到的所有类库版本和信息,以及在 Podfile 中配置的写法,例如:
3. 先看看普通的工程目录: 首先在我们的工程目录下创建 Podfile 文件,该文件用来控制 CocoaPods 的下载内容,该文件是没有后缀的,每个项目只需要一个 Podfile 文件,如果需要导入多个类库那么统一在该文件中书写下载内容。 创建过程:首先cd
到工程目录,然后创建 Podfile 并且使用 vim 编写: - 创建文件:
cd Desktop/CocoaPodsDemo/pod init # 自动创建 Podfile 文件,也可以使用 touch Podfile 手动创建 Podfile 文件复制代码
- 编写命令:
platform:ios, '7.0'pod "AFNetworking", "~>2.1"复制代码
Podfile 中的两句文字的意思是,当前 AFNetworking 支持的 iOS 最高版本是 iOS 7.0, 要下载的 AFNetworking 版本是2.1。 3. 在有了 Podfile 后,在 Podfile 文件所在目录下输入以下命令安装类库:
pod install复制代码
安装完成后,输出信息如下:
Analyzing dependenciesDownloading dependenciesInstalling AFNetworking (2.1.0)Generating Pods projectIntegrating client project [!] From now on use `CocoaPodsDemo.xcworkspace`.复制代码
最后一句表明,如果要正确打开工程我们应该打开最新生成的 .xcworkspace
文件。
3、编译运行
如果一个项目中已经包含了 CocoaPods 的配置文件,但是编译却出现错误,那么我们仅需要一行命令就可以配置好所有的第三方类库了:
pod update复制代码
4、仅添加要加入的库
pod install --verbose --no-repo-update复制代码
5、卸载
在终端运行:
sudo gem uninstall cocoapods复制代码