App版本更新接口的设计

工作这几年碰到的版本检测升级的接口也算是五花八门,啥样的都有,但肯定有的功能是有个apk的下载链接能间接或直接提示你是强制还是非强制更新

  • 间接是指提供你后台最新版本号,让你自己与本地版本号通过比较得出是否升级或强制升级;
  • 直接就是后台接口直接返回个Boolean类型告诉你是强制或者非强制更新。

个人认为一个好的版本检测接口需要设计的更灵活更清晰用起来更方便,下面就我理解的接口设计如下(如思路有误,欢迎指正):

总字段如下(并不是所有字段都要返回给客户端):
  1.最新版本号 :newVersion
  2.最小支持版本号 : minVersion
  3.apk下载url : apkUrl
  4.更新文案 : updateDescription
  5.是否有更新 : isUpdate
  6.是否强制更新 : forceUpdate
可选字段:
  7.apk文件大小:apkSize
  8.apk的文件MD5值:md5

方案一(前端处理逻辑):
前端调用获取当前服务器端最新版本信息的接口,然后根据返回的服务器端最新版本信息与客户端当前版本信息进行比较,此处需要后端提供最新版本号 :newVersion最小支持版本号 : minVersionapk下载url : apkUrl更新文案 : updateDescription 这四个字段。如下表:

字段 字段描述
newVersion 最新版本号
minVersion 最小支持版本号
apkUrl apk下载url
updateDescription 更新文案

客户端逻辑如下:

  1. 如果currentVersion < newVersion,则有更新信息;
    • 如果currentVersion < minVersion,则需要强制更新;
    • 如果currentVersion >= minVersion,则不需要强制更新;
  2. 如果currentVersion == newVersion,则没有更新信息。

客户端对应的流程图:

更新处理逻辑放客户端.png

前端处理逻辑不足之处:
对指定版本进行强制更新可能不是那么好,可是为什么要对指定版本进行更新呢?
此处做个假设:你的应用当前线上运行版本为V2.1.1, V2.1.2两个版本用户量比较多,又快要发布V2.1.3了,此时发现V2.1.2有个bug需要修复一下,然后在V2.1.3修复后发布了,当时感觉小问题就非强制更新(毕竟强制更新比较反感),过了几天查看V2.1.1, V2.1.2版本的用户量依然不减,升级的积极性不高啊,可是现在发现V2.1.2的这个bug风险很大,一旦出问题要卷铺盖走人的地步,那就要强制更新了,可又不想影响V2.1.1和V2.1.3版本的用户(对强制更新比较反感),此时想到要是能对V2.1.2一个版本强制更新就好了。
备注:此场景只是一个假设,当然即便碰到这个假设,只要前期设计的合理都能解决,比如:

  • 后端说我再多返回一个字段forceUpdateList给你,内容为指定版本强制更新的版本号列表,只要当前版本在该列表中就强制更新。(此方案前端表示想哭)
  • 或者不想要强制更新的版本号列表也可以,给你个字段forceUpdateVersion表示需要强制更新的版本信息,用正则匹配,如果匹配到的版本号就强制更新。(前端能做,后端也能做,看谁能说服谁了)
  • 可能也有人会说热修复或者插件化表示不担心,那就绕过吧,此处目的是为了分析版本升级的最优方案。

方案二(后端处理逻辑):
在客户端请求参数中添加当前版本号currentVersion传输给后台,由后台根据客户端传过来的当前版本号currentVersion做相应的判断后给出是否强制更新。
后端逻辑如下:

  1. 根据是否有特殊需求可指定某个版本必须强制更新,如currentVersion == XXX,则forceUpdate = true;
  2. 如果currentVersion < newVersion,则isUpdate = true;
    • 如果currentVersion < minVersion,则forceUpdate = true;
    • 如果currentVersion >= minVersion,则forceUpdate = false;
  3. 如果currentVersion == newVersion,则isUpdate = false.

后端逻辑对应流程图:

更新处理逻辑放后端.png

结论:
返回客户端的字段仅需要apk下载url : apkUrl更新文案 : updateDescription是否有更新 : isUpdate是否强制更新 : forceUpdate 这四个字段即可。如下表:

字段 字段描述
apkUrl apk下载url
updateDescription 更新文案
isUpdate 是否有更新
forceUpdate 是否强制更新

总结:
细心的你可能会发现上面的可选字段apkSize和md5并没有用到,既然是可选字段也就是可用可不用,根据需要决定是否采用,这里来讲下他们的用处。

  • apk文件大小apkSize
    这个用处可以说出于考虑用户体验,需要在升级弹框出来展示给用户将要更新的内容多大,让用户决定在非WIFI状态是否要更新,不能为了拉用户下载量或所谓的UV数直接让用户在不知道大小的情况下去直接下载(土豪用户绕路)
  • apk的文件MD5值
    这个主要是出于安全考虑吧,因为文件内容固定的话对应的md5是一样的,我们可以通过这个md5值来和下载的apk的md5值进行比较去保证我们从服务器更新下载的apk是一个完整的未被篡改的安装包,也就是说如果我们下载的apk的md5值和服务器返回的md5值相等,则说明我们下载的apk是完整的,且没有被相关有心人处理过的apk。

综上所述,这个版本更新的处理逻辑客户端和后端谁来做都可以,无关乎懒不懒的问题,个人感觉灵活性后端比客户端方便多了,当然客户端也能做,只是客户端做起来前期准备工作要考虑周全,各种场景都要考虑进去(还是会存在一些未知场景),不然只能下个版本实现了,考验你设计能力的时候到了。以上纯属个人见解,如有更好的方案,欢迎指教。

2021期待与你一起共事,点击查看岗位

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

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,497评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,050评论 25 707
  • 【七言律诗】《游太行》 当代/蜀山倦客 太行峰石早闻名,入地通天出物情。 撸袖登攀千壁绝,回头叹误众仙迎。 可...
    寺咀山主人阅读 718评论 6 13
  • 她轻轻走过我身边,悄悄带走我的心。 6月17号晚上我捡回她。这个开头很俗套,她带着喷香的皮肤和充满酒味的红色脸颊,...
    梦蝶Ariel阅读 542评论 0 0
  • 《生活》 梦。 在上完现当代文学欣赏课后,我深深被课文的内容打动,更是在老师述说自己婚后生活后更是感慨万分,特别想...
    柳晞阅读 185评论 0 0