Android应用编译时根据git自动生成版本号

阅读 4

versionCode与versionName

Android的APK会自带一个版本描述,这就是versionCode和versionName。其中,versionCode是一个int,应该是一个随着开发而持续增长的值,而versionName是一个String,这是给人看的版本号。

versionName在开发过程中可以起到辨识作用,方便开发工程师与其他团队的人交流,也是用户直接可见的。比如某个问题是某某版本上出现的,某个功能是某某版本添加的。

versionCode在人的圈子里其实没太大作用,但是它是Android系统真正使用的值。在更新时,新的版本versionCode不能比原来的小,否则更新会失败。另外要注意,int是有上限的,不能太乱来。

versionCode和versionName,直接体现在APK中的AndroidManifest.xml文件中。可以通过以下命令查看:

aapt dump badging PATH/TO/YOUR.apk | grep version

aapt是Android Asset Packaging Tool,就是Android应用在命令行的打包工具,SDK里就有。主要作用是把二进制文件打包为APK,也附带了一些相关的查询功能。

修改versionCode和versionName,最简单、直观的方法,就是改源代码中的AndroidManifest.xml。但是,这样就需要频繁修改AndroidManifest.xml,每次版本更新时改一次。如果你希望每次提交的版本号都不一样,那么每次提交都需要密集地修改那两行,这显然是不可取的。

此外,实际上无论是在Android项目内编译,还是在IDE编译,最终都是用aapt来打包。打包时,可以通过设置--version-code--version-name参数,来对这两个字段设值,并且在最终打包时添加到APK的AndroidManifest.xml中。

在Android源码中编译时,如果一个模块没有指定versionCode与versionName,那么将与平台相同。比如在Android Marshmallow (API level 23)中编译,那么versionCode就是23,versionName就是PLATFORM_VERSION,比如6.0.1。

版本号规则

版本号规则可以自定义,每家都不太一样。

很多不在意这些的小项目,直接默认versionName为1.0,至死不变——这其实也算是一个规则。

比较常见的还有先标为0.1,开发到一段时间再标为1.0并发布,如果有bug修正后叫1.1,增加一堆新功能后叫2.0。

这些版本号规则,简单实用,通过改文件的方式就可以实现,不需要自动化。

以下以一个比较复杂的来举例。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionName="aa.bb.cccc.yymmdd.xxxxx"
    android:versionCode="aabbcccc"
    package="com.example.xxx">

其中,aa是大版本号,bb是小版本号,最多2位,不足不补0。它们由人来自定义,必要时手动修改。比如说,某某应用v2.0,那么aa为2,bb为0。版本号设计里,有一部分是需要保留手工控制的,不然产品经理会因控制欲无法满足而抓狂。

cccc是Git库的提交次数,xxxxx是Git库HEAD的SHA1码前5位。这些都是随着Git提交而确定的,在编译过程中可以、也应该自动生成。在shell中执行以下命令可以获取:

git rev-list --count HEAD # This is cccc
git describe --always # This is short SHA1​

yymmdd是日期,yy是年的后两位,mm是月,dd是日,不足补0。

如果是用命令行手工打包,写个脚本就行了。而如果是在IDE或项目里编译,则需要修改编译文件。

Android.mk中自动生成版本号

由于有Git命令牵涉其中,相对来说,Android.mk里是更容易实现的。

Android.mk的语法,其实就是最原始的makefile,添加了一些自定义的东西。目前对普通开发者来说,也就NDK开发时有可能会接触。但是在Android源码编译时,每一个小模块都有至少一个这东西。

aa = 1
bb = 0
cccc = $(shell cd $(LOCAL_PATH) && git rev-list --count HEAD)
version_code = $(shell expr $(aa) \* 1000000 + $(bb) \* 10000 + $(cccc))
version_name := $(aa).$(bb).$(cccc).$(shell date +%y%m%d).$(shell cd $(LOCAL_PATH) && git describe --always)
LOCAL_AAPT_FLAGS += --version-code $(version_code)
LOCAL_AAPT_FLAGS += --version-name $(version_name)​

由于Android.mk的内置函数和变量里,并没有versionCode和versionName这两个值的对应,所以需要通过LOCAL_AAPT_FLAGS来设置aapt的参数。

除此之外,就没有Android.mk特有的东西了,全是makefile自有的语法。

build.gradle中自动生成版本号

Android Studio中,gradle.build里的设定会覆盖AndroidManifest.xml中的设置。

Gradle中使用的是Groovy语言,这是一种基于JVM的敏捷开发语言,还算是易学易用的。

在项目的build.gradle中,android.defaultConfig里,把versionCode和versionName改成自定义函数getSelfDefinedVersion

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.3"

    defaultConfig {
        applicationId "com.example.xxx"
        minSdkVersion 22
        targetSdkVersion 23
        versionCode getSelfDefinedVersion("code")
        versionName getSelfDefinedVersion("name")
    }
    buildTypes {
        release {
            minifyEnabled false
        }
    }
}​
在build.gradle文件底部,统一实现版本号自动生成管理:
 
def getSelfDefinedVersion(type) {
    int aa = 1
    int bb = 0
    Process process = "git rev-list --count HEAD".execute()
    process.waitFor()
    int cccc = process.getText().toInteger()

    if ("code".equals(type)) {
        aa * 1000000 + bb * 10000 + cccc
    } else if ("name".equals(type)) {
        String today = new Date().format("yyMMdd")
        process = "git describe --always".execute()
        process.waitFor()
        String sha1 = process.getText().trim()
        "$aa.$bb.$cccc.$today.$sha1"
    }
}

这样虽然比较简陋,但功能是有了。

可以编译后用aapt查看结果,也可以在gradle sync后,查看app/build/目录下自动生成的BuildConfig.java文件。

package com.example.xxx;

public final class BuildConfig {
  public static final boolean DEBUG = Boolean.parseBoolean("true");
  public static final String APPLICATION_ID = "com.example.xxx";
  public static final String BUILD_TYPE = "debug";
  public static final String FLAVOR = "";
  public static final int VERSION_CODE = 1000172;
  public static final String VERSION_NAME = "1.0.172.160713.08d62e0";
}

这个文件是Android Studio自动生成的,会打包进APK中,可以在Java源码中直接引用。它受到编译开关控制,不同编译条件下会有不同的BuildConfig.java文件产生。

./app/build/generated/source/buildConfig/androidTest/debug/com/example/xxx/test/BuildConfig.java
./app/build/generated/source/buildConfig/debug/com/example/xxx/BuildConfig.java
./app/build/generated/source/buildConfig/release/com/example/xxx/BuildConfig.java

隐患

目前的实现方案,其实有一个已知的隐患。

当cccc大于10000时,在versionCode会发生进位,bb会变相增加;而在versionName,则不会发生进位,bb仍然是预设值。

假如对cccc进行除余操作(cccc %= 10000),那么在每次跨越10000时,versionCode的自增性会被破坏。所以每次发生这种情况,都要手动增加一下bb。所以,目前暂时采用前一种方式,至少保证无人工干预时,versionCode的自增性不变。

这个问题暂时不用担心,可以等真的发生这个情况时再考虑解决。

目前,世界上第一个大型Git库——git/git它自己,目前(2016年7月14日)的提交总次数为43560。所以,假如cccc换成5位、甚至6位,这个问题可以拖延到海枯石烂。

当然,如果是我来设计,那么versionCode等于提交次数就好了,不用搞什么前缀。

原文:https://www.jianshu.com/p/11aaf19cf9c6
各位看官,如果你觉得本文不错,请支持一下~