Gradle构建Android项目
gradle本身支持直接签名,只需要在releas部分添加如下代码即可
signingConfigs { debug { } release { storeFile file("../yourapp.keystore") storePassword "your password" keyAlias "your alias" keyPassword "your password" } } buildTypes { debug { minifyEnabled false zipAlignEnabled false shrinkResources false signingConfig signingConfigs.debug } release { minifyEnabled true//混淆编译 zipAlignEnabled true //移除无用的资源文件 shrinkResources true signingConfig signingConfigs.release proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } }
一般填上上面的代码即可执行签名,但是这种方式不太安全,建议不要在build.gradle文件中写上签名文件的密码,因为build.gradle文件一般都会集成到代码的版本控制中,这样所有人都会有签名文件的密码。
所以应该把签名文件的密码隔离起来,写到一个配置文件中,此配置文件不包含在代码版本控制中,这样其他开发者就不会知道签名文件的密码。
gradle配置文件一般以.properties结束,我们先新建一个signing.properties文件,内容如下:
STORE_FILE=yourapp.keystore STORE_PASSWORD=your password KEY_ALIAS=your alias KEY_PASSWORD=your password
注意没有字符串双引号""
接下在guild.gradle文件中读取signing.properties配置文件,读取的代码如下:
File propFile = file('signing.properties'); if (propFile.exists()) { def Properties props = new Properties() props.load(new FileInputStream(propFile)) if (props.containsKey('STORE_FILE') && props.containsKey('STORE_PASSWORD') && props.containsKey('KEY_ALIAS') && props.containsKey('KEY_PASSWORD')) { android.signingConfigs.release.storeFile = file(props['STORE_FILE']) android.signingConfigs.release.storePassword = props['STORE_PASSWORD'] android.signingConfigs.release.keyAlias = props['KEY_ALIAS'] android.signingConfigs.release.keyPassword = props['KEY_PASSWORD'] } else { android.buildTypes.release.signingConfig = null } } else { android.buildTypes.release.signingConfig = null }
代码很简单,就是读取文件,然后拿到签名需要的四个变量值分别赋值即可。
多渠道打包
由于国内Android市场众多渠道,为了统计每个渠道的下载及其它数据统计,就需要我们针对每个渠道单独打包。
gradle的多渠道打包很简单,因为gradle已经帮我们做好了很多基础功能。
下面以友盟统计为例说明,一般友盟统计在AndroidManifest.xml里面会有这么一段声明:
<meta-data android:name="UMENG_CHANNEL" android:value="CHANNEL_ID" />
其中CHANNEL_ID就是友盟的渠道标示,多渠道的实现一般就是通过修改CHANNEL_ID值来实现的。
接下来将一步一步来实现多渠道版本打包。
1.在AndroidManifest.xml里配置PlaceHolder,用与在build.gradle文件中来替换成自己想要设置的值
<meta-data android:name="UMENG_CHANNEL" android:value="${UMENG_CHANNEL_VALUE}" />
2.在build.gradle设置productFlavors,修改PlaceHolder的值
productFlavors { playStore { manifestPlaceholders = [UMENG_CHANNEL_VALUE: "playStore"] } miui { manifestPlaceholders = [UMENG_CHANNEL_VALUE: "miui"] } wandoujia { manifestPlaceholders = [UMENG_CHANNEL_VALUE: "wandoujia"] } }
或者批量修改
productFlavors { playStore {} miui {} wandoujia {} } //批量处理 productFlavors.all { flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name] }
按照上面两步即可编译打多渠道包了,命令是./gradlew assembleRelease,可以打包所有的多渠道包。
通过下面这张图可以看到gradle可以执行的task。
如果只是想打单渠道包,则执行相应的task即可,如gradle assemblePalyStoreRelease就是打PlayStore渠道的Release版本。
3.如果希望可以对最终的文件名做修改,如需要针对不同的需求生成不同的文件。而修改文件名也很简单,参考以下代码即可实现
def releaseTime() { return new Date().format("yyyy-MM-dd", TimeZone.getTimeZone("UTC")) } android{ applicationVariants.all { variant -> variant.outputs.each { output -> def outputFile = output.outputFile if (outputFile != null && outputFile.name.endsWith('.apk')) { File outputDirectory = new File(outputFile.parent); def fileName if (variant.buildType.name == "release") { fileName = "app_v${defaultConfig.versionName}_${releaseTime()}_${variant.productFlavors[0].name}.apk" } else { fileName = "app_v${defaultConfig.versionName}_${packageTime()}_debug.apk" } output.outputFile = new File(outputDirectory, fileName) } } } }
此方法有一定局限性,就是渠道包多了之后编译花费的时间会很长,这里推荐美团打包的第三种方法。
buildConfigField自定义配置
大家可能会遇到下面这种情况,就是Beta版本服务器和Release版本服务器通常不在一台服务器上,而测试希望可以同时发布两个服务器的版本用于测试,这个时候我们就需要修改代码,然后一个一个老老实实的发包。gradle提供buildConfigField配合多渠道打不同服务器版本的方法。
其实用法很简单,首先在相应的节点加上定义,比如:
buildTypes { debug { buildConfigField "boolean", "LOG_DEBUG", "true"//是否输出LOG信息 buildConfigField "String", "API_HOST", "\"http://api.test.com\""//API Host } }
然后在代码中通过BuildConfig.LOG_DEBUG或者BuildConfig.API_HOST调用即可。
dex突破65535的限制
随着项目的一天天变大,慢慢的都会遇到单个dex最多65535个方法数的瓶颈,如果是ANT构建的项目就会比较麻烦,但是Gradle已经帮我们处理好了,而添加的方法也很简单,总共就分三步 :
1.首先是在defaultConfig节点使能多DEX功能
android { defaultConfig { // dex突破65535的限制 multiDexEnabled true } }
2.然后就是引入multidex库文件
dependencies { compile 'com.android.support:multidex:1.0.0' }
3.最后就是你的AppApplication继承一下MultiDexApplication即可。
完整的gradle脚本
一份项目中使用的完整的gradle文件配置
// 声明是Android程序 apply plugin: 'com.android.application' // 定义一个打包时间 def releaseTime() { return new Date().format("yyyy-MM-dd", TimeZone.getTimeZone("UTC")) } android { // 编译SDK的版本 compileSdkVersion 21 // build tools的版本 buildToolsVersion '21.1.2' defaultConfig { // 应用的包名 applicationId "com.**.*" minSdkVersion 14 targetSdkVersion 21 versionCode 1 versionName "1.0" // dex突破65535的限制 multiDexEnabled true // 默认是umeng的渠道 manifestPlaceholders = [UMENG_CHANNEL_VALUE: "umeng"] } // 移除lint检查的error lintOptions { abortOnError false } //签名配置 signingConfigs { debug { // No debug config } release { storeFile file("../yourapp.keystore") storePassword "your password" keyAlias "your alias" keyPassword "your password" } } buildTypes { debug { // buildConfigField 自定义配置默认值 buildConfigField "boolean", "LOG_DEBUG", "true" buildConfigField "String", "API_HOST", "\"http://api.test.com\""//API Hos versionNameSuffix "-debug" minifyEnabled false //是否zip对齐 zipAlignEnabled false shrinkResources false signingConfig signingConfigs.debug } release { // buildConfigField 自定义配置默认值 buildConfigField "boolean", "LOG_DEBUG", "false" buildConfigField "String", "API_HOST", "\"http://api.release.com\""//API Host //// 是否进行混淆 minifyEnabled true zipAlignEnabled true // 移除无用的resource文件 shrinkResources true //混淆规则文件 proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' signingConfig signingConfigs.release applicationVariants.all { variant -> variant.outputs.each { output -> def outputFile = output.outputFile if (outputFile != null && outputFile.name.endsWith('.apk')) { // 输出apk名称为boohee_v1.0_2015-06-15_wandoujia.apk def fileName = "boohee_v${defaultConfig.versionName}_${releaseTime()}_${variant.productFlavors[0].name}.apk" output.outputFile = new File(outputFile.parent, fileName) } } } } } // 友盟多渠道打包 productFlavors { wandoujia {} _360 {} baidu {} xiaomi {} tencent {} taobao {} ... } productFlavors.all { flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name] } } dependencies { // 编译libs目录下的所有jar包 compile fileTree(dir: 'libs', include: ['*.jar']) compile 'com.android.support:support-v4:21.0.3' compile 'com.jakewharton:butterknife:6.0.0' ... }
其他整理
Android Studio系列教程五--Gradle命令详解与导入第三方包
ZipAlign对apk进行优化
参考
安卓集成发布详解(二)
Gradle插件用户指南(译)
Android Studio系列教程六--Gradle多渠道打包
使用Gradle构建Android项目
使用gradle构建android项目(续)