Gradle构建Android项目

jopen 9年前

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自动化之旅—生成渠道包

由于国内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。
Alt text
如果只是想打单渠道包,则执行相应的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项目(续)

本文由 人云思云 创作。来自:http://segmentfault.com/a/1190000002910311