Gradle 是一个开源构建自动化工具，其设计足够灵活，可以构建几乎任何类型的软件 介绍
由于Android项目是诸多内容的整合, 所以在编译Android项目时也需要具备多种环境:
1、JDK环境
因为Gradle 在 JVM 上运行，您必须安装 Java 开发工具包 (JDK) 才能使用它
下载jdk https://jdk.java.net/ 查看下载结果执行 java -version 输出jdk版本
build.gradle配置jdk环境
compileOptions {
sourceCompatibility JavaVersion.VERSION_11
targetCompatibility JavaVersion.VERSION_11
}
2、Gradle工具和插件环境
安装Gradle 参考 https://docs.gradle.org/current/userguide/installation.html
build.gradle配置gradle插件
buildscript {
repositories {
maven { url 'http://sdk.pt.miui.com/miuisdk/maven2/' }
maven { url 'http://sdk.pt.miui.com/miuisdk/miuix/' }
maven { url 'http://artifactory.d.xiaomi.net/artifactory/artifactory-releases/' }
google()
mavenCentral()
}
dependencies {
classpath 'com.miui.tools.build:gradle:3.4.0'
}
}
Wrapper 是一个脚本，它调用已声明的 Gradle 版本,可以快速启动并运行 Gradle 项目，而无需遵循手动安装过程
使用wrapper好处：
- 在给定的 Gradle 版本上标准化项目，从而产生更可靠和更健壮的构建。
- 为不同的用户和执行环境（例如 IDE 或持续集成服务器）提供新的 Gradle 版本就像更改 Wrapper 定义一样简单。
添加 Gradle wrapper
执行 gradle wrapper
// 升级 Wrapper 版本
执行 ./gradlew wrapper --gradle-version 7.4.2
成功后形成如下结构
├── a-subproject
│ └── build.gradle
├── settings.gradle
├── gradle
│ └── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew
└── gradlew.bat
gradle-wrapper.properties
1、distributionUrl是要使用版本的gradle的地址 官方仓库
gradle的3种版本：
gradle-xx-all.zip是完整版，包含了各种二进制文件，源代码文件，和离线的文档。例如，https://services.gradle.org/distributions/gradle-3.1-all.zip
gradle-xx-bin.zip是二进制版，只包含了二进制文件（可执行文件），没有文档和源代码。例如，https://services.gradle.org/distributions/gradle-3.1-bin.zip
gradle-xx-src.zip是源码版，只包含了Gradle源代码，不能用来编译你的工程。例如，https://services.gradle.org/distributions/gradle-3.1-src.zip
2、zipStoreBase和zipStorePath组合在一起，是下载的gradle-3.1-bin.zip所存放的位置。
zipStorePath是zipStoreBase指定的目录下的子目录。
3、distributionBase和distributionPath组合在一起，是解压gradle.zip之后的文件的存放位置
distributionPath是distributionBase指定的目录下的子目录。
4、zipStoreBase和distributionBase有两种取值：GRADLE_USER_HOME和PROJECT。
其中，GRADLE_USER_HOME表示用户目录。
在windows下是%USERPROFILE%/.gradle，例如C:\Users<user_name>.gradle\。
在linux下是$HOME/.gradle，例如~/.gradle。
PROJECT表示工程的当前目录，即gradlew所在的目录。
gradlew、gradlew.bat
gradlew.bat 是bat 脚本，Windows 用户可以通过它执行 Gradle 任务，配合gradle文件夹使用。
gradlew是一个shell 脚本，Unix Linux通过它来执行 Gradle 任务。
更多指南 参考 wrapper
gradle api https://docs.gradle.org/current/javadoc/index.html?overview-summary.html
android gradle plugin api https://developer.android.com/reference/tools/gradle-api
3、Android环境
运行android项目, 需要设定好Android SDK
local.properties用于配置本地Android SDK目录, 即Android环境
sdk.dir="你本地的sdk目录"
如果本地没有Android SDK , 参考下面文档进行下载
下载Android IDE IDE指南 更新 IDE 和 SDK 工具 命令行更新sdk
4、NDK环境
https://www.jianshu.com/p/8930df7a82b2
5、Q&A
- 执行./gradlew报错 "没有那个文件或目录"
解决办法: 执行gradle init, 此时生成了gradle编译所必须的成员
- 执行./gradlew build报错 "找不到或无法加载主类"
解决办法: 执行gradle wrapper
- JDK环境报错 "java version"
修改编译环境为jdk1.8
- 执行完gradle wrapper后, 执行命令可能报错 "gradle version"
解决办法: 修改gradle版本
distributionUrl=https://services.gradle.org/distributions/gradle-6.1.1-all.zip
- 没有gradle-wrapper.properties报错
Exception in thread "main" java.lang.RuntimeException: Wrapper properties file '/media/duchao/worK/packages/apps/MiRcs/project/gradle/wrapper/gradle-wrapper.properties' does not exist.
at org.gradle.wrapper.WrapperExecutor.forWrapperPropertiesFile(WrapperExecutor.java:45)
at org.gradle.wrapper.GradleWrapperMain.main(GradleWrapperMain.java:60)
解决办法: 下载成员压缩包, 放入gradle目录
- 未配置Android sdk报错
* What went wrong:
> SDK location not found. Define location with an ANDROID_SDK_ROOT environment variable or by setting the sdk.dir path in your project's local properties file at '/media/duchao/worK/packages/apps/MiRcs/project/local.properties'.
解决办法: 见local.properties
