Android中gradle.properties 和 gradle-wrapper.properties 作用

我们更深入地了解这两个文件的作用和它们可以包含的一些常见配置。

gradle.properties

gradle.properties文件是一个标准的Java属性文件，它允许你为Gradle构建配置全局属性。这些属性可以在项目的任何地方使用，包括项目的子项目。以下是一些常见的配置项：

• org.gradle.jvmargs: 设置Gradle JVM的启动参数，例如，可以设置最大堆大小来提高构建性能。

  org.gradle.jvmargs=-Xmx2048m
  

• org.gradle.daemon: 启用或禁用Gradle守护进程，这可以提高构建速度。

  org.gradle.daemon=true
  

• org.gradle.configureondemand: 配置为true时，Gradle仅配置请求的项目，而不是整个项目结构。

  org.gradle.configureondemand=true
  

• android.enableAapt2: 启用或禁用AAPT2，这是一个Android资源处理工具。

  android.enableAapt2=true
  

• android.useAndroidX: 启用AndroidX库，这是Android支持库的继承版本。

  android.useAndroidX=true
  

• kotlin.code.style: 设置Kotlin代码的编码风格，比如使用官方或严格风格。

  kotlin.code.style=official
  

gradle-wrapper.properties

gradle-wrapper.properties文件位于项目的gradle/wrapper目录下，它定义了Gradle Wrapper的配置。这个文件包含了两个主要的属性：

• distributionUrl: 指定Gradle分发包的URL。这个URL用于下载和使用特定的Gradle版本。例如：

  distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-all.zip
  

  这里的URL应该指向一个有效的Gradle分发包。

• distributionBase: 指定分发包的存储基础URL。这是一个可选属性，用于自定义分发包的下载位置。

• distributionPath: 指定分发包应该存储在本地文件系统中的位置。通常，这个属性默认为$GRADLE_USER_HOME/wrapper/dists。

• zipStorePath: 指定压缩包存储的位置。通常，这个属性默认为$GRADLE_USER_HOME/wrapper/dists。

• wrapperVersion: 指定Gradle Wrapper的版本。这是一个可选属性，用于确保使用特定版本的Gradle Wrapper。

这些配置确保了所有开发者和构建系统使用相同的Gradle版本，从而减少版本不一致导致的问题。在多人协作的项目中，通常需要将gradle-wrapper.properties文件纳入版本控制，以确保所有开发者使用的Gradle版本一致。

通过合理配置这两个文件，你可以优化构建过程，提高构建速度，同时确保项目的构建环境一致性。