Gradle Android客户端程序打包（基于gradle 2.10版本验证通过）

一、前言

　　目前正在准备从eclipse开发环境向AndroidStudio迁移，提前过去探探路，不出所料，原来gradle脚本果然报错，无法运行，想想索性把本地的gradle一起升级到最新版本，毕竟1.22有点太古老了。

　　仍然不废话，先上干货。

二、准备工作

*1、首先，如果使用eclipse作为开发环境，需右键点击项目，在菜单中选择“Export…”

*2、然后，在弹出的列表中依次选择“Android->Generate Gradle build files”

*3、选择"Next>"

*4、再选择"Next>"

*5、在列表中勾选需要创建gradle配置脚本的项目，继续"Next>"

*6、选择"Finish"

至此，eclipse中已生成gradle配置脚本，可能这是需要右键刷新一下项目

三、简单项目Gradle打包脚本配置

//build脚本配置，指定gradle版本
buildscript {
    repositories {
        jcenter()
    }
    dependencies
        classpath 'com.android.tools.build:gradle:2.0.+'
    }
}

//项目配置版本号，与apk输出目录
ext.appVersionCode = 2
ext.appVersionName = "2.0"
ext.appReleaseDir = "/Users/freedoms/Desktop/release"

//插件配置
apply plugin: 'com.android.application'

//获取时间戳
def getDate() {
    def date = new Date()
    def formattedDate = date.format('yyyyMMdd')
    return formattedDate
}

//程序包配置
android {
    compileSdkVersion 19
    buildToolsVersion "21.1.2"

    sourceSets {
        main {
            manifest.srcFile 'AndroidManifest.xml'
            java.srcDirs = ['src']
            resources.srcDirs = ['src']
            aidl.srcDirs = ['src']
            renderscript.srcDirs = ['src']
            res.srcDirs = ['res']
            assets.srcDirs = ['assets']

            //项目中含有so包，需增加jni相关目录配置，否则程序运行到调用so时将发生错误
            jniLibs.srcDir(['libs'])
        }
        instrumentTest.setRoot('tests')
        debug.setRoot('build-types/debug')
        release.setRoot('build-types/release')
}

//打包开始时，lint运行将有可能发生错误，当有异常发生时，此设置将忽略警告，继续运行脚本，若忽略，打包过程将被强行终止
lintOptions {
    abortOnError false
}

//
packagingOptions {
    exclude 'META-INF/maven/com.belerweb/pinyin4j/pom.xml'
    exclude 'META-INF/maven/com.belerweb/pinyin4j/pom.properties'
}

//签名配置
signingConfigs {
    myConfig {
        storeFile file("/Users/freedoms/Desktop/产品需求文档/android.keystore")
        storePassword "123123"
        keyAlias "android.keystore"
        keyPassword "123123"
    }
}

//混淆配置
buildTypes{
    release {
        //不需混淆设置为false
        minifyEnabled false
        signingConfig  signingConfigs.myConfig
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-project.txt'
    }
}

//自定义配置
productFlavors {
    //百度
    baidu{
        //AndroidManifest.xml配置中定义的占位符补全配置，实例中在AndroidManifest.xml中配置"${UMENG_CHANNEL_VALUE}",脚本运行后，将baidu_android_channel自动替换到此位置，AndroidManifest.xml其他需要分渠道动态配置的参数可以参考此做法操作
            manifestPlaceholders = [UMENG_CHANNEL_VALUE:"baidu_android_channel",BAIDU_CHANNEL_VALUE:"baidu_baidu_android_channel"]
    }
    //360
    "360"{//若配置渠道名为数字开头，必须加引号
        manifestPlaceholders = [UMENG_CHANNEL_VALUE:"360_android_channel",BAIDU_CHANNEL_VALUE:"baidu_360_android_channel"]
    }
    //可参考以上两项进行扩展……
}

    //打包重命名算法，输出XXX_Android_v2.0_20160127_baidu.apk到脚本前配置的输出目录当中
    android.applicationVariants.all { variant ->
        def file = variant.outputs[0].outputFile
        if(variant.buildType.name.equals('release')){
            variant.outputs[0].outputFile = new File(appReleaseDir + '/','XXX_Android_v' + appVersionName +getDate()+ '_' + variant.productFlavors[0].name + '.apk')
        }
    }
}

//编码配置
tasks.withType(JavaCompile) {
    options.encoding = "UTF-8"
}

四、带有项目依赖关系的gradle打包脚本配置

（一）、依赖项目

1、如果使用eclipse作为开发环境，首先需要生成gradle配置脚本（详见二、准备工作）

2、修改gradle脚本中apply plugin为以下配置

apply plugin: 'android-library'

3、其他配置同主项目，可参考简单项目gradle脚本配置

（二）、主项目

*1、如果使用eclipse作为开发环境，首先需要生成gradle配置脚本（详见二、准备工作）

*2、修改gradle脚本中apply plugin为以下配置

apply plugin: 'com.android.application'

*3、在主项目根目录下创建setting.gradle文本文件，用作引用依赖项目配置

//引入依赖项目名

include 'library'

include 'library_pullToRefresh'

//创建目录引用，最后引号中是依赖项目存放的绝对路径

project(':library').projectDir = new File('/Users/freedoms/git/library')

project(':library_pullToRefresh').projectDir = new File('/Users/freedoms/git/library_pullToRefresh')

4、在主项目的build.gradle中增加以下配置

//依赖配置

dependencies {

compile fileTree(dir: 'libs', include: '.jar')

compile project(':library_pullToRefresh')

compile project(':library')

}

五、运行build脚本

*1、在命令行中cd 到主项目根目录下

*2、输入gradle clean执行（清理gradle生成的检查文件和打出的APK，可以不做，但是不保证中间是否会有什么奇怪问题，养成好习惯）

*3、输入gradle check执行（检查项目，根据渠道数量不同需要时间不同）

*4、输入gradle build执行（执行build脚本，开始打包，根据渠道数量不同需要

*5、检查主项目build.gradle配置的输出目录中，打好的渠道包已经在里面了

六、注意事项（待续）

Q1、在执行check或者build时，可能会报如下错误

FAILURE: Build failed with an exception.
* What went wrong:
Execution failed for task ':lint'.
> Lint found errors in the project; aborting build.
  Fix the issues identified by lint, or add the following to your build script to proceed with errors:
  ...
  android {
      lintOptions {
          abortOnError false
      }
  }
  ...
* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output.
BUILD FAILED

*A1:在build.gradle脚本中增加

lintOptions {

abortOnError false

}

Q2:根据渠道数量的多少，可能在打包时会报java虚拟机内存不足

The system is out of resources.
Consult the following stack trace for details.
java.lang.OutOfMemoryError: Java heap space
    at com.sun.tools.javac.util.Position$LineMapImpl.build(Position.java:139)
    at com.sun.tools.javac.util.Position.makeLineMap(Position.java:63)
    at com.sun.tools.javadoc.DocCommentScanner.getLineMap(DocCommentScanner.java:438)
    at com.sun.tools.javac.main.JavaCompiler.parse(JavaCompiler.java:512)
    at com.sun.tools.javac.main.JavaCompiler.parse(JavaCompiler.java:550)
    at com.sun.tools.javac.main.JavaCompiler.parseFiles(JavaCompiler.java:804)
    at com.sun.tools.javac.main.JavaCompiler.compile(JavaCompiler.java:727)
    at com.sun.tools.javac.main.Main.compile(Main.java:353)
    at com.sun.tools.javac.api.JavacTaskImpl.call(JavacTaskImpl.java:115)

*A2:可减少一次打包的渠道数量，然后再打包另一部分渠道（曲线救国）

七、一点废话

此次更新版本依然保留了前一个版本未曾改变的很多配置，之前每次最无奈的就是吸收别人的经验的时候，对一个全面的配置有所保留，所以，为别人传授经验时还是把完整的脚本都提供出来以方便后人。