gradle-packer-plugin

gradle-packer-plugin 是 Android 多渠道打包工具 Gradle 插件，可方便的于自动化构建系统集成，通过很少的配置可实现如下功能 ：

• 支持自动替换AndroidManifest文件中的meta-data字段实现多渠道打包

• 支持自定义多渠道打包输出的存放目录和最终APK文件名

• 支持自动修改versionName中的build版本号，实现版本号自动增长

gradle-packer-plugin 库路径： com.mcxiaoke.gradle:packer:1.0.+ 简短名：packer，可以在项目的 build.gradle 中指定使用

使用方法

修改项目根目录的 build.gradle ：

buildscript {
    repositories {
        mavenCentral()
    }

    dependencies{
        classpath 'com.mcxiaoke.gradle:packer:1.0.+'
    }
}

修改Android项目的 build.gradle :

apply plugin: 'packer'

多渠道打包

需要在命令行指定 -Pmarket=yourMarketFileName属性，market是你的渠道名列表文件名，market文件是基于项目根目录的 相对路径 ，假设你的项目位于 ~/github/myapp 你的market文件位于 ~/github/myapp/config/markets.txt 那么参数应该是 -Pmarket=config/markets.txt，一般建议直接放在项目根目录，如果market文件参数错误或者文件不存在会抛出异常

渠道名列表文件是纯文本文件，每行一个渠道号，列表解析的时候会自动忽略空白行，但是格式不规范会报错，渠道名和注释之间用 # 号分割开，行示例：

 Google_Play#play store market
 Gradle_Test#test
 SomeMarket#some market

渠道打包的命令行参数格式示例（在项目根目录执行）：

./gradlew -Pmarket=markets.txt clean archiveApkRelease

Windows系统

• 如果你是在windows系统下使用，需要下载 Gradle，设置 GRADLE_HOME 环境变量，并且将Gradle的 bin 目录添加到环境变量PATH，然后将命令行中的 ./gradlew 替换为 gradle.bat

• 如果同时还需要使用gradlew，你需要给你的项目配置使用gradle wrapper，在设置好了gradle之后，在你的项目根目录命令行输入 gradle.bat wrapper 然后就可以使用 gradlew.bat 了

• Windows系统下的命令行参考：

  • 使用gradle： gradle.bat clean assembleRelease

  • 使用gradle wrapper： gradlew.bat clean assembleRelease

文件名格式

可以使用 archiveNameFormat 自定义渠道打包输出的APK文件名格式，默认格式是

${appPkg}-${flavorName}-${buildType}-v${versionName}-${versionCode}

举例：假如你的App包名是  com.your.company ，渠道名是 Google_Play ，buildType 是 release ，versionName 是 2.1.15 ，versionCode 是 200115 ，那么生成的APK的文件名是

com.your.company-Google_Player-release-2.1.15-20015.apk

版本号自增

版本号自动会自动在在 vesionName 尾部增加 .buildNumer 该字段会自动增长，举例：如果App本来的版本号是 1.2.3，那么使用版本号自动后会是 1.2.3.1 1.2.3.2 ... 1.2.3.25 末尾的build版本号会随构建次数自动增长。注意：如果在命令行使用 -PbuildNum=123 这种形式指定了build版本号，那么自增版本号不会生肖

配置选项

• archiveOutput  指定渠道打包输出的APK存放目录，默认位于${项目根目录}/build/archives

• archiveNameFormat - Groovy格式字符串， 指定渠道打包输出的APK文件名格式，默认文件名格式是： ${appPkg}-${flavorName}-${buildType}-v${versionName}-${versionCode}，可使用以下变量:

  • projectName - 项目名字

  • appName - App模块名字

  • appPkg - applicationId (App包名packageName)

  • buildType - buildType (release/debug/beta等)

  • flavorName - flavorName (对应渠道打包中的渠道名字)

  • versionName - versionName (显示用的版本号)

  • versionCode - versionCode (内部版本号)

  • buildTime - buildTime (编译构建日期时间)

• manifestMatcher 指定渠道打包需要修改的AndroidManifest.xml的meta-data的项名称，列表类型，举例： ['UMENG_CHANNEL', 'Promotion_Market']，注意：需要同时在命令行使用 -Pmarket=yourMarketFileName 指定market属性多渠道打包才会生效，如果没有配置就使用多渠道打包，将会抛出异常

• buildNumberAuto - 布尔值，是否使用自增版本号功能 设为 true 为使用插件提供的自增build版本号功能，该功能会在项目目录生成一个 packer.properties 文件，建议加入到 .gitignore 中，注意：该功能不会应用于多渠道打包生成的APK，不会影响渠道打包

• buildNumberTypeMatcher - 指定需要使用自增版本号的buildType，列表类型，举例： ['release', 'beta'] 默认是全部

使用示例：

多渠道打包

• 修改项目根目录的 build.gradle 在 buildscript.dependencies 部分加入 classpath 'com.mcxiaoke.gradle:packer:1.0.0'

• 修改Android项目的 build.gradle 在 apply plugin: 'com.android.application' 下面加入 apply plugin: 'packer'

• 修改Android项目的 build.gradle 加入如下配置项，manifestMatcher 是必须指定的，其它几项可以使用默认值：

packer {    // 指定渠道打包输出目录
    // archiveOutput = file(new File(project.rootProject.buildDir.path, "archives"))
    // 指定渠道打包输出文件名格式
    // archiveNameFormat = ''
    // 指定渠道打包需要修改的AndroidManifest文件项
    manifestMatcher = ['UMENG_CHANNEL','Promotion_Market']

}

• 假设渠道列表文件位于项目根目录，文件名为 markets.txt ，在项目根目录打开shell运行命令：

./gradlew -Pmarket=markets.txt clean archiveApkRelease
// Windows系统下替换为：
gradle.bat -Pmarket=markets.txt clean archiveApkRelease
// 或
gradlew.bat -Pmarket=markets.txt clean archiveApkRelease

如果没有错误，打包完成后你可以在 ${项目根目录}/build/archives/ 目录找到最终的渠道包。说明：渠道打包的Gradle Task名字是 archiveApk${buildType} buildType一般是release，也可以是你自己指定的beta或者someOtherType，使用时首字母需要大写，例如release的渠道包任务名是 archiveApkRelease，beta的渠道包任务名是 archiveApkBeta，其它的以此类推

版本号自增

• 修改项目根目录的 build.gradle 在 buildscript.dependencies 部分加入 classpath 'com.mcxiaoke.gradle:packer:1.0.0'

• 修改Android项目的 build.gradle 在 apply plugin: 'com.android.application' 下面加入 apply plugin: 'packer'

• 修改Android项目的 build.gradle 加入如下配置项，buildNumberAuto是开关

packer {    // 指定是否使用build版本号自增
    buildNumberAuto = true
    // 指定使用版本号自增的buildType，默认是全部
    buildNumberTypeMatcher = ['release', 'beta']

}

• 在项目根目录打开shell运行命令： ./gradlew clean assembleRelease  如果没有错误，你可以安装apk查看versionName自增是否生效， 也可以运行 ./gradlew -PbuildNum=123 clean assembleRelease 从命令行指定build版本号，该方法多用于自动化构建系统

完整示例：

项目的 samples 目录包含一个完整的项目示例，可以查看其中的 build.gradle

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.0.0'
        // `添加packer插件依赖`
        classpath 'com.mcxiaoke.gradle:packer:1.0.0'
    }
}

repositories {
    mavenCentral()
}

apply plugin: 'com.android.application'// 建议放在 `com.android.application` 下面  // `使用 apply plugin使用packer插件`  apply plugin: 'packer'packer {    // 指定渠道打包输出目录
    archiveOutput = file(new File(project.rootProject.buildDir.path, "apks"))    // 指定渠道打包输出文件名格式
    archiveNameFormat = ''
    // 指定渠道打包需要修改的AndroidManifest文件项
    manifestMatcher = ['UMENG_CHANNEL','Promotion_Market']    // 指定是否使用build版本号自增
    buildNumberAuto = true
    // 指定使用版本号自增的buildType，默认是全部
    buildNumberTypeMatcher = ['release', 'beta']

}

android {
    compileSdkVersion 21
    buildToolsVersion "21.1.1"

    defaultConfig {
        applicationId "com.mcxiaoke.packer.sample"
        minSdkVersion 15
        targetSdkVersion 21
        versionCode 12345
        versionName "1.2.3"
    }

    signingConfigs {
        release {
            storeFile file("android.keystore")
            storePassword "android"
            keyAlias "android"
            keyPassword "android"
        }
    }

    buildTypes {
        release {
            signingConfig signingConfigs.release
            minifyEnabled false
        }

        beta {
            signingConfig signingConfigs.release
            minifyEnabled false
            debuggable true
        }

    }

}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:support-v4:21.0.2'}

参与开发

plugin 目录是插件的源代码，用 Groovy 语言编写，项目 sample 目录是一个完整的Andoid项目示例，在项目根目录有几个脚本可以用于测试：

• deploy-local.sh 部署插件到本地的 /tmp/repo/ 目录，方便即时测试

• test-build.sh 部署并测试插件是否有错误，测试build版本号自增功能

• test-market.sh 部署并测试插件是否有错误，测试多渠道打包功能

感谢

本项目参考了公司内部Android项目使用的多渠道打包工具，最初作者是 googolmo，文件名模板自定义部分的代码修改自此项目 android-appversion-gradle-plugin