Android Studio常用Gradle操作

一、Gradle介绍
Gradle是一个高级构建系统和构建工具，允许通过插件自定义构建逻辑。Gradle的实质是配置脚本，执行一种类型的配置脚本时就会创建一个关联的对象，它由三种脚本类型构成，分别是构建脚本(Build Script)、初始化脚本(Init Script)及设置脚本(Settings Script)，其对应的三种代理对象分别是Project对象、Gradle对象及Settings对象。

二、Gradle基础配置

1. Android Studio对应工程目录
   
2. settings.gradle文件介绍
   该文件是全局的项目配置文件，里面主要声明一些需要加入gradle的module。
3. build.gradle文件介绍
   该文件如果是面向工程的，一般用来存储构建脚本的版本来源及工程的仓库来源，如下图所示，指定的构建工具版本是gradle1.2.3，该工具及全局工程的仓库来源都是jcenter；

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.2.3'
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

而如果该文件面向的是对应的module，则一般指定的module类型，Android相关及依赖库，如下图所示为常用配置。

//module类型，常用的如：'com.android.application'、'com.android.library'、'java'、'maven'等。
apply plugin: 'com.android.application'

//Android常用配置
android {
    //编译版本
    compileSdkVersion 22
    //构建工具版本
    buildToolsVersion "22.0.1"
    //默认配置
    defaultConfig {
        //应用包名
        applicationId 'com.xyy.example'
        //最小版本
        minSdkVersion 15
        //目标版本
        targetSdkVersion 22
        //应用版本号
        versionCode 1
        //应用版本名称
        versionName "1.0"
        //是否允许dex文件超过65535大小，默认打开
        multiDexEnabled true
    }
    //指定编译版本
    compileOptions{
        sourceCompatibility JavaVersion.VERSION_1_7
        targetCompatibility JavaVersion.VERSION_1_7
    }
    //lint检查配置，默认关闭
    lintOptions {
        abortOnError false
    }
    //渠道指定
    productFlavors {

    }
    //签名配置
    signingConfigs {
        //调试版本
        debug {
            storeFile file('×.keystore')
            storePassword ×××
            keyAlias ××××
            keyPassword ×××
        }
        //发布版本
        release {
            //签名文件目录指定，相对于该module
            storeFile file('×.keystore')
            //签名密码
            storePassword ×××
            //Alias名称
            keyAlias ××××
            //Alias密码
            keyPassword ×××    
        }
    }
    //构建类型配置
    buildTypes {
        debug {
            buildConfigField("boolean", "LOG_DEBUG", "true")
            versionNameSuffix "debug"
            minifyEnabled false
            zipAlignEnabled false
            shrinkResources false
            signingConfig signingConfigs.debug
        }
        release {
            //添加buildConfig配置字段，可以设置日志打印开关字段，方便发布时自动关闭打印日志
            buildConfigField("boolean", "LOG_DEBUG", "false")
            //在生成的release版本APK后缀中添加"release"字段
            versionNameSuffix "release"
            //是否混淆（特别注意：如果混淆文件未配置使用false）
            minifyEnabled false
            //是否支持Zip Align
            zipAlignEnabled true
            //是否清理无用资源
            shrinkResources true
            //混淆文件指定
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            //签名指定
            signingConfig signingConfigs.release
        }
    }
    //相关源路径的设置
    sourceSets{
        main{
            manifest.srcFile 'AndroidManifest.xml'
            java.srcDirs = ['src']
            resources.srcDirs = ['src']
            aidl.srcDirs = ['src']
            renderscript.srcDirs = ['src']
            res.srcDirs = ['res']
            assets.srcDirs = ['assets']
            jniLibs.srcDirs = ['libs']
        }
    }
}

//依赖配置
dependencies {
    //本地依赖文件树
    compile fileTree(dir: 'libs', include: ['*.jar'])
    //远程依赖
    compile '...'
    //远程编译时依赖库但不包含该库，防止重复包含引起包冲突
    provided '...'
    //本地依赖文件
    compile files('...')
    //本地编译时依赖文件，不包含该文件
    provided files('...')
    //本地依赖工程
    compile project('...')
}

4 gradle.properties文件介绍
该文件一般用来存储工程范围内的全局属性，而如果是与开发者个人相关且不便纳入版本控制的属性，则放到 $HOME/.gradle 下的 gradle.properties 文件，比如签署app的密钥等。

三、多渠道打包配置

1.在AndroidManifest.xml中设置PlaceHolder(占位符)
在application下添加

<meta-data
    android:name="渠道名称"
    //渠道名称，可以使用android:value="${变量名}"，假如变量名为XYY_FLAVORS，下面使用该变量进行说明
    android:value="渠道ID"
    />

2.在对应module中的build.gradle文件中设置productFlavors(渠道信息)
首先在defaultConfig下设置默认渠道

manifestPlaceholders = [XYY_FLAVORS: "渠道ID"]

然后在android下指定需要打包的渠道信息

productFlavors {
    渠道ID1 {}
    渠道ID2 {}
    渠道ID3 {}
    渠道ID4 {}
    ...
}
productFlavors.all {
    flavor -> flavor.manifestPlaceholders = [XYY_FLAVORS: name]
}

最后在buidTypes的release下指定发布时的渠道包名称

applicationVariants.all {
    variant -> variant.outputs.each {
        output -> def outputFile = output.outputFile
           if(outputFile != null && outputFile.name.endsWith(".apk")){
                def fileName = "xyy_v${defaultConfig.versionName}_${variant.productFlavors[0].name}.apk"
                output.outputFile = new File(outputFile.parent, fileName)
            }
    }
}

3.使用assemble命令进行打包
使用./gradlew assemble+productFlavor+buildType进行打包，如：
./gradlew assembleBaiduRelease指定Baidu的release版本；
./gradlew assembleBaidu指定Baidu的release和debug版本；
./gradlew assembleRelease指定所有渠道的release版本；
./gradlew assemble指定所有渠道的release和debug版本。

四、Maven仓库管理配置
1、本地配置，针对所有该用户下所有工程
在$HOME/.gradle下添加init.gradle文件，这是Gradle初始化脚本，也是面向用户的全局配置，配置如下：

allprojects{
repositories {
    def REPOSITORY_URL = '本地仓库路径'
    //主要逻辑是判定如果是maven2及jcenter仓库，都先执行本地仓库
    all { ArtifactRepository repo ->
        if(repo instanceof MavenArtifactRepository){
            def url = repo.url.toString()
            if (url.startsWith('https://repo1.maven.org/maven2') || url.startsWith('https://jcenter.bintray.com/')) {
                project.logger.lifecycle "Repository ${repo.url} replaced by $REPOSITORY_URL."
                remove repo
                }
            }
        }
        maven {
            url REPOSITORY_URL
        }
    }
}

2、在对应工程的build.gradle配置

allprojects {
    repositories {
        maven{
            credentials{
                username    '用户名'
                password    '密码'
            }
            url '本地仓库路径'
        }
        //jcenter()
        //mavenLocal()
    }
}

3、上传代码到本地仓库配置
在需要上传的module下的build.gradle中添加如下配置

apply   plugin:'maven'
uploadArchives{
    repositories{
        mavenDeployer{
            //指定groupId，在仓库下展示为路径com/xyy/example
            pom.groupId = "com.xyy.example"
            //指定版本号
            pom.version = "1.0.0"
            repository(url: "本地仓库路径"){
                authentication(userName: 用户名, password: 密码) 
            }
        }
    }
}

五、自动化测试配置
在需要进行测试的module下的build.gradle文件中添加

apply from: '../config/quality.gradle'

在工程下新建config文件夹，将如下路径https://github.com/xiaoyaoyou1212/vb-android-app-quality/tree/master/config下的文件下载后放置到该文件夹下，再在该工程下使用gradle findbugs、gradle checkstyle、gradle lint及gradle pmd进行代码检查，检查的结果会在build下的reports文件夹下。

六、参考链接

1. Gradle插件用户指南(译)
2. 拥抱Gradle:下一代自动化工具
3. Gradle脚本基础全攻略