王若风的技术博客

世界尽头の冷酷仙境

0%

CocoaPods 使用指南

发表于 更新于 分类于 Disqus：
本文字数： 665 阅读时长 ≈ 2 分钟

简介

CocoaPods 是 iOS 最常用的第三方类库管理工具，绝大部分有名的开源类库支持 CocoaPods。

CocoaPods 是用 Ruby 实现的，要使用它首先需要有 Ruby 的环境。

安装

幸亏 OS X 系统默认已经可以运行 Ruby 了，我们只需执行以下命令：

1
sudo gem install cocoapods

由于某些原因，执行时会出现下面的错误提示：

1
2
3
4
ERROR :Could not find a valid gem  `cocoapods`  (>= 0), here is why:
        Unable to download data from https://rubygems.org/ - Errno::EPIPI:
        Broken pipe - SSL_connect
(https://rubygems.org/lastest_specs.4.8.gz)

安装成功后，接着执行命令：

1
pod setup

如果 Ruby 环境不够新，可能需要更新以下：

1
sudo gem update --system

至此安装就完成了，我们可以尝试搜索一个第三方类库：

1
pod search AFNetworking

使用

使用 CocoaPods 第一步，是在当前项目下，新建一个 Podfile 文件：

1
touch Podfile

然后利用 vim 打开 Podfile 文件编辑，加入你想要的类库，格式如下：

1
2
3
4
5
6
platform :ios
pod  'Reachability', '3.1.0'

platform :ios, '6.0'
pod 'JSONKit', '1.4'
pod 'AFNetworking', '~> 2.3.1'

如果是拷贝别人的项目，或是一个很久没打开过的项目，可能需要先执行一下：

1
pod update

最后一步，执行命令：

1
pod install

当终端出现类似下面的提示后，就代表成功了：

1
[!] From now no use  `Sample0814.xcworkspace` .

这个时候会看到项目文件夹多了一个 xxx.xcworkspace,以后要通过这个文件
打开项目，老项目 xxx.xcodeproj 不再使用。

  1. 上面的每一步都可能出现问题，但大部分问题都是因为局域网的原因，用一个网速稳
    定的境外 VPN 可破
  2. 如果上面因为权限问题安装失败，必须每次都要删除
1
rm -rf /User/loginname/Library/Caches/CocoaPods/

因为这个缓冲中会存下你的 github 的东西，造成每次调用上次权限问题的缓存。

  1. 关于 Podfile 文件编辑时，第三方版本号的各种写法:
1
2
3
4
5
6
7
8
9
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 的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本

参考资料