Gradle构建Android项目

签名

gradle自己支持直接签名,只须要在releas部分添加以下代码便可html

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文件通常都会集成到代码的版本控制中,这样全部人都会有签名文件的密码。android

因此应该把签名文件的密码隔离起来,写到一个配置文件中,此配置文件不包含在代码版本控制中,这样其余开发者就不会知道签名文件的密码。git

gradle配置文件通常以.properties结束,咱们先新建一个signing.properties文件,内容以下:github

STORE_FILE=yourapp.keystore
STORE_PASSWORD=your password
KEY_ALIAS=your alias
KEY_PASSWORD=your password

注意没有字符串双引号""api

接下在guild.gradle文件中读取signing.properties配置文件,读取的代码以下:android-studio

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已经帮咱们作好了不少基础功能。app

下面以友盟统计为例说明,通常友盟统计在AndroidManifest.xml里面会有这么一段声明:ide

<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项目(续)