CocoaPods小记

2015-12-29  本文已影响259人  a_超

最近Mac 10.13又出了个小坑,更新完之后POD就不能用了,只能重新安装一次。

安装


因为Mac OS El Capitan操作权限的问题我们在安装pods的时候需要指定一个路径,比如usr/local/bin,另外就是网络封锁的问题最好是将原本的ruby源修改以下。

setup的过程可能很慢,主要是因为第一次安装它会去下载repo库,这玩意儿有几百兆接近1个G,如果有其他小伙伴的电脑已经安装好了,可以直接从 ~/.cocoapods/ 里面拷贝过来。

gem sources --remove https://rubygems.org/

gem sources -a https://gems.ruby-china.com/

sudo gem update -n /usr/local/bin --system

sudo gem install -n /usr/local/bin cocoapods

pod setup

更新


如果发现Pods上搜索出来的代码库与GitHub上面的不同步,可以尝试更新下Pods的repo库。

pod repo update

如果是想更新pods的版本,可以通过类似重新安装的形式。

sudo gem update -n /usr/local/bin  --system

sudo gem install -n /usr/local/bin cocoapods

pod setup

卸载


用uninstall命令就可以卸载pods了。

sudo gem uninstall -n /usr/local/bin cocoapods

如果你安装了多个Pods版本,这时候就需要选择一个要卸载的版本:

Select gem to uninstall:

1. cocoapods-0.37.2

2. cocoapods-0.39.0

3. All versions

> 3

使用


Pods的使用方式很简单,不过需要注意字符编码的问题,UTF-8。打开终端进入到你的工程目录(与.xcodeproj文件同级),使用vim命令创建pod管理文件:

cd /具体工程路径

vim podfile

按 i 键进入编辑模式,键入(platform和 : 之间是要有空格的):

platform :ios, '7.0'

target "项目名" do

     pod 'AFNetworking'

end

target xxx do xxx end 的书写方式是在pod 1.0.0之后出现的,现在都是按这种形式了。按esc键退出编辑模式,键入 :wq 回车结束编辑。接下来搜索你想要的库,比如需要引入AFNetworking库,则可以使用search命令在终端进行模糊搜索:

pod search AFNetworking

AFNetworking搜索结果

红色方框的部分是住重要的,版本号可以根据需要选择,具体的格式就是

pod '第三方库名称', '~> 版本号'

再次采用vim命令打开podfile文件,按 i 键进入编辑模式,新起一行键入

pod 'AFNetworking', '~> 3.0.0-beta.2'

按esc退出编辑模式,键入 :wq 结束编辑,重点来了。

pod install

install命令执行之后,就会根据你podfile里面的配置开始载入第三方库,同时会在同级目录生成一个 .xcworkspace 文件,以后的项目入口就是这个文件了。

有了这个文件之后,如果想要再编辑podfile文件,就可以直接在xcode里面开干了,只是install命令还是得在终端执行。

需要注意的是,podfile文件的编码格式一定要是UTF-8的,并且每次新增或删除一个第三方库都要执行一次install命令才会生效。

小坑


1. 如果你的项目使用POD管理,并且用到了某个库(比如A),后面又把A库给删除了,编译出现Apple Mach-O link Error的话,可以把项目中的other link flag中的值都删掉,只保留$(inherited)。

2. 如果安装遇到『ERROR:  While executing gem ... (TypeError) no implicit conversion of nil into String 』这种错误,需要先更新下system,Mac10.13之后需要用-n来指定路径。

sudo gem update -n /usr/local/bin --system

后记


总的来说Pods还是很方便的,被Pods管理的第三方库通常会被锁定禁止修改,如果你想要修改第三方库也不是不行,不过对于这种库主页君则是倾向于采用手动导入的方式,避免后面升级库时带来麻烦。

如果你的项目一开始就采用Pods来管理,那就没什么问题。如果是旧项目改造,则需要在other link flag中配置上$(inherited)参数,否则会编译失败。


主页君于 2018.02.23 第四次修订

上一篇下一篇

猜你喜欢

热点阅读