iOS:SDK开发「一」

image.png

iOS开发中的SDK大多数都依赖cocoapods来管理,本篇讲解如何创建一个最简单的pod库,并上传至cocoapods

1.创建

pod lib create YSTPayKit

image.png

1.1创建过程中会提示初始化配置

使用什么语言,这里使用ObjC

What language do you want to use?? [ Swift / ObjC ]
 > ObjC

是否引入一个demo工程,通常选择是,一方面是方便测试,一方面将来提供给其他开发者也能方便他人学习如何使用这个库

Would you like to include a demo application with your library? [ Yes / No ]
 > Yes

选择哪个测试框架,我这里不需要就None

Which testing frameworks will you use? [ Specta / Kiwi / None ]
 > None

我不要基于视图的测试就No

Would you like to do view based testing? [ Yes / No ]
 > No

输入你的前缀,这个前缀是用在测试demo中的,不能为空,我这里就用了MR,写一个自己喜欢的就好

What is your class prefix?
 > MR 

2.工程结构

image.png

Example for YSTPayKit就是demo工程,和一个普通iOS工程一样,就是文件名多了前缀

image.png

pods中就是各种三方库,其中自己要开发的就在Development Pods中,自己的代码也写在这里

image.png

配置文件.podspec非常重要!非常重要!非常重要!
整个库的配置都在里头,配置内容讲解篇幅较大
详情请看podspec配置详解

image.png

3.发布SDK

发布SDK的本质是把podspec这个文件发布到cocopods上,前提是要通过编译检查.

• 注册,建议科学上网,不然可能注册失败

pod trunk register yourEmail "name"

• 如果已经注册过可以查看自己的信息

pod trunk me

可以看到自己的名字,邮箱,已经属于自己的Pods和之前的登陆IP

image.png

• 验证

pod lib lint 

• 验证包括podspec的内容,代码编译通过.编译通过的要求是不能有Error,但是可以允许有Warnings.注意的是Xcode能编译过这里不一定可以.

查看验证与编译时的详细内容--verbose

pod lib lint --verbose

• 有几个常见的lib lint错误解决办法,其他的就自己google吧

• 提示有warnings, 基本上稍微复杂些的SDK肯定会有warnings
  

  image.png
  解决办法就是加上 --allow-warnings

pod lib lint --allow-warnings

• 提示swift版本错误
  解决办法就是加上swift指定版本例如--swift-version=3.0

pod lib lint --swift-version=3.0

• 提示tag未找到或者发现编译检查的代码和自己最新的代码不一致时
  查看仓库的tag好是否已经打上,检查podsepc中的tag和仓库的tag是否一致

• 一切都没问题后就提交吧
  需要注意的是,之前pod lib lint加上的参数这里也要全部加上
  比如--swift-version=3.0 --allow-warnings

pod trunk push 

发布成后出现如图所示的字样

image.png

4. 搜一下自己的SDK
   上传成功之后应该就可以搜到自己的库了,如果搜不到就pod setup更新一下自己的本地库
   image.png

• 有时候搜不到可以尝试加上--simple试一试

---

最后放上demo地址MQL9011/SDK_Fun

SDK开发「二」何使用切图等资源