有两种方法创建:手动 / 半自动
半自动
CocoaPods贴心的给了个命令可以自动生成包括license,gitignore,demo在内的一整套文件
$pod lib create 项目名
What language do you want to use?? [ Swift / ObjC ]
>ObjC
Would you like to include a demo application with your library? [ Yes / No ]
> Yes
Which testing frameworks will you use? [ Specta / Kiwi / None ]
> None
Would you like to do view based testing? [ Yes / No ]
> No
What is your class prefix?
> 你类名的前缀
完成后项目会自动打开,左边找到podspec,按照文件里的注释修改podspec文件
然后开始写你的pod,在development Pods里有个replaceMe.m,把自己的类替换到那里就可以啦
写完之后commit, 打tag, push到远程,tag要与podspec上的s.version保持一致
然后cd到podspec所在目录
pod lib lint
作用是验证你刚才写的pod是否通过验证
➜ git:(master) pod lib lint
-> Test (0.1.0)
Test passed validation.
验证通过后cd到podspec所在目录
pod repo push 远程repo库名
这个是上传到私有的服务器上,如果要上传至CocoaPods官方库的话:CocoaPods官网
这样别人就可以用啦~~
so easy 对不对?
下面给大家介绍手动创建,前方多坑预警
手动
一开始,我也是照着网上的教程来,找了两篇,差不多都是根据已有项目添加,所以基本上是这种步骤:
1. 先把项目push到远程 / 或从远程clone到本地
2. 直接创建podspec文件
pod spec create 名字
3. 创建演示代码
如果想让别人方便的用你的pod,一个demo是少不了的,这种直接创建podspec的话就必须对前面的项目做很多修改,而且你自己也想检验一下自己写的pod用起来怎么样不是么,我前面看到的两篇文章里面根本就没提这一点给我当时造成了很大的困扰。
3.1 修改项目结构
为了接下来pod install时更容易的找到你正在开发的pod,建议在项目根目录下创建一个Example文件夹并把测试项目全丢进去,并创建一个与pod同名的文件夹,用来存放pod的类和资源。
3.2 修改podfile
添加pod 'pod名字', :path => '../'
3.3 开发、修改
此时才算是跟我们平时用的pod有些类似了,可以在项目中import我们自己的pod,不过xcode会报错,
import<Test/Test.h>
这样子import后并重新pod install一下就ok了
4. 验证,发布
这里就和上面说的差不多了,pod与demo写好后,pod lib lint
验证通过后pod repo push
然后... 以为大功告成了对不对,其实这种手动创建的坑就在这里,可能在lint验证的时候就会遇到一堆的错误(起码我是这样 - -!)
可能会遇到的问题:
- WARN | [iOS] license: Unable to find a license file
- ERROR | [iOS] xcodebuild: Returned an unsuccessful exit code. You can use `--verbose` for more information.
- ERROR | xcodebuild: /Users/me/Documents/Test/Test.m:10:9: error: 'RMessage.h' file not found with <angled> include; use "quotes" instead
- ERROR | xcodebuild: /Users/me/Documents/Test/Test.m:11:9: error: 'RMessageView.h' file not found with <angled> include; use "quotes" instead
- ERROR | [OSX] unknown: Encountered an unknown error (The platform of the target `App` (OS X 10.6) is not compatible with `RMessage (2.1.2)`, which does not support `osx`.) during validation.
当时看到这一堆错误那心情...
第一个警告说没有license,在lint时可以加速--allow-warings给忽略,问题不大
最后一个是因为在podspec里面没有指定平台,指定了就好了
中间那几个错误,好像是因为我当时直接导入导致的,具体也忘了当时怎么修改的
都改好之后加上允许警告终于lint通过了,然后push,甩一甩手心的汗,想着终于没问题了,哎,还是换台电脑试一下吧,然后发现...
pod install时提示
Your Podfile has had smart quotes sanitised
还发现没有gitignore...
然后我就是此时决定,用上面的半自动方法,重新来过的
网友评论