Android 中的Gradle

翻译自stackoverflow
转载请注明

一个最基本的build.gradle 文件

这是一个默认的一个模块的build.gradle

apply plugin: 'com.android.application'

android {
    signingConfigs {
        applicationName {
            keyAlias 'applicationName'
            keyPassword 'password'
            storeFile file('../key/applicationName.jks')
            storePassword 'anotherPassword'
        }
    }
    compileSdkVersion 24
    buildToolsVersion '24.0.1'

    defaultConfig {
        applicationId 'com.company.applicationName'
        minSdkVersion 15
        targetSdkVersion 24
        versionCode 1
        versionName '1.0'
        signingConfig signingConfigs.applicationName
    }
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])

    compile 'com.android.support:appcompat-v7:24.1.1'
    compile 'com.android.support:design:24.1.1'

    testCompile 'junit:junit:4.12'
}

DSL(domain-specific language)

在这个文件里的每一个块成为一个DSL

Plugins

第一行，apply plugin: 'com.android.application' 应用安卓插件G绕到了去构建项目，使得android {}可以去指定安卓构建选项

android {…}

这个模块是也是一个安卓DSL，这个DSL包含了你的项目的信息。它的子模块defaultConfig，持有了你的清单文件的默认值。你可以稍后重写它。

Dependencies

这个dependencies 指定了你的应用里想引入哪些外部的库（通常是Android库，当然了Java库也可以，比如说Gson）。Gradle会自动下载这些依赖，你只需要加上compile 当你想使用别的库。例子

`compile ‘com.android.support:design:24.1.1’

`
这一行就好像在说“给我的安卓应用加上设计支持库”。Gradle会保证这个库下载，并且可以使用。它的代码也会引入到你的app里。
如果一熟悉Maven，Maven的语法是 GroupId：ArtifactId：版本号，可以让你完全控制享用那个版本。

当然你也可以指定artifact的版本通过使用+号，但现实是最好不要这样做，因为有可能库会会更新，有些更新你可能还不知道，这就会导致问题。

注意：v7是appcompat-v7

compile 'com.android.support:appcompat-v7:24.1.1

最简单的意思就是这个库（Appcompat）在Api7以后才行。

指定不同构建方式的依赖

你可以指定一个依赖，这个依赖只能在特定的构建方式下才能用（比如debug，test或者release）。可以通过使用debugCompile, testCompile or releaseCompile而不是通用的compile

这个可以保证你的app尽可能的小，并且任何debug的信息都不能被用作去获得你app的核心信息。

签名配置

signingConfig 允许你为Gradle配置包含keystore的信息，保证在构建应用的时候会使用这些配置，然后正确的签名。

注意：不推荐在你的Gradle文件里写签名的配置。

在你的签名配置中你可以指定：
- storeFile：keystore文件
- storePassword：keystore的密码
- keyAlias：key 的别名
- keyPassword：key别名的密码

可以定义signingConfigs 块去 配置

android {
    signingConfigs {

        myConfig {
            storeFile file("myFile.keystore")
            storePassword "myPasswork"
            keyAlias "aKeyAlias"
            keyPassword "myAliasPassword"
        }
    }
    //....
}

附录：通过示例代码深入理解Dsl

/**
 * 不说了，上面有
 */

apply plugin: 'com.android.application'

/**
 * 在android {} block 里去配置所有构建的选项。
 */

android {

  /**

   * compileSdkVersion 之情了Gradle需要使用的API版本去编译你的app，这意味着你的app可以使用Api版本以及以下的功能。
   *
   * buildToolsVersion 指定了SDK build tools的版本，命令行工具以及Gradle将会使用的编译器。你需要通过SKD Manager去下载build tools
   */

  compileSdkVersion 23
  buildToolsVersion "23.0.3"

  /**
   * 在defaultConfig {} 里包含了默认的设置和所有构建变量的实体，可以动态的重写清单文件的一些属性。，你可以为了你的不同版本去配置product flavor去重写这些值。
   */

  defaultConfig {

    /**
     * 应用唯一的id，在打包和发布时候会用到。你的代码应该是定义在清单文件中的包名

     */

    applicationId 'com.example.myapp'

    // 最小的版本.
    minSdkVersion 14

    // 测试版本
    targetSdkVersion 23

    // 版本号
    versionCode 1

    // 用户看到的版本号
    versionName "1.0"
  }

  /**
   * 在 buildTypes {} 这里你可以配置多个build type。默认的，构建系统定义了两种模式：debug和release。debug迷失不是显示的展示默认的构建参数，但包含了debugging工具和debug key。release版本应用Proguard 设置，默认没有被签名
   */

  buildTypes {

    /**
     * 默认的, Android Studio 配置的是release，确保代码的压缩，使用minifyEnabled，之情proguard设置文件
     */

    release {
        minifyEnabled true // 确保代码的压缩
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
  }

  /**
   * 在 productFlavors {} 模块 你可以配置多个productFlavors ，这个允许你可以创建不同版本的app，这些app可以分别重写 各自的defaultConfig {}。productFlavors 是可选项，编译系统不会默认的去创建他们，下面的例子创建了一个free and paid flavor。每一个 profuct flavor之情了各自的application Id，所以他们都能存在在Google Play 商店、安卓设备上。
   */

  productFlavors {
    free {
      applicationId 'com.example.myapp.free'
    }

    paid {
      applicationId 'com.example.myapp.paid'
    }
  }
}

/**
 * dependencies {} 在module层的配置只指定了这个模块所需要的依赖
 */

dependencies {
    compile project(":lib")
    compile 'com.android.support:appcompat-v7:24.1.0'
    compile fileTree(dir: 'libs', include: ['*.jar'])
}