首页 > 代码库 > cocoapods的安装和使用
cocoapods的安装和使用
首先安装gem环境
苹果自带ruby环境
a 查看下当前ruby版本:打开终端输入 ruby -v(可以先更新下ruby)
b 更新ruby
终端输入如下命令(把Ruby镜像指向taobao,避免被墙,你懂得)
gem sources --remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/
gem sources -l (用来检查使用替换镜像位置成功)
打开终端输入 ruby -v
搭建CocoaPods环境
1
打开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
安装和使用cocoapods
// 安装
sudo gem install cocoapods
// 进入项目
~ zhangdefu$ cd /Users/zhangdefu/Documents/DFWeiBo/WeiBo
pod init
看到 Podfile文件 ,把该文件拖到Xcode中打开
# Uncomment the next line to define a global platform for your project
# platform :ios, ‘9.0‘
target ‘WeiBo‘ do
# Comment the next line if you‘re not using Swift and don‘t want to use dynamic frameworks
use_frameworks!
pod ‘AFNetworking‘
pod ‘SVProgressHUD‘
#end 不能少
end
注意: Podfile文件的 end不能删除
之后 pod install 就可以了
zhangdefudeMacBook-Pro:WeiBo zhangdefu$ pod update
以后碰到新的版本制药 pod update
cocoapods的安装和使用