pod安装及使用说明,制作自己的代码库,并发布到pod
一、安装
1.网上教程有太多,先来一个CocoaPods的安装与使用(一)[http://www.jianshu.com/p/13cb4937108a]
注意:安装之前先确认电脑上之前是否安装过pod,执行命令pod —version
安装简要步骤:
1.查看镜像
$ gem sources -l
2.若是ruby的https://rubygems.org/则需要换成淘宝的,如本来就已经是淘宝的(https://ruby.taobao.org/),就不用换了
更改的方式为:
a.$ gem source -rhttps://rubygems.org/
b.$ gem source -ahttps://ruby.taobao.org/
3.查看是否替换成功:
$ gem sources -l
4、安装cocopods
$sudo gem install cocoapods(步骤有点慢,不要急)
2. 如果安装过,实用当前pod 执行install 或者update老是失败,但其他人install和update能成功,可能是本地pod做过不干净的操作,
被损坏,可以卸载本地pod,重新安装,卸载重装的教程也很清楚:cocopods卸载、安装、重装等问题解决[http://blog.csdn.net/qtds8810/article/details/50510910](重装解决90%问题)
卸载关键步骤:
二.简单的pod file文件
先是最简单的例子,针对测试的简单工程
target : test do
pod'OCMock','~> 2.0.1'
end
再到复杂一点的,
source'https://github.com/CocoaPods/Specs.git'//可以不要
platform:ios,‘6.0’//可以不要inhibit_all_warnings!//可以不要
xcodeproj'MyProject'//路径对的话,可以不要
pod'ObjectiveSugar','~> 0.5'
target : test do//target必须要
pod'OCMock','~> 2.0.1'
end
pod install 或者 pod update 失败了跟第三方库有没有关系?
测试:
1.向pod仓库中提交了一个自己的podspec文件,podspec文件中指向gitHub上一些项目文件,故意在文件中写了一些编译不过的语法,首先实用pod spec lint 命令去检验podspec文件的有效性时,在debug信息中发现输出了Xcode的编译信息,提示了语法的warnning,但还是通过了。
2.将这个自己的第三方库引入到测试工程的podfile中,再执行pod update 操作时任然成功了。
结论:pod install 和pod update 失败与第三方库的文件无关
三、podSpec文件的结构
1.先从简单的例子来看清文件的结构
图1例. AFNetWorking.podSpec文件
图2s.name:名称,pod search 搜索的关键词
s.version:版本
s.summary:简介,pod search 搜索的关键词
s.homepage:主页地址,例如Github地址
s.license:许可证
s.author:作者
s.social_media_url:社交网址
s.platform:平台
s.source:Git仓库地址,例如在Github地址后边加上 .git 就是Git仓库地址,常见写法如下
s.source_files:需要包含的源文件,常见的写法如下
s.resources:需要包含的图片等资源文件
s.dependency:依赖库,不能依赖未发布的库
s.dependency:依赖库,如有多个可以这样写
s.requires_arc:是否要求ARC
s.source_files 常见写法
[
"Directory1/*”,
"Directory1/Directory2/*.{h,m}”,
"Directory1/**/*.h”
]
“*” 表示匹配所有文件
“*.{h,m}” 表示匹配所有以.h和.m结尾的文件
“**” 表示匹配所有子目录
s.source 常见写法
s.source = { :git=>"https://github.com/xiaofei86/LPPushService.git", :commit=>"68defea"}
s.source = { :git=>"https://github.com/xiaofei86/LPPushService.git", :tag=>1.0.0}
s.source = { :git=>"https://github.com/xiaofei86/LPPushService.git", :tag=>s.version }
commit => "68defea" 表示将这个Pod版本与Git仓库中某个commit绑定
tag => 1.0.0 表示将这个Pod版本与Git仓库中某个版本的comit绑定
tag => s.version 表示将这个Pod版本与Git仓库中相同版本的commit绑定
四、pod使用过程中常见报错
检测podSpec文件错误
1.语法错误
如果是因为语法错误,验证失败后会给出错误的准确定位
[!] Invalid `LPPushService.podspec`file: no . floating literal anymore;put0beforedot s.version= “1.0.0” ^LPPushService.podspec:5: syntaxerror, unexpected tFLOAT, expecting '(' s.version= “1.0.0” ^
标记“^”的地方即为有语法错误的地方。
2.依赖错误
但是,有些非语法错误是不会给出错误原因的。这个时候可以使用“--verbose”来查看详细的验证过程来帮助定位错误。
pod spec lint LPPushService.podspec--verbose
如下错误通过 --verbose 就可以找到原因。
-> LPPushService (1.0.0) - ERROR | [iOS] Encountered an unknown error (The'Pods'target has transitivedependenciesthatincludestaticbinaries: (/private/var/folders/jz/b_m3k7ln47524cm__h3__mk00000gn/T/CocoaPods/Lint/Pods/BPushSDK/LibBPush/libBPush.a)) during validation.
这个错误是因为依赖库(s.dependency)包含了.a静态库造成的。虽然这并不影响Pod的使用,但是验证是无法通过的。可以通过 --use-libraries 来让验证通过。
podspeclintLPPushService.podspec--verbose--use-libraries
这种情况下使用 --use-libraries 虽然不会出现错误(error),但是有时候会带来一些警告(waring),警告同样是无法通过验证的。这时可以用 --allow-warnings 来允许警告。
podspeclintLPPushService.podspec--verbose--use-libraries--allow-warnings
安装错误
如果在其他项目 pod install 的过程中,出现包含“undefined method `end_with?' for nil”字样的报错。进入“~/.cocoapods/repos”目录,删除“master”,并将 master-1 改为 master 即可。
如果出现如下错误,而你的验证可以通过,那么一般更新下版本号就可以解决。
[!] Unabletofinda specificationfor'LPPushService'.
五、制作自己的pod库
1.在github上创建自己的项目库
图3 图4 图52.自己的代码库创建成功后,克隆到本地,添加自己的文件到本地代码仓库,然后向远程仓库push代码
1. git clonehttps://github.com/13554175559/TestPodSpec.git2. cd TestPodSpec3. git add a.file4. git commit -am “add files”5. git push6. git tag 0.0.17. git push origin 0.0.1
3.然后就可以创建库所对应的podSpec文件了
打开terminal在自己的库的根目录下执行
pod spec create TestPodSpec
然后就可以编辑产生的TestPodSpec.podspec 文件了,编辑时参考上面的-》三、podSpec文件的结构
4.验证pod spec文件的有效性
在terminal中进入库的根目录,执行
pod spec lint TestPodSpec.podspec —allow-warnings
中间如果验证失败的话,需要根据error信息提示来改正。
5.验证通过了就可以准备发布了
先注册发布帐号 ,
pod trunk register[邮箱XXXXXX@163.com]“名字”
注册完了去邮箱瞅一眼,激活一下
发布:
pod trunk push TestPodSpec.podspec --allow-warnings
会看到如下提示
🎉congratulations ……..
然后在本地 pod search 就可以找到之前提交的库了,如果要在别人的电脑上也能搜到的话,需要等pod审核