iOS 开发 - 亲身经历告诉你如何把自己的库通过pod导入(详细步骤)

原创 2016年09月08日 13:55:30

记得一次面试有人问我有没有自己开源一些库,有是有的,但是确没有制作成可以通过pods导入的库,此乃一大憾事,后来跟着网上很多教程在那里捣鼓了半天,真的是半天时间,压根没用,今天无意间看到一篇博客,http://www.jianshu.com/p/489520b69d8b,参考了一下,有用,但并不是最正确的,里面有许多你不知道的坑等着你在跳,按照上面的步骤,基本和我以前看的一样,最后还是不行,经过俩小时的摸索,根据一些报错来查找原因,最后终于解决了这个问题,下面是博主刚刚创建的库:
这里写图片描述
如果想要看具体功能可以看:https://github.com/codeliu6572/CustomAlertView

在看这个功能前,确定你会上传自己的项目代码到github,不会的可以看博主的文章:http://blog.csdn.net/codingfire/article/details/50387183
下面来介绍下如何把自己的库制作成可以通过pod导入的库:
上面那篇博客中的内容可以看下,为了保证正确,博主就重新在下面写命令:

1.用户名邮箱注册,为github的用户名和绑定邮箱(下面的内容替换为自己的):

pod trunk register codeliu6572@163.com 'codeliu6572' --verbose 

如果报错,一般是pod版本低或者ruby的版本低,这里不再说明解决办法,自行百度。

2.查看是否注册成功

pod trunk me  

这里写图片描述
这样的就代表注册成功。

3.创建 .podspec文件
这里一定要在工程中创建 .podspec文件,并把库文件放在一个文件中,看一下博主的:
这里写图片描述
LICENSE文件(必不可少)和README.md文件都要有,且必须和库问价放在一个目录。
创建方法:

pod spec create LHHAlertView

可以通过vim来打开文件操作,博主一般用电脑的文本编辑打开,打开后看到的内容有很多,博主只保留了基本的信息,如下:

//特别说明,里面的注释是博主为了大家知道什么意思加的,实际使用时一定要去掉
Pod::Spec.new do |s|
//文件名
s.name = 'LHHAlertView'
//版本
s.version = '1.0.1'
//描述信息
s.summary = 'A view like UIAlertView on iOS.'
//这里的主页自己随便写
s.homepage = 'http://blog.csdn.net/codingfire' 
//作者
s.authors = { 'codeliu6572' => 'codeliu6572@163.com' }
//资源路径
s.source = { :git => 'https://github.com/codeliu6572/CustomAlertView.git', :tag => '1.0.1' }
//ARC模式
s.requires_arc = true
//license,一般我们用MIT
s.license = 'MIT'
//允许的最低系统使用版本
s.ios.deployment_target = '7.0'
//库文件路径
s.source_files = 'LHHAlertView/*'
end

因为这里没有第三方库和系统库的引入,下面有个新的格式:

这里是博主提交的新的库,供大家参考,每次通过编辑器打开修改时引号
都会改变,需要注意,所以每次都需要重新复制正确的引号来替换变更
的,小修改可以用vim打开,这样引号就不会变了,升级版本时,需要打
tag,记得从打tag那一步开始,第一次会输入账号密码,以后会提示授
权,允许即可。每次修改后记得一定要同步到github再继续下一步操
作。


除了下面的一些资源文件导入外,还有第三方的支持,xib等的支持,详细信息请查看:https://guides.cocoapods.org/syntax/podspec.html#specification
//特别说明,里面的注释是博主为了大家知道什么意思加的,实际使用时一定要去掉
Pod::Spec.new do |s|

  s.name         = 'LHHTopScrollView'
  s.version      = '1.0.5'
  s.summary      = 'A banner for iOS.'

  s.homepage     = 'http://blog.csdn.net/codingfire/article/details/52470802'



  s.license      = "MIT"

  s.ios.deployment_target = '7.0'
  s.author       = { 'codeliu6572' => 'codeliu6572@163.com' }

  s.source       = { :git => 'https://github.com/codeliu6572/ScrollVIewBanner.git', :tag => '1.0.5' }



  s.source_files  = "LHHTopScrollView/*.{h,m}"


  s.resources = "LHHTopScrollView/*.png"
如果有多个,后面加逗号隔开如: 'UIKit''XXXXXX'
  s.framework  = 'UIKit'
  s.requires_arc = true

  s.dependency 'SDWebImage'

end

这里s.source的git地址看下图:
这里写图片描述
另外这里再说一个坑:
这里写图片描述
这里的单引号注意看了,是不一样的,下面的很明显能看出来和上面圈起来的不同,用上面的那种,博主试了下,打不出来,那就复制,否则报错,编辑通不过。切记!!!

4.验证编辑是否通过

pod lib lint LHHAlertView.podspec

这里写图片描述
以上为通过截图,只要按照博主的步骤来,这一步肯定可以通过的。

后来博主在使用时又报错了,信息如下:

- ERROR | [iOS] xcodebuild: Returned an unsuccessful exit code. You can use `--verbose` for more information.
- ERROR | xcodebuild:  /Users/Codeliu/Desktop/程序/VoiceLight/LHHVoiceLight/VoiceLight.h:11:9: error: 'Masonry.h' file not found with <angled> include; use "quotes" instead
第一个错误博主怎么找也没找到,最后查找到原因是因为博主创建文件时第一次创建错了,把继承与NSObject的类手动改成了UIView,重新创建后不再报错;
第二个错误是因为Masonry在引入时系统提示我这么引入#import <Masonry.h>,应该是#import "Masonry.h",但是这样系统报错,这是因为pods的缘故,build setting->ALways Search User Path ,设置为YES即刻。

5.打上tag,并提交到github

这里打tag一定要加上v,否则会出错
事实证明这里加不加v都没关系,但是有一点,tag一定要和podspec文件中的tag一摸一样。至于有其他的写法,博主尝试过但是有问题,也许还有没常识的,就不乱下结论了,按照博主提供的方法来写不会有错。

git tag 'v1.0.1'
git push --tags

tag打错了并已提交的
git tag -d xxx    //删除本地tag
接着
git push origin --delete tag xxx  //删除远程tag,然后重新打tag

提交时会提示输入账号密码,按照自己的github的账号密码来输入。

成功后:
这里写图片描述

6.把podspec文件提交到github的库仓库中

pod trunk push LHHAlertView.podspec 

//如果有警告 后面加 --allow-warnings

这一步有可能会因为pods版本低而失败,根据提示信息更新pods

成功后截图:
这里写图片描述

7.搜索提交的库

pod search LHHAlertView

然后就看到一开始的那张图了。

这里再啰嗦几句,以博主的这个Demo为例,Demo里面已经有了库文件,但是在Demo同等级的目录中依然要放一个库文件,目前博主成功的文件目录就是这样的,podspec文件一定要和库文件在一个目录中,其他注意事项每一步都有介绍,一定要注意。

总结:要把自己的库制作成通过pods导入还是有一定难度的,网上很多方法看着跟博主这里差不多,其实命令都一样,但是却有明显的不同,那就是细节部分,比如引号,打tag时的v,目录结构等等,稍有不慎就可能通不过编辑,就说这么多,如果遇到问题,欢迎加群讨论。

后来遇到的坑:
1.通过代码创建的podspec文件里面都是双引号,博主用的都是单引号,经测试,无影响,还有UIKIT等库和第三方库的引入,以及版本升级,这一部分已经放在这里
2.发现一个问题,如果你在某个库中用了NSInteger,会报警告,原因是:typedef long NSInteger;类似这种情况的还有别的,如果遇到你可以替换成像这里应该是long,也可以选择忽略警告,比如:pod trunk push ScrollSliderView.podspec –allow-warnings;
3.有时候在push时会遇到这样的报错:[!] There was an error pushing a new version to trunk: Net::OpenTimeout 不要惊慌,仅仅是因为网络不好没有push成功,不妨再试一次。

版权声明:本文为博主原创文章,未经博主允许不得转载。

相关文章推荐

‘ ’ file not found with <angled> include; use “quotes” instead

1.我把第三方库copy到自己库里面时,报出这样的错误 file not found with angled include。。。 2。这个通常是没有设置头文件,去设置下头文件就好了 3.将对...

'filename.h' file not found with <angled> include, use "quotes" instead. 问题详解

http://stackoverflow.com/questions/17465902/use-of-external-c-headers-in-objective-c 下面 有个解释的设置步骤...
  • jeffasd
  • jeffasd
  • 2016年04月02日 13:00
  • 4269

libxml2.dylb 导致<libxml/tree.h> 老是找不到头文件

添加了libxml2.dylb的framework ,结果还是引用不了,  老是提示找不到头文件。 这个问题其实比较容易解决,但是XCode的版本问题确实让开发者头疼。 在Xcode4,2之后,可...
  • dqjyong
  • dqjyong
  • 2012年08月04日 16:56
  • 18758

app集成支付宝报错:"openssl/asn1.h file not found"

更新了支付宝SDK,更新过程出出现"openssl/asn1.h file not found"这个错误 解决方法是在Build Setting 中 选中Search Paths选项,在Heaser...

Xcode6 编译静态库.a文件(比如cocospad)始终为红色,但显示编译成功。

解决办法:这是xcode的一个bug,先将编译模式设置为device,编译成功,再切换回simulator模式即可编译simulator对应的.a文件,路径为  /Users/${user_na...

libPods.a的神秘面纱--使用CocoaPods来做iOS程序的包依赖管理

前言 每种语言发展到一个阶段,就会出现相应的依赖管理工具, 或者是中央代码仓库。比如 Java: maven,IvyRuby: gemsPython: pip, easy_installN...

iOS import导入pod第三方库不提示问题

pod 导入第三方库后,使用import 不提示第三方库头文件。 解决办法: 选择target -> BuildSettings -> search Paths 下的 User Header Sear...

iOS开发~CocoaPods使用详细说明

转自:http://blog.csdn.net/showhilllee/article/details/38398119 一、概要 iOS开发时,项目中会引用许多第三方库,CocoaP...
  • gf771115
  • gf771115
  • 2015年12月25日 15:01
  • 14286

CocoaPods详解之----进阶篇

CocoaPods详解之----进阶篇 作者:wangzz 原文地址:http://blog.csdn.net/wzzvictory/article/details/18737437 转载请注...

CocoaPods 使用本地仓库

CocoaPods 使用本地仓库背景* 有的时候我们的一些代码不是开源的,或者暂时不想放到 Github 上。我们更想使用 CocoaPods 引用本地的代码;* 对 spec 进行修改, 希望通过本...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:iOS 开发 - 亲身经历告诉你如何把自己的库通过pod导入(详细步骤)
举报原因:
原因补充:

(最多只允许输入30个字)