App版本号规范

---

物语.jpg

导言

产品：这周五开始做App下一个迭代！

程序猿：OK，那版本号定为多少？

产品：这个版本是多少来着......

程序猿：v3.3.0

产品：好的，那下个版本就定为3.3.1吧，就这么决定了！！

这是很多公司会出现的一段对话，我们公司就是其中一员。

App版本号是什么，每个位置的数字代表什么含义，什么时候应该在哪个数字上加1。带着这些问题我们来了解一下App版本号的规范。

什么是App版本号

在Android中有versionCode和versionName，可以在Module的build.gradle文件中配置。

versionCode getIncreasedVersionCode()
versionName "3.3.0"

1. versionCode
   versionCode是作为内部的一个版本号，必须是整型。版本号越大，离当前时间越近，这个数字不是给用户看的，仅用于应用市场，程序内部识别版本，判断新旧的用途。

由于每次发布时都需要手动修改版本号，作为懒惰的程序猿当然不能忍受这种事，所以就写了一个方法，每次打包保证版本号都会比之前的大。方法如下：

//versionCode取时间戳对应的天数（即1970.1.1到当前天数）
def getIncreasedVersionCode() {
    return (int) (System.currentTimeMillis() / (1000 * 60 * 60 * 24))
}

2. versionName
   versionName是向用户展示的版本号，必须是字符串，这个版本号就是我们可以用来遵循规范的位置，可以作为版本比较，判断是否需要提示更新、强制更新的判断依据。也可以用来做接口API版本兼容。下文提到的版本号都是指versionName。

研究其他应用的版本号格式

应用名称	版本号
QQ	7.3.5
微信	6.6.1
王者荣耀	1.33.1.8
支付宝	10.1.12.123621
淘宝	7.5.0
美团	8.9.2
饿了么	7.30
富途牛牛	7.18.618
网易云音乐	4.3.4

从一些主流的App可以看出来，versionName的格式多数是3位和4位的，每一位的号码含义如下：

• 主版本号：当功能有较大变动（比如增加多个模块或者整体架构发生变化），增加主版本号
• 子版本号：当功能有一定的增加或变化，增加该版本号
• 补丁版本号：一般是修复bug或优化原有功能，还有一些小的变动，都可以通过升级该版本号
• 日期版本号（build号）：用于记录修改项目的当前日期，每天对项目的修改都需要更改日期版本号，build号每次构建的都是都会自增

选择合适自己的版本号

从上面的分析可以看出来，不同的公司对版本号的控制和规范是有出入的，有的主版本号会压得很低，而有的主版本号也到了10。

但大多数基本都遵循了上面的规则，我们可以在遵循规则的基础上，制定合适自己的版本号！！

目前我们主要是从两个维度来考虑版本号的意义：

1. 项目维度
   主版本号代表App有重要的变化，比如新增了一个大的业务功能模块，或者是技术架构发生了重大变化。
   子版本号表示一次需求迭代，也就是可以通过子版本号直接知道当前版本是正常的需求迭代，还是修复版本（或者内部优化版本）。
   补丁版本号则表示跟产品需求无关的一些版本，比如Bugfix版本，或者一些内部优化版本。如果App做了热修复，那么这个版本号是会经常变动的。如果只是周期性的迭代，那么该版本号基本体现不出什么作用。

2. 业务维度
   主版本号跟1中定义类似。
   子版本号则代表有新增的功能模块，此处的新增功能是指全新的功能，而不是在页面加一些字段这种小的改变。
   补丁版本号代表Bugfix版本或者功能优化版本。

注：1跟2的主要不同在于在在需求出来之前，根据1可以提前定出版本号，而根据2则不行，2必须是知道确定需求，才能定出版本号。

经过跟产品的讨论，我们决定用1中的含义来定义版本号。

写于2018.1.30晚上20:00（位置：深圳南山区）
编辑于2018.1.31下午18:30（位置：深圳南山区）