Android面试总结之接口维护(版本控制)

一般情况下,APP中会有大量的接口,再加上版本的变化,接口的升级,可能会衍生出很多个稍有差异的接口,这个时候接口如果维护的不好,后边会乱为一锅粥,客户端不同版本使用不同的接口名(xxxv1,xxxv2,xxxv3.....)。
有的公司每次发布完APP,就强制用户更新。不推荐这样,用户体验太差。
就算是强制更新,在苹果审核期间,新的APP接口和老的接口也必须能同时使用。

处理方法
一、 客户端做兼容,接口不用做兼容
  1. APP强制更新(不建议)
    接口URL:api.xxx.com/v1.0/xxxx.java
    接口的URL中加入版本号,如上:v1.0。
    采用灰度服务器 部署正在审核中的 接口版本(如:v1.1)。等审核通过后,将老版本的APP设置强制更新,然后把线上服务器重新部署上最新的代码,再去掉灰度服务器。这样APP接口全部访问正式的线上服务器。

  2. 热更新
    紧急的小需求可以用热更新,大的需求建议还是用原生的代码,因为你用热更新修改完(用JS或Lua),最后还要在原生代码里修改。
    网游用热更新的比较多,因为网游的APP太大,不可能加个小关卡 就要求用户重新下载,并且游戏更新比企业级APP更频繁,用热更新可以不断新加关卡、场景、活动推广。

  3. React Native 和Weex
    没接触过 可以自己了解

二、 服务端做版本兼容
  1. App 请求服务器接口的时候携带接口版本字段
    服务器根据接口版本调用相应的方法,每个接口逻辑里 加if 判断(不推荐)
    接口URL:api.xxx.com/api?version=v1&..
if (version == ‘1.5.0’) {
  //do_something
} else if (version ==‘1.4.0') {
  //do_something
}

不同版本的逻辑都在一个方法里,在于容易造成代码混乱,不利于维护。

  1. 一个版本一个文件
    相当于每个接口版本都是一个独立的项目。放到服务器的独立文件夹里。使用什么版本接口写到客户端配置里面或者通过一个接口获取就行。
    例:
    1.0版本:http://x.x.x.x:xx/xxapi/v1.0/xxx
    1.2版本:http://x.x.x.x:xx/xxapi/v1.2/xxx
    文件夹位置:Controller/V1.0/
    -----------------/xxxx.php
    文件夹位置:Controller/V1.2/
    -----------------/xxxx.php
    优点:版本逻辑分开维护。看url就能知道哪个版本。删除多余版本 不用修改代码。
    缺点:同个接口不同版本 文件是重复的。并且 如果有个接口前几版就有问题,一直遗留到现在,就需要改好几套一样的代码。

  2. token代替版本号



    几个要点:
    a. 客户端发送请求时token是固定不变的,使用token间接的标记请求的接口版本。
    b. server保存了token和对应接口的版本号,请求来了之后会先根据这个寻找对应的接口版本。
    c. 每个目录对应一个版本,根据请求的接口读取对应目录下的接口配置文件,找到最终要执行的具体接口。
    例如:http://xxxx.xxxx.com/module/controller/list?token=6918b5e0567c7d47314c10ed413e3f95 这个请求最终会打到listv2这个接口。
    d. 这样就可以在服务端灵活的配置接口了,客户端只要每次请求的时候带上默认的token参数,就可以得到自己想要的了,完全不需要关心版本的问题。

  3. 继承的方式
    ControllerV1
    ControllerV2 extends ControllerV1
    采用继承的方式,既可以利用之前的接口代码,又可以采用override的方式修改部分接口的实现。
    缺点:如果上个版本(也就是父类)修改了代码,就会影响后面的所有版本。

  4. 不同版本使用不同的域名/不同服务器
    不同版本不同分支,部署在不同的服务器上。如果某个版本用不到了,直接干掉服务就好了。
    例如我现在的API要从1.x升到不兼容的2.0版本了,那就给当前的发布分支打个Tag。等哪天1.x版的API需要fix bug,就能很简单地从这个Tag切一个1.x的分支出来fix bug后进行测试发布,而且这个分支不会合并到任何分支,所以不会影响其他版本。
    优点:部署的过程不会影响其他版本api的使用,并且可以减轻单台服务器的负担。
    缺点:如果2.0也有同样bug的话,也要在2.0分支上改一遍。如果版本很多的话,工作量大。所以呢,一般不会同时发布两个以上的版本。另外,如果要兼容过多的版本,服务器也需要够多才行。同时,因为老版本的人用的少,也就是有的服务器访问量很少,有的服务器访问量很多。不能真正的负载均衡,浪费了服务器资源。

最后做下版本使用监控。当观察到所有用户都使用新版本的客户端的时候,并保持一段时间的时候。放弃对老版本的维护,继而下掉老版本的资源。


版本更新

开启APP->请求初始化接口->检测是否需要更新? 否->首页Or 是->更新

在初始化接口的时候,需要客户端发送几个数据:

app_id            客户端id,比如: 1,安卓手机 2,iphone手机

version_id        大版本号id

version_mini      小版本号id

did               用户客户端信息(客户端工程师会获取这个数据)

encrypt_did       did加密后的字符串(did 加上 APP设备数据表中的key,然后md5)

数据库方面:需要两张表。一张是记录升级版本信息的表,记录着设备的id,版本号信息,下载地址等。另外一张表是记录的设备的信息,比如安卓手机的信息,版本信息表中有一个外键app_id,关联的就是设备信息表的主键。

  //设备信息表,记录了各种客户端的信息
    CREATE TABLE IF NOT EXISTS `app_table` (
      `app_id` smallint(6) NOT NULL AUTO_INCREMENT COMMENT '主键',
      `name` varchar(10) NOT NULL COMMENT '设备名称',
      `is_encryption` tinyint(1) NOT NULL COMMENT '是否加密',
      `key` varchar(10) NOT NULL COMMENT '加密key',
      `image_size` text NOT NULL COMMENT '按照json来存储',
      `create_time` int(11) NOT NULL COMMENT '添加时间',
      `update_time` int(11) NOT NULL COMMENT '修改时间',
      `status` tinyint(1) NOT NULL COMMENT '状态 1正常0删除',
      PRIMARY KEY (`app_id`)
    ) ENGINE=MyISAM  DEFAULT CHARSET=utf8 COMMENT='app设备表' AUTO_INCREMENT=2 ;
    
    //版本升级信息表,存放了各种版本的信息
    CREATE TABLE IF NOT EXISTS `version_upgrade` (
      `id` smallint(4) NOT NULL AUTO_INCREMENT COMMENT '主键',
      `app_id` smallint(4) NOT NULL COMMENT '客户端设备id',
      `version_id` smallint(4) NOT NULL COMMENT '大版本号id',
      `version_mini` mediumint(8) NOT NULL COMMENT '小版本号',
      `version_code` varchar(10) NOT NULL COMMENT '版本标识1.2',
      `type` tinyint(4) NOT NULL COMMENT '是否升级1是0否',
      `apk_url` varchar(255) NOT NULL COMMENT '下载链接地址',
      `upgrade_point` varchar(255) NOT NULL COMMENT '升级提示',
      `status` tinyint(4) NOT NULL,
      `create_time` int(11) NOT NULL COMMENT '添加时间',
      `update_time` int(11) NOT NULL COMMENT '修改时间',
      PRIMARY KEY (`id`)
    ) ENGINE=MyISAM  DEFAULT CHARSET=utf8 COMMENT='软件升级信息表' AUTO_INCREMENT=2 ;

通过app的版本信息与服务器信息对比,看是否要进行版本升级

参考文章
http://www.cnblogs.com/dahe007/p/6255401.html

https://my.oschina.net/woshixiaomayi/blog/519783

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

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,716评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 172,331评论 25 707
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,124评论 4 61
  • 从2015年7月1日到10月10日,我已经正式毕业3个月了。从2014年6月3日到2015年10月10日我已...
    Lona阅读 155评论 0 1
  • 1.念头起于高考监考时,想到自己将要参与一项写作活动可以将这种模式迁移到学生的学习中来,于是设置了一个基本方案来挑...
    七哥特阅读 248评论 0 0