Android Studio 2021(Chipmunk)运行Lollipop项目Gradle与JRE版本选择问题

• 2015年1月创建发布基于Lollipop（Android SDK 5.1）的Android项目，上线后运行稳定，后续7年未做任何调整
• 近期因业务需求重新打开项目，当前使用的开发IDE为Android Studio 2021: Chipmunk，将原项目ZIP包解压到../AndroidStudioProjects目录后打开触发多处报错
• 提问者具备Java基础，为Android开发初学者，针对两个核心问题检索多日未得到明确结论

• 适配Lollipop版本的项目应当使用哪个版本的Gradle？Gradle版本是由项目本身配置决定、Android Studio版本决定，还是存在其他判断标准？
• 适配Lollipop版本的项目应当使用哪个版本的JRE？JRE版本的选择依据是什么？

Gradle版本选择逻辑 #

不存在“适配Lollipop必须使用某固定Gradle版本”的说法，Gradle版本不受项目适配的Android系统版本直接约束，判断依据是三层匹配关系：

1. 核心绑定关系是Android Gradle插件（AGP）和Gradle的版本对应：AGP是Google提供的Android编译专用Gradle插件，和Gradle有严格的版本一一对应规则，错配就会直接编译失败。2015年创建的原始项目配套AGP版本基本在1.0.0~1.5.0区间，对应兼容Gradle 2.2.1~2.13，这类版本完全无法在Android Studio Chipmunk上运行——Chipmunk最低支持AGP 3.1（对应Gradle 4.4），最高支持AGP 7.2（对应Gradle 7.3.3）。
2. 当前场景不需要强行还原2015年的旧版Gradle，直接把项目AGP升级到Chipmunk配套的7.2.2版本，搭配Gradle 7.3.3即可。AGP 7.2.2完全支持编译minSdk 21、targetSdk 22的Lollipop适配项目，不会因为编译工具版本高就导致产物无法在5.1系统上运行。
3. 版本配置属于项目自身配置：AGP版本声明在项目根目录的build.gradle文件中，Gradle版本声明在gradle/wrapper/gradle-wrapper.properties文件中，项目迁移时这两个配置会跟随项目走，如果配置版本落在当前IDE的支持区间外，AS打开项目时会主动弹出升级提示。

JRE/JDK版本选择逻辑 #

首先明确：Android项目编译过程使用的是JDK（Java开发工具包），IDE自身运行依赖的JRE和项目编译无关，不需要单独为项目配置JRE。JDK版本选择只和使用的AGP版本绑定，和项目适配的Android系统版本无直接关系：

1. 版本对应规则：
   • AGP 1.x~3.x版本：兼容JDK 7、JDK 8
   • AGP 4.0~7.0版本：最低要求JDK 8，最高兼容JDK 11
   • AGP 7.1~7.2版本（即Chipmunk配套的默认AGP版本）：AS已经内置了匹配的JDK 11，不需要单独下载安装，直接使用内置JDK即可，不会对Lollipop版本兼容性造成任何影响。
2. 不要为了适配旧项目特意安装JDK7及更早版本，这类旧版本JDK无法在新版AS上正常运行。如果要保留项目原有的Java语法兼容性，只需要在模块级build.gradle中将sourceCompatibility和targetCompatibility设置为JavaVersion.VERSION_1_7（对应原项目2015年常用的Java 7语法）或JavaVersion.VERSION_1_8即可，编译出的字节码可以正常在Lollipop系统的虚拟机上运行。

旧项目打开实操提示 #

第一次打开搁置多年的旧项目时，如果AS弹出编译组件升级向导，直接选择默认升级到IDE支持的稳定版本即可，不需要手动保留原始的旧版编译工具链。升级完成后只需要确认模块级build.gradle中的compileSdkVersion、minSdkVersion、targetSdkVersion三个参数和原项目保持一致，就不会改变项目对Lollipop系统的适配逻辑。

内容的提问来源于stack exchange，提问作者David McKay