Flutter android debug 编译报错问题。插件编译报错

下面相关内容都以 Mac 电脑为例子。

一、问题

起因：（更新 Android studio 2024.2.2.13、 Flutter SDK 3.27.2）
1. 最近 2025年 1 月左右，我更新了 Android studio 和 Flutter SDK 再运行就会出现下面的问题。
2. 当然下面的提示只是其中之一，即便把所有插件都更新了仍然不行，解决一个还会有第二个插件提示错误 flutter_localizations、firebase_messaging 等等一个接一个全出现编译错误。

FAILURE: Build failed with an exception.

* What went wrong:

Execution failed for task ':shared_preferences_android:compileDebugJavaWithJavac'.

> Could not resolve all files for configuration ':shared_preferences_android:androidJdkImage'.

> Failed to transform core-for-system-modules.jar to match attributes {artifactType=_internal_android_jdk_image, org.gradle.libraryelements=jar, org.gradle.usage=java-runtime}.

> Execution failed for JdkImageTransform: C:\Users\sdvs1\AppData\Local\Android\sdk\platforms\android-34\core-for-system-modules.jar.

> Error while executing process C:\Program Files\Android\Android Studio_2024_2_1_9\jbr\bin\jlink.exe with arguments {--module-path C:\Users\sdvs1\.gradle\caches\transforms-3\4a46fc89ed5f9adfe3afebf74eb8bfeb\transformed\output\temp\jmod --add-modules java.base --output C:\Users\sdvs1\.gradle\caches\transforms-3\4a46fc89ed5f9adfe3afebf74eb8bfeb\transformed\output\jdkImage --disable-plugin system-modules}

* Try:

> Run with --stacktrace option to get the stack trace.

> Run with --info or --debug option to get more log output.

> Run with --scan to get full insights.

> Get more help at https://help.gradle.org.

二、尝试查找原因

恢复老版本
1. 并没有想太多一定是更新所致，所以尝试恢复了之前的版本，（Android studio giraffe、 Flutter SDK 3.22） 果然都正常工作了。
再次升级最新版本：（Android studio 2024.2.2.13、 Flutter SDK 3.27.2）
1. 目的：新项目不再想用老版本，想都统一升级一下技术栈（再次升级最新版）
2. 用新的 Flutter SDK 重新创建版本，安装项目依赖（所有依赖更新到最新版本）仍然出现错误。（空白项目可以启动，安装项目依赖例如：shared_preferences 就开始报错）
查到 Flutter GitHub 有相关 issues： (不止个例大部分人都出现了相关问题)
1. issues 地址 Android plugins: `Failed to transform core-for-system-modules.jar to match attributes` errors with JDK 21 · Issue #156304 · flutter/flutter · GitHub
2. 问题似乎出在 Android studio 身上。（最新版本 android studio 自带了 JDK 21）
3. 手动修改 jdk 版本（JDK 17）
  1. 修改 JDK 文件路径： android/app/build.gradle
    1. ```
        compileOptions {
          sourceCompatibility JavaVersion.VERSION_17
          targetCompatibility JavaVersion.VERSION_17
        }
    
        kotlinOptions {
            jvmTarget = JavaVersion.VERSION_17
        }
```
2. 修改构建工具包 gradle 文件路径：android/gradle/wrapper/gradle-wrapper.properties
  1. ```
  distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip
```
  3. 修改 android/settings.gradle
    1. ```
        id "com.android.application" version "8.3.1" apply false
```
开始正常运行
未知原因：心力憔悴
1. 但是由于我不小心打开了其他 android 项目导致下载了其他的 gradle。不知道是不是这个原因， 又开始报错了～

三、一劳永逸（解决）

准备降级Android stuido 最近可用的版本。（这个 JDK 21 目前来讲感觉很坑，或许是我没搞明白吧）
1. 经过多个版本尝试（最终下载 Android Studio Koala Feature Drop | 2024.1.2）
  1. Android Studio 历史版本下载地址：（只有英文版页面才能看到列表）Android Studio 下载文件归档 | Android Developers
2. 安装前把之前版本 Android studio 删除
3. 删除与资源库同级的 AndroidStudioProjects 文件夹
4. 删除资源库内的 Android , 如果有 java 文件夹一并删除。
为防止出现意外情况，请务必按照上面说的卸载干净。
安装（Android Studio Koala Feature Drop | 2024.1.2）
检查 Flutter Android 是否使用了 jdk17