CocoaPods使用和搭建环境

打开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

然后终端就疯狂的开始下载了。

你可能感兴趣的:(CocoaPods使用和搭建环境)