安卓工程build.gradle中的Groovy的常见知识点

文章目录

变量定义
函数定义
函数调用
闭包参数
APK输出配置
多channel配置
依赖配置
关键总结
常见混淆点
groovy高度兼容java

变量定义

def debugCdnUrl = "\"http://xxx\"" //变量赋值

函数定义

def getTime() {  // 函数定义（def 是 Groovy 中定义变量/函数的关键字）return new Date().format("yyyyMMdd", TimeZone.getDefault())
}

函数调用

apply plugin: 'com.android.application'  // apply 是方法，参数是一个 Map
// （plugin: 'com.android.application' 等价于 [plugin: 'com.android.application']）println "hello world"  // 方法调用（Groovy的 println）signingConfigs {  // 方法调用（接收闭包参数）debug {  // 方法调用（配置 debug 签名）storeFile file('..\\myKey\\xxxKey.jks')  // 方法调用（storeFile 是方法，参数是 file() 的返回值）keyPassword '123456'  // 方法调用（参数字符串）// ...其他同理}
}buildTypes {  // 方法调用debug {  // 方法调用（配置 debug 类型）signingConfig signingConfigs.debug  // 方法调用（参数是 signingConfigs.debug 的返回值）minifyEnabled false  // 方法调用（参数布尔值）buildConfigField("String", "app_key", "\"${app_key}\"")  // 方法调用（三个参数）}
}

闭包参数

android {  // 方法调用（接收闭包参数）compileSdkVersion 30        // 方法调用（参数30）buildToolsVersion '28.0.3'   // 方法调用（参数字符串）useLibrary 'org.apache.http.legacy'  // 方法调用（参数字符串）defaultConfig {  // 方法调用（接收闭包参数）applicationId "com.jy.demo"      // 方法调用（参数字符串）minSdkVersion 21                 // 方法调用（参数21）targetSdkVersion 30              // 方法调用（参数30）// ...其他类似}sourceSets {  // 方法调用（接收闭包参数）main {  // 方法调用（配置 main 的 source set）jniLibs.srcDir 'libs'  // 方法调用（jniLibs 是对象，srcDir 是方法）}// ...其他channel配置同理}
}

APK输出配置

applicationVariants.all { variant ->  // 方法调用（all 是方法，参数是闭包）def buildType = variant.buildType.name  // 属性访问（variant.buildType 是对象，name 是属性）variant.getPackageApplicationProvider().get().outputDirectory = ...  // 方法调用链（getPackageApplicationProvider() 返回对象，再调用 get()）variant.outputs.each {  // 方法调用（each 是 Groovy 的迭代方法）it.outputFileName = ...  // 属性赋值（it 是 outputs 的元素，outputFileName 是属性）}
}

多channel配置

flavorDimensions "channel", 'cdn'  // 方法调用（两个字符串参数）
productFlavors {  // 方法调用（接收闭包参数）p_xxx {  // 方法调用（创建名为 p_xxx 的 flavor）dimension "channel"  // 方法调用（参数字符串）applicationId "com.xxx.demo"  // 方法调用（参数字符串）buildConfigField "String", "apkUpdateUrl", '"..."'  // 方法调用（三个参数）《注入字段》}// ...其他同理
}

依赖配置

dependencies {  // 方法调用（接收闭包参数）p_xxxImplementation fileTree(...)  // 方法调用（p_xxxImplementation 是方法名，参数是 fileTree 的返回值）    p_pftestImplementation fileTree(include: ['*.jar', '*.aar'], dir: 'gamelibs') //demo of previous lineimplementation 'androidx.appcompat:appcompat:1.3.1'  // 方法调用（implementation 是方法，参数字符串）
}

关键总结

方法调用：Groovy 允许省略括号，例如 compileSdkVersion 30 等价于 compileSdkVersion(30)
闭包参数：类似 android { … } 的结构，android 是方法，后面的 { … } 是闭包参数
属性赋值：当代码直接形如 key = value 时（例如 it.outputFileName = …），这是真正的属性赋值。
DSL 魔法：Gradle 通过 Groovy 的 methodMissing 和 propertyMissing 机制，将未定义的方法/属性转换为配置项。

常见混淆点

// buildConfigField：看似是属性，实则是方法，接受三个参数（类型、字段名、值）。// manifestPlaceholders：是方法调用（manifestPlaceholders = [ ... ]），参数是一个 Map。// jniLibs.srcDir 'libs'：jniLibs 是对象，srcDir 是方法，参数是路径。