CocoaPods小记
最近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命令在终端进行模糊搜索:
AFNetworking搜索结果pod search 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 第四次修订