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

versionCode与versionName

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

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

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

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

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

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 {
    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
        }
    }
}​

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