【Android技巧之相见恨晚系列】-自制Gradle脚本动态设置版本号

public static final 传送门 传送门① =更优雅的 Android 发布自动版本号方案 ;

public static final 传送门 传送门② =Android应用编译时自动生成版本号 ;

public static final 传送门 传送门③ =Android Studio 多渠道打包、自动版本号及 gradlew 命令的基本使用 ;

---

以前在做重度/中度SQLite相关的应用的时候，经常遇到一个问题，就是需要不停的增加数据库的版本号，来触发onUpgrade方法，从而能更新表结构。一般也都是采取versionCode来代替dbVersion，然而开发过程中，还是得手动修改版本号才行。。。当时（还在Eclipse时代）就在苦苦追寻自动设置版本号的方法ToT。。。

如今，有了前面声明过的三篇好文章的指点，终于如愿以偿！又是相见恨晚......
此篇文章是根据前面两篇好文之后自己再做的笔记。
首先，先贴出成品的build.gradle(module的)：

apply plugin: 'com.android.application'

ext.majorNumber = 1
ext.minorNumber = 0
ext.revisionNumberCMD = 'git rev-list HEAD --count'
ext.revisionNumber = revisionNumberCMD.execute().getText().trim().toInteger()
ext.revisionDescriptionCMD = 'git describe --always'
ext.tempRevisionDescription = revisionDescriptionCMD.execute().getText().trim()
ext.revisionDescription = (tempRevisionDescription == null || (tempRevisionDescription).size() == 0) ? new Date().format("yyMMdd") : (tempRevisionDescription).substring((tempRevisionDescription).size() - 6)
android {
    compileSdkVersion 23
    buildToolsVersion "23.0.1"
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        debug {
            applicationIdSuffix ".debug"
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }

    defaultConfig {
        applicationId "..."
        minSdkVersion 15
        targetSdkVersion 23
        versionCode getVersionCode(false)
        versionName getVersionName(false)
    }

    applicationVariants.all { variant ->
        if (variant.buildType.name.equals('release')) {
            variant.mergedFlavor.versionCode = getVersionCode(true)
            variant.mergedFlavor.versionName = getVersionName(true)
        } else if (variant.buildType.name.equals('debug')) {
            variant.mergedFlavor.versionCode = getVersionCode(false)
            variant.mergedFlavor.versionName = getVersionName(false)
        }
    }
}

dependencies {
    ...
}

def getVersionCode(boolean isRelease) {
    // 正式环境
    if (isRelease) {
        majorNumber * 1000000 + minorNumber * 10000 + revisionNumber
    }
    // debug环境
    else {
        Integer.parseInt(new Date().format("yyMMddHHmm"))
    }
}

//Major_Version_Number.Minor_Version_Number[Revision_Number[.Build_Number]]
def getVersionName(boolean isRelease) {
    // 正式环境
    if (isRelease) {
        majorNumber + "." + minorNumber + "." + revisionNumber + "." + revisionDescription
    }
    // debug环境
    else {
        String today = new Date().format("yyMMdd")
        String time = new Date().format("HHmmss")
        majorNumber + "." + minorNumber + "." + revisionNumber + ".$today.$time." + revisionDescription
    }
}

Outputs:

debug	release

对应敲出git的命令
可以看到该git repo的总提交次数正是32，与版本号里面的RevisionNumber一致；describe的后6位，也正好与BuildNumber一致。

以上便是实现的效果：
debug的时候：每次run，都会根据时间戳来生成version info；
release的时候：根据项目需求，自行定制的算法来动态生成version info；
（以上两种算法都是可以自由定制的）

接下来，我们反向来“一层一层一层地剥开我的心”。。。

首先看到的是这一代码块

    defaultConfig {
        applicationId "..."
        minSdkVersion 15
        targetSdkVersion 23
        versionCode getVersionCode(false)
        versionName getVersionName(false)
    }

这里我们自定义了两个方法，来动态生成version info，去瞧瞧方法里面干了些啥

def getVersionCode(boolean isRelease) {
    // 正式环境
    if (isRelease) {
        majorNumber * 1000000 + minorNumber * 10000 + revisionNumber
    }
    // debug环境
    else {
        Integer.parseInt(new Date().format("yyMMddHHmm"))
    }
}

def getVersionName(boolean isRelease) {
    // 正式环境
    if (isRelease) {
        majorNumber + "." + minorNumber + "." + revisionNumber + "." + revisionDescription
    }
    // debug环境
    else {
        String today = new Date().format("yyMMdd")
        String time = new Date().format("HHmmss")
        majorNumber + "." + minorNumber + "." + revisionNumber + ".$today.$time." + revisionDescription
    }
} 

Release时，采取的正是传送门②的算法：

versionCode = 主版本号*1000000 +次版本号*10000+修订号
versionName = 主版本号.次版本号.修订版本号.编译版本号

Debug时，则是自己暂时采取的简易自增法——时间戳：

versionCode = yyMMddHHmm
versionName = 主版本号.次版本号.修订版本号.yyMMdd.HHmmss.编译版本号

然后就是如何定制这4种版本号了：

ext.majorNumber = 1
ext.minorNumber = 0
ext.revisionNumberCMD = 'git rev-list HEAD --count'
ext.revisionNumber = revisionNumberCMD.execute().getText().trim().toInteger()
ext.revisionDescriptionCMD = 'git describe --always'
ext.tempRevisionDescription = revisionDescriptionCMD.execute().getText().trim()
ext.revisionDescription = (tempRevisionDescription == null || (tempRevisionDescription).size() == 0) ? new Date().format("yyMMdd") : (tempRevisionDescription).substring((tempRevisionDescription).size() - 6)

主版本号：手动根据产品迭代自行定义大版本号

次版本号：手动根据产品迭代自行定义次版本号

修订版本号：自动采用git命令获取当前repo的总Commit次数

编译版本号：自动采用git命令获取当前repo的里程碑（截取后6位）

这里的git命令就是前面三篇文章里传授的。
最后，受传送门① 和传送门③ 的启发，区分了一下Release和Debug的buildtype从而采用不同的算法生成version info

    applicationVariants.all { variant ->
        if (variant.buildType.name.equals('release')) {
            variant.mergedFlavor.versionCode = getVersionCode(true)
            variant.mergedFlavor.versionName = getVersionName(true)
        } else if (variant.buildType.name.equals('debug')) {
            variant.mergedFlavor.versionCode = getVersionCode(false)
            variant.mergedFlavor.versionName = getVersionName(false)
        }
    }

Sync Now 一下，可以去build-generated-source-buildconfig目录下查看BuildConfig.java文件

debug的BuildConfig.java
release的BuildConfig.java

这样，¹⁰√小目标就实现了。。。

---

参考文献
1.版本号——百度百科
2.官方markdown指南
3.md官方指南不够这篇来凑

---

最后，拙笔画一幅美图祝福大家中秋赏月快乐！

皓月当空图(手机观赏效果更佳)
〇           ￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣