关于 APP接口版本兼容的问题。
iOS和android 要不断开发新版本,很多服务端开发都是在以前接口的逻辑上进行修改。
新的APP和接口开发后,接口如何兼容老的APP?
有的公司 每次发布完APP,就强制用户更新到最新版本。不推荐这样,因为用户体验太差。
就算是用 强制更新,在苹果审核期间,新的APP接口和老的接口也必须能同时使用。
一、客户端做兼容,接口不用做兼容
1.APP强制更新(不建议)
接口URL:api.xxx.com/v1.0/xxxx.java
接口的URL中加入版本号,如上:v1.0。
每次发布新APP版本就强制更新。
灰度服务器部署正在审核中的接口版本(如:v1.1)。等审核通过后,将老版本的APP设置强制更新,这样老的接口就不用了。
然后把线上服务器重新部署上最新的代码,再去掉灰度服务器。这样APP接口全部访问正式的线上服务器。
2.热更新
紧急的小需求可以用热更新,大的需求建议还是用原生的代码,因为你用热更新修改完(用JS或Lua),最后还要在原生代码里修改。
网游用热更新的比较多,因为网游的APP太大,不可能加个小关卡 就要求用户重新下载,并且游戏更新比企业级APP更频繁,用热更新可以不断新加关卡、场景、活动推广。
二、服务端做 版本兼容
全部接口版本是否统一:
所有的接口都用相同的版本号:这样要发一个APP新版本就统一修改版本号,好修改,但是如果想修改其中一个接口的版本号就不行了。
每个接口的版本号可以不一样:这样比较灵活,建议这样做。
1.每个接口逻辑里加if 判断(不建议)
接口URL:api.xxx.com/api?version=v1&.。
if (version == ‘1.5.0’) {
do_something
} else if (version ==‘1.4.0‘) {
do_something
}
优点:实现简单
缺点:不同版本的逻辑都在一个方法里,在于容易造成代码混乱,不利于维护。
2.不同的文件夹
相当于每个接口版本都是一个独立的项目。放到服务器的独立文件夹里。
例如:
接口URL:api.xxx.com/v1.0/xxxx.php
文件夹位置:Controller/V1.0/
-----------------/xxxx.php
文件夹位置:Controller/V2.1/
-----------------/xxxx.php
优点:版本逻辑分开维护。看url就能知道哪个版本。删除多余版本 不用修改代码。
缺点:同个接口不同版本文件是重复的。并且如果有个接口前几版就有问题,一直遗留到现在,就需要改好几套一样的代码。
3.不同版本用不同的方法 :
类似:
接口URL:api.xxx.com/v1.0/xxxx.php
class XXXX{
public funcTIonV1_0() { }
public funcTIonV2_0() { }
}
java或者C# 都有路由配置,可以用路由配置不同版本的URL跳转到不同的方法里。
4.用继承的方式
采用继承的方式,既可以利用之前的接口代码,又可以采用override的方式修改部分接口的实现。
这样是可以的。但是如果你上个版本(也就是父类)修改了代码,就会影响后面的所有版本。
在线上有bug或者需求变更的时候很可能会修改基类。
5.部署到不同的服务器
不同版本不同分支,部署在不同的服务器上。如果某个版本用不到了,直接干掉服务就好了。
例如:我现在的API要从1.x升到不兼容的2.0版本了,那就给当前的发布分支打个Tag。等哪天1.x版的API需要fix bug,就能很简单地从这个Tag切一个1.x的分支出来fix bug后进行测试发布,而且这个分支不会合并到任何分支,
所以不会影响其他版本。这个方案不好的地方在于,如果2.0也有同样bug的话,也要在2.0分支上改一遍。如果版本很多的话,这活就不好干了。
所以呢,一般不会同时发布两个以上的版本,在升级不兼容的第三个版本前,一定会把第一个版本干掉。
但是比如 淘宝、微信 ,有的时候忘记更新了,你会发现淘宝已经升级过4、5个版本了,然后老版本还能用。也就是有的APP确实需要兼容4、5个版本。
另外,如果要兼容过多的版本,服务器也需要够多才行。同时,因为老版本的人用的少,也就是有的服务器访问量很少,有的服务器访问量很多。不能真正的负载均衡,浪费了服务器资源。
6.混合使用
服务端的几种方法混用:
第3种和第4种方法一起用。先用继承,如果新版本和以前的版本无法复用,就用路由设置新的方法。
第1种方法和第3中方法一起用,简单的小改动用 第1种,加个if判断。改动较大的用 第3种,新开个方法。