CocoaPods安装使用说明
一、概要
iOS开发时,项目中会引用许多第三方库,CocoaPods(https://github.com/CocoaPods/CocoaPods)可以用来方便的统一管理这些第三方库。
二、安装
由于网上的教程基本都大同小异,但细节之处还不是很完善,所以借机会在这里补充下:
注:要使用CocoaPods,那就要下载安装它,而下载安装CocoaPods需要Ruby环境
1、Ruby环境搭建
当前安装环境为Mac mini 10.8.5。Mac OS本身自带Ruby,但还是更新一下保险,因为我第一次安装在没有更新Ruby的情况下就失败了。
- 查看下当前ruby版本:打开终端输入 ruby -v(确实安装了,不过用这个版本接下来工作失败了,所以更新下ruby)
zhouhaodeMacBook-Air-2:~ zhouhao$ ruby -v
ruby 2.0.0p645 (2015-04-13 revision 50299) [universal.x86_64-darwin15]
zhouhaodeMacBook-Air-2:~ zhouhao$
- 更新ruby
终端输入如下命令(把Ruby镜像指向taobao,避免被墙,你懂得)
gem sources --remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/
gem sources -l (用来检查使用替换镜像位置成功)
zhouhaodeMacBook-Air-2:~ zhouhao$ gem sources --remove https://rubygems.org/
https://rubygems.org/ removed from sources
zhouhaodeMacBook-Air-2:~ zhouhao$ gem sources -a https://ruby.taobao.org/
https://ruby.taobao.org/ added to sources
zhouhaodeMacBook-Air-2:~ zhouhao$ gem sources -l
*** CURRENT SOURCES ***
https://ruby.taobao.org/
zhouhaodeMacBook-Air-2:~ zhouhao$
2 、下载安装CocoaPods终端输入:
sudo gem install cocoapods
zhouhaodeMacBook-Air-2:~ zhouhao$ sudo gem install cocoapods
Password:
Successfully installed cocoapods-0.39.0
Parsing documentation for cocoapods-0.39.0
1 gem installed
zhouhaodeMacBook-Air-2:~ zhouhao$
这样就下载安装好了CocoaPods
3、使用CocoaPods
-
新建一个项目,名字PodTest
- 终端中,cd到项目总目录(注意:包含PodTest文件夹、PodTest.xcodeproj、PodTestTest的那个总目录)
zhouhaodeMacBook-Air-2:~ zhouhao$ cd Desktop/PodTest/
-
建立Podfile(配置文件)
接着上一步,终端输入 vim Podfile
键盘输入 i,进入编辑模式,输入
platform :ios, '7.0' pod 'MBProgressHUD', '~> 0.8'
然后按Esc,并且输入“ :”号进入vim命令模式,然后在冒号后边输入wq
回车后发现PodTest项目总目录中多一个Podfile文件
确定终端cd到项目总目录,然后输入 pod install,等待一会,大约3分钟。
zhouhaodeMacBook-Air-2:PodTest zhouhao$ pod install
Updating local specs repositories
CocoaPods 1.0.0.beta.4 is available.
To update use:\`gem install cocoapods --pre\`
[!] This is a test version we'd love you to try.
For more information see http://blog.cocoapods.org
and the CHANGELOG for this version http://git.io/BaH8pQ.
Analyzing dependencies
Downloading dependencies
Installing MBProgressHUD (0.9.2)
Generating Pods project
Integrating client project
[!] Please close any current Xcode sessions and use \`PodTest.xcworkspace\` for this project from now on.
Sending stats
Pod installation complete! There is 1 dependency from the Podfile and 1 total
pod installed.
zhouhaodeMacBook-Air-2:PodTest zhouhao$
查看项目根目录
查看项目根目录
4、注意:现在打开项目不是点击 PodTest.xodeproj了,而是点击 PodTest.xcworkspace
打开项目后看到项目结构并且测试一下, 发现MBProgressHUD已经存在了
补充:
1、CocoaPods的基本安装及使用都详细的说明了,但还有一些补充,当需要同时导入多个第三方时候怎么办 ?
这就需要修改Podfile了,就是用vim编辑的那个保存在项目根目录中的文件,修改完了Podfile文件,需要重新执行一次pod install命令。
例如:
platform :ios
pod 'JSONKit', '~> 1.4'
pod 'AFNetworking', '~> 2.0'
2、CocoaPods可以查找你想要的第三方库,终端输入命令:pod search UI
然后重新编辑Podfile文件,按照之前的步骤,把更多的库都导入项目!