gradle-packer-plugin 是Android多渠道打包工具Gradle插件,可方便的于自动化构建系统集成,通过很少的配置可实现如下功能 :
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.+'
}
}
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
./gradlew
替换为 gradle.bat
gradle.bat wrapper
然后就可以使用 gradlew.bat
了gradle.bat clean assembleRelease
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}
,可使用以下变量:
applicationId
(App包名packageName)buildType
(release/debug/beta等)flavorName
(对应渠道打包中的渠道名字)versionName
(显示用的版本号)versionCode
(内部版本号)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'
build.gradle
在 apply plugin: 'com.android.application'
下面加入 apply plugin: 'packer'
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'
build.gradle
在 apply plugin: 'com.android.application'
下面加入 apply plugin: 'packer'
build.gradle
加入如下配置项,buildNumberAuto是开关
packer {
// 指定是否使用build版本号自增
buildNumberAuto = true
// 指定使用版本号自增的buildType,默认是全部
buildNumberTypeMatcher = ['release', 'beta']
}
./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项目示例,在项目根目录有几个脚本可以用于测试:
/tmp/repo/
目录,方便即时测试本项目参考了公司内部Android项目使用的多渠道打包工具,最初作者是 googolmo,文件名模板自定义部分的代码修改自此项目 android-appversion-gradle-plugin
Copyright 2014 - 2016 Xiaoke Zhang
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。