简洁易用的SDK开发之道

简洁易用SDK的特点

易用

  1. 简单的api设计
    那么所谓的易用到底是什么呢?我们想创造一种最简单的方式,让人们在他们的应用中开始使用SDK. 如果它是易用的,它应该是不需要侵入太多你的代码或者你需要做很多繁琐的集成工作。只要在你的代码中新增一行我们的代码,就可以使用它了,类似这样:

    HyAwPay.init(this,"appid",""appkey");

2.轻松定制
开发者对SDK的拓展性要求,builder模式的使用,比如:

Paste_Image.png

3.防止误用
从Retrofit的构造函数我们可以得知,builder的参数在对象初始化的时候也进行了初始化,但是单纯的builder有时候会造成误用,比如这样:

Paste_Image.png

更好的方式呢?

可消耗商品


Paste_Image.png

不可消耗商品

Paste_Image.png

金额消费商品

Paste_Image.png

由此我们对项目中的reporter库进行了改造,因为单纯的builder已经满足不了我们的需求:
初始化打点

Paste_Image.png

SDK上报打点

Paste_Image.png

API的设计

Paste_Image.png

一个 API 就像一个婴儿。他们很有趣,但他们需要18年的支持。任何 API 我们都必须要长期地支持,所以我们要让大家感觉到,我们正走在正确的路上,才能才久坚持支持下去。

1.回调的设计
我们平时开发当中都会见到什么样子的设计呢?首先我们看下微信的设计:

Paste_Image.png

上图中为微信支付的调用代码,你要拿到结果从哪拿呢?首先你得在你<包名>/wxapi/下面创建微信指定的Activity对不对?在指定的activity中接受结果,可是这里收的结果,怎么跟你当前的业务关联起来呢?广播?监听器?好乱,反人类啊。

Paste_Image.png

那么支付宝的设计呢?

Paste_Image.png
Paste_Image.png

支付宝整个支付过程的调用还算是蛮简单的,但是涉及到一个问题,整个过程的调用在子线程中,要在主线程中拿结果,必须自己在handler中收发处理结果消息。为什么整个过程不能帮开发者完成,然让开发者自己单独完成呢?

说道这里,那么我们开发者更能接受的回调长什么样子呢?

Paste_Image.png

上图是AsyncHttpClient的回调,整个过程清晰,回调结果更加清晰。有人说工具库和功能库是有本质区别的,区别在什么呢?对,区别在微信和支付宝有界面啊,activity中回调结果的接受本来就不容易。答案是什么样的呢?
答案是有界面的支付api,也是可以用这么简单的回调的,对吗?

Paste_Image.png

其实实现这样回调并不难,我们知道回调的定义一般都是interface,而interface是不能在activity之间通过intent传递的,那么用什么方法能让它传递呢?没错,可能有人已经想到了,容器啊,interface直接放全局的容器,在从第一个activity到第二个activity时传递容器过去,然后在第二个activity中接收,然后整个回调看起来就是这么简单的api。

API稳定性

Paste_Image.png

1.如何确保稳定
作为开发人员我们可以做什么,以确保尽可能高的稳定性?有一些事情是我们开发过程中的关键。首先,代码审查是非常重要的,必须得认真对待它们。然后,通过不断地问自己“这个代码有什么问题吗?”我们可以这样试着去问自己,以达到尽可能的防守。

如果能够自动获得一些基本的正确性保证,也可以在早期帮助捕捉错误,所以单元测试是非常有用的。

优美的降解

开发者经常是容易不耐烦的,所以有一些错误越尽早抛出就越好。

比如开发者传的参数缺少,很明显的是不能继续进行业务上的处理的,是否可以直接抛出异常出来

保证你的 SDK 在生产环境中绝不会出错,让你的代码持续运行在他们的应用中

轻量

1.用户不太可能下载大的应用程序,这意味着安装包的大小是一个关键内容
2.伟大的第三方库,可以真正给予贡献于你的应用程序,但当涉及到 size 规模和影响时,他们会显得不自由
3.作为一个 SDK 你应该努力平衡你的尺寸与功能。因此,要注意引入第三方库,以确保它们只满足所需的内容。
4.积极地监控每个 build,使我们能够衡量的真实影响开发者的 APK 大小情况。没有硬性和快速的规则来解决大小增加,但一直关注它显然是有帮助的。

模块化

1.适配器模式

Paste_Image.png

上面图中几行代码涉及到三个可更换模块
HTTP请求模块,相应内容格式化模块,相应内容处理模块

更简单的异步

  • 在应用中进行有限的同步工作
  • 请帮开发者进行线程的切换
  • API代码运行线程的统一

可扩展的类和接口

  • 除了运行时检测,我们不能满足每个开发者的需求。我们易于使用和流行的一些特性让用户去发现。
  • 开发人员有很多工具,有很多的选择,他们需要在他们的代码中保持灵活性。

构建工具的支持

Paste_Image.png
Paste_Image.png
Paste_Image.png
  • 可以让开发者选择不同的依赖管理器或者构件工具来引入或集成你的库
  • 可选择的依赖方式(jar,aar,library)
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,189评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,577评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,857评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,703评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,705评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,620评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,995评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,656评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,898评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,639评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,720评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,395评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,982评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,953评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,195评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,907评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,472评论 2 342

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,421评论 25 707
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,016评论 4 62
  • 就在刚刚,小佳又一次结束了和室友一起出去臭嗨,唱k,逛街,吃韩国烧烤,看电影,一直玩到深夜打的回学校,求宿舍阿姨开...
    七禾有木阅读 324评论 4 3
  • 已经很多天没有瞎写些东西了,坚持是一件难以言说的难题,各种各样的因素影响着一个习惯的养成,把读书写字培养成习惯不是...
    流云忽闪阅读 797评论 0 0
  • 人的一生大致把它分为三个阶段:第一阶段是1--20岁求知阶段,这一阶段基本不属于自己。第二阶段是20--60岁...
    东江之子阅读 327评论 0 0