打开Mac自带“终端”
在Launchpad找到“其他”软件文件夹,找到终端打开。
2
替换Ruby的默认源,移除https://rubygems.org/,添加淘宝的https源
gem sources --remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/
如果之前安装有http://ruby.taobao.org/,则需要移除http的淘宝源:
gem sources --remove http://ruby.taobao.org/
3
验证是否成功替换Ruby的默认源
gem sources -l
4
更新Mac 的Gem,Gem是管理Ruby库和程序的标准包
sudo gem update --system
或者(Mac OSX 10.11之后)
sudo gem update -n /usr/local/bin —system
然后输入管理员权限密码(看不到输入结果的,输完密码之后直接回车)
5
完成安装CocoaPods
sudo gem install cocoapods
或者(Mac OSX 10.11之后)
sudo gem install -n /usr/local/bin cocoapods
END
为iOS项目添加CocoaPods管理库
1
查找自己需要添加的第三方库
pod search + 库名
如输入:pod search AFNetworking 后,等待返回所有符合搜索条件的结果。可以直接利用的是:pod 'AFNetworking', '~> 3.1.0'
2
找到项目文件路径
在终端输入cd+空格,然后拖动项目文件夹到终端,自动生成路径。
3
创建并编辑Podfile文件(可以终端操作,也可以直接手动操作)
终端输入:vim podfile
编辑文件,没有文件就自动在当前目录添加一个文件再编辑。输入内容:
platform :ios, '8.0'
target “target名称” do
pod 'AFNetworking', '~> 3.1.0'
end
按Esc退出编辑,然后按Shift +冒号,输入wq退出文件编辑。
4
为项目导入第三方库和相关依赖库
终端输入:pod install
然后耐心等待下载第三方库,如果文件大,可能要花长时间。终端会打印进度的。
5
至此,添加已经完成。可以看到项目目录里面多了4个文件,以后运行工程都使用.xcworkspace文件,而不再用.xcodeproj了。
END
移除CocoaPods
1
编辑Podfile文件,清除里面所有库,然后终端输入:pod install。这时会清空第三方库和相关依赖库。
2
删除之前的4个文件,Podfile、Podfile.lock、Pods文件夹和.xcworkspace文件。
3
然后打开.xcodeproj,删除项目中的libpods.a和Pods.xcconfig引用。
4
TARGETS - Build Phases 删除有关pods的选项,至此完成删除。
END
常见问题
Error fetching http://ruby.taobao.org/:
bad response Not Found 404 (http://ruby.taobao.org/specs.4.8.gz)
说明:
链接不到Ruby淘宝源,常见的404错误,可能因为https替换http了。所以gem sources -a http://ruby.taobao.org/需要替换成:gem sources -a https://ruby.taobao.org/
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/update_rubygems
说明:
Mac OSX 10.11不能使用sudo gem update —system了,需要替换成:sudo gem update-n /usr/local/bin —system
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/pod
说明:
Mac OSX 10.11不能使用sudo gem install cocoapods了,需要替换成:sudo gem install -n /usr/local/bin cocoapods
[!]
Unable to add a source with url
`https://github.com/CocoaPods/Specs.git` named `master-1`. You can try
adding it manually in `~/.cocoapods/repos` or via `pod repo add`.
说明:
由于安装了多个Xcode导致路径变了,需要变换路径:sudo xcode-select -switch /Applications/Xcode6.4/Xcode.app
The dependency `` is not used in any concrete target
说明:
Podfile升级之后到1.0.0版本,Pod里的内容必须明确指出所用第三方库的target,所以在podfile文件需要明确:
target “YOUR_TARGRT_NAME” do
...
end
6
Error installing cocoapods:activesupport requires Ruby version >= 2.2.2.
说明:
在安装cocoapods过程中提示需要Ruby的版本在2.2.2以上。
查看当前Ruby版本,输入指令:ruby -v
解决方法:
通过rvm安装新版Ruby,输入指令:curl -L get.rvm.io | bash -s stable
重装rvm,输入指令:rvm reload
然后安装Ruby,输入指令:rvm install ruby
如果出现:Requirements installation failed with status: 1.则需要输入:
第一行:ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
第二行:rvm autolibs read-only # read more here:https://rvm.io/rvm/autolibs
第三行,再次安装:rvm install ruby
然后终端就疯狂的开始下载了。