Gradle

  • DSL
  • based on Groovy
  • {}：闭包

Gradle for Android

  • 用 V 表示集合 Build Variants，T 表示集合 Build Types，F 表示集合 Product Flavors，则 V = T × F。
  • e.g.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
// app/build.gradle
apply plugin: 'com.android.application'

android { // 当我们在写一个一个的 `{}` 时，其实就是在调用函数，并传一个闭包进去
    compileSdkVersion 25
    buildToolsVersion "23.0.2"

    defaultConfig {
        applicationId "me.sxwang.explore"
        minSdkVersion 15
        targetSdkVersion 25
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            manifestPlaceholders = [CHANNEL: "official"]
        }
    }
    // 这里的 productFlavors 对应
    // void productFlavors(Action<? super NamedDomainObjectContainer<ProductFlavor>> action)
    // 方法，执行该方法内部会调用 action.execute(produtFlavors)。
    // productFlavors 的实际类型为 NamedDomainObjectContainer<ProductFlavor>，
    // NamedDomainObjectContainer 是 Gradle 中定义的一个接口
    // （https://docs.gradle.org/current/dsl/org.gradle.api.NamedDomainObjectContainer.html），
    // 闭包内的代码通过 create(name, configureClosure) ／getByName(name, configureClosure) 
    // 方法实现了对 productFlavors 的配置
    productFlavors {
        wandoujia {
            manifestPlaceholders = [CHANNEL: "wandoujia"]
        }
        xiaomi {
            manifestPlaceholders = [CHANNEL: "xiaomi"]
        }
    }
    // 这里的 productFlavors 对应调用 getProductFlavors() 方法，返回类型为 Collection<ProductFlavor>，
    // Collection 是 Groovy JDK 提供的类（http://docs.groovy-lang.org/latest/html/groovy-jdk/java/util/Collection.html）
    // each() 方法遍历集合中的所有元素，在 Collection 中定义
    // 可见这里使用 each() 仅对前面已经创建的 product flavors 生效
    productFlavors.each { flavor ->
        println("====> Configuring productFlavor: ${flavor.name}")
        flavor.manifestPlaceholders = [CHANNEL: flavor.name]
    }
    // applicationVariants 为 DomainObjectSet<ApplicationVariant> 类型，
    // 虽然也是 Collection 类型，但是此时其集合元素为空，故使用 each() 无效。
    // 当然 DomainObjectSet 也实现了另一个接口 DomainObjectCollection，接口中定义的
    // all() 方法保证对于后续添加的所有元素都会生效
    applicationVariants.all { variant ->
        println("====> Configuring variant: ${variant.name}")
        variant.assemble.dependsOn.each { dependency ->
            println(dependency)
        }
        variant.outputs.each { output ->
            output.outputFile = new File(output.outputFile.parent, "x-${variant.name}.apk")
        }
        variant.assemble.doFirst {
            println("====> doFirst: ${variant.name}")
        }
    }
}

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

参考资料