深入剖析gradle.properties文件

一、gradle.properties文件在哪

gradle.properties文件是Gradle项目中的一个属性文件，用于定义Gradle构建文件的属性。在一个简单的Gradle项目中，gradle.properties文件应该位于项目根目录下。如果一个Gradle项目包含多个模块，每个模块都可以有一个gradle.properties文件，也可以定义一个位于根目录的全局gradle.properties文件。

为了在Gradle中引用这些属性，可以使用project的属性查找机制，或者使用System.getProperty()方法中的-D参数。

二、gradle.properties文件的作用

gradle.properties文件可以用来定义许多不同的Gradle项目属性，例如：

– 配置项目版本号和组织ID

– 配置Java源代码和测试代码的根路径

– 配置依赖管理以及存储库管理，例如mavenCentral()

– 配置构建项目时使用的插件

– 配置Gradle构建时需要的JVM参数

– 等等……

三、如何在项目中使用gradle.properties文件

以下是在项目中使用gradle.properties文件的步骤：

1. 在项目根目录下创建一个名为gradle.properties的文件。

2. 打开该文件并添加任何项目属性，以键值对的形式表示。

3. 在一个Gradle构建脚本中，可以使用project对象的属性访问这些属性。

//gradle.properties文件
group=cn.example.project
version=1.0.0

//build.gradle文件
apply plugin: 'java'
description 'Example Java Library'

//组织ID和版本号通过project对象属性获取
group = project.group
version = project.version

sourceCompatibility = 1.8
targetCompatibility = 1.8

//声明使用Maven中心库
repositories {
    mavenCentral()
}

dependencies {
    //在这里添加你需要的依赖
}

四、gradle.properties文件的高级用法

1、使用外部文件

在Gradle脚本中引用外部.properties文件的方法非常简单。可以使用Properties文件类将.properties文件中的文本加载到Java properties对象中。以下是如何实现的示例：

//gradle.properties
prop1=exampleValue
prop2=anotherValue

//build.gradle
Properties props = new Properties()
file("$projectDir/gradle.properties").withInputStream { 
    inputStream -> props.load(inputStream) 
}
def myProp1 = props.getProperty("prop1")
def myProp2 = props.getProperty("prop2")

2、添加系统环境变量

在Gradle脚本中添加系统环境变量非常容易。可以使用System.getenv()方法获取系统环境变量。以下是如何实现的示例：

//将环境变量赋给一个project属性
project.ext.absPath = System.getenv("MY_ENV_VAR")

3、使用命令行参数

可以使用-JvmArgs参数在命令行上向Gradle添加JVM参数。Gradle也接受-D参数，该参数会在Gradle启动时传递给JVM。可以使用这些参数向Gradle项目传递额外的属性，例如：

gradle -DmyProp1=exampleValue -DmyProp2=anotherValue build

总结

gradle.properties文件是Gradle项目中一个非常有用的文件，它可以用于定义Gradle构建处理的各种属性，例如构建版本号，依赖管理等。在Gradle项目中使用它可以使你的项目更加灵活和易于管理。