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

Posted 韩曙亮

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Android Gradle 插件Gradle 扩展属性 ① ( Gradle 扩展属性简介 | Gradle 自定义 task 任务示例 )相关的知识，希望对你有一定的参考价值。

文章目录

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 类 , 在 build.gradle 中调用的 android , dependencies 等方法 , 都定义在 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!

完整的 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

以上是关于Android Gradle 插件Gradle 扩展属性 ① ( Gradle 扩展属性简介 | Gradle 自定义 task 任务示例 )的主要内容，如果未能解决你的问题，请参考以下文章

Android Gradle 插件Gradle 自定义 Plugin 插件 ② ( buildSrc 目录中实现 Gradle 插件 | 实现 Gradle 插件代码 | 模块引入插件并编译 )

Android Gradle 插件Android Module 模块 build.gradle 构建脚本 Groovy 语法分析 ① ( Gradle 二进制插件引入 | Gradle依赖配置 )

Android Gradle 插件Android Module 模块 build.gradle 构建脚本 Groovy 语法分析 ① ( Gradle 二进制插件引入 | Gradle依赖配置 )

Android Gradle 插件Gradle 自定义 Plugin 插件 ③ ( 自定义插件作用 | Android Gradle 插件的扩展 | 自定义 Extension 扩展 )

Android Gradle 插件自定义 Gradle 插件模块 ② ( 在模块中定义插件 | 引入自定义 Gradle 插件模块 | 配置 Gradle 插件上传选项 | 配置分组名称版本号 )

Android Gradle插件与Gradle的区别