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命令在终端进行模糊搜索:

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 第四次修订

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • CocoaPods 是什么? CocoaPods 是一个负责管理 iOS 项目中第三方开源库的工具。CocoaPo...
    朝洋阅读 25,771评论 3 50
  • Ruby 安装 要安装cocospods 首先需要安装ruby,可以先安装xcode,再安装macport ,最后...
    山天大畜阅读 1,911评论 0 1
  • 项目组件化、平台化是技术公司的共同目标,越来越多的技术公司推崇使用pod管理第三方库以及私有组件,一方面使项目架构...
    swu_luo阅读 22,366评论 0 39
  • 一. CocoaPods的介绍 什么是CocoaPods?CocoaPods是一个负责管理iOS项目中第三方开源库...
    辉712阅读 4,018评论 0 7
  • 内份感情,随时间慢慢的变成了一种习惯,感觉就像日常不会缺失的部分。。。可是分开了,再怎么不适应,却也回不去了,不是...
    穀咚咚咚阅读 102评论 0 0