Pod库的制作组件化

pod安装及使用说明,制作自己的代码库,并发布到pod

2017-02-08  本文已影响597人  10m每秒滑行

一、安装

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文件

图2

s.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 图5

2.自己的代码库创建成功后,克隆到本地,添加自己的文件到本地代码仓库,然后向远程仓库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审核

上一篇下一篇

猜你喜欢

热点阅读