文章目录

Android Plugin DSL Reference 参考文档 :





一、Gradle 扩展属性简介


org.gradle.api.Project 配置 ( build.gradle 根配置 ) 文档 : ​​https://docs.gradle.org/current/javadoc/org/gradle/api/Project.html​​



Android 工程中的 build.gradle 构建脚本 , 在编译时会被自动转为 org.gradle.api.Project 类

如果我们想要自定义 Project 属性 , 就需要用到 扩展属性 机制 ;

在 build.gradle 中直接使用 Groovy 代码即可实现 对 Project 类的扩展 ;



在 Groovy 中定义普通属性代码如下 : 普通属性是局部变量 , 只能在本构建脚本中使用 ;

// 定义普通属性
def hello = 'Hello World!'

在 Groovy 中定义扩展属性代码如下 : 扩展属性是全局变量 , 对所有子项目可见 ;

// 定义扩展属性 , 其中的变量对所有子项目可见
ext {
    hello1 = 'Hello World1!'
    hello2 = 'Hello World2!'
}






二、Gradle 自定义 task 任务示例 ( 扩展属性示例 )


在 build.gradle 中定义 变量 , 然后自定义 task 任务 , 输出该变量 , 代码如下 :

// 定义局部变量
def hello = 'Hello World!'

// 定义扩展属性 , 其中的变量对所有子项目可见
ext {
    hello1 = 'Hello World1!'
    hello2 = 'Hello World2!'
}

// 自定义任务 , 输出自定义变量
task sayHello {
    println hello
    println hello1
    println hello2
}

然后在 Terminal 面板中 , 执行

gradlew sayHello

命令 , 也就是执行 sayHello 任务 , 输出结果为 :

D:\002_Project\002_Android_Learn\Android_UI>gradlew sayHello

> Configure project :app
Hello World!
Hello World1!
Hello World2!

【Android Gradle 插件】Gradle 扩展属性 ① ( Gradle 扩展属性简介 | Gradle 自定义 task 任务示例 )_html

完整的 build.gradle 构建脚本如下 :

plugins {
    id 'com.android.application'
    id 'kotlin-android'
}

android {
    compileSdkVersion 31
    buildToolsVersion "30.0.3"

    defaultConfig {
        applicationId "kim.hsl.android_ui"
        minSdkVersion 18
        targetSdkVersion 31
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
}

dependencies {

    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
    implementation 'androidx.core:core-ktx:1.6.0'
    implementation 'androidx.appcompat:appcompat:1.4.1'
    implementation 'com.google.android.material:material:1.5.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.3'
    testImplementation 'junit:junit:4.+'
    androidTestImplementation 'androidx.test.ext:junit:1.1.3'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
}

// 定义局部变量
def hello = 'Hello World!'

// 定义扩展属性 , 其中的变量对所有子项目可见
ext {
    hello1 = 'Hello World1!'
    hello2 = 'Hello World2!'
}

// 自定义任务 , 输出自定义变量
task sayHello {
    println hello
    println hello1
    println hello2
}