解决Flutter构建时的Android资源链接失败错误

错误现象：
在 Flutter 项目执行 flutter build apk --release 时，出现以下关键报错：

Android resource linking failed
aapt2 E ... RES_TABLE_TYPE_TYPE entry offsets overlap actual entry data.
aapt2 E ... Failed to load resources table in APK .../android-35/android.jar

问题根源分析

当满足以下全部条件时会出现此错误：

1. 项目的 compileSdk ≥ 35（如 Android API 35）
2. 使用的 Android Gradle Plugin (AGP) 版本低于 8.5.0
3. 系统安装了 Android SDK Platform 35

根本原因：旧版 AGP 无法正确处理 API 35 的资源文件格式，导致 aapt2 工具崩溃。

---

✅ 最佳解决方案：更新 AGP 和 Gradle

步骤 1：升级 Gradle 版本

打开 android/gradle/wrapper/gradle-wrapper.properties，修改 distribution URL：

# 修改此行
distributionUrl=https\://services.gradle.org/distributions/gradle-8.9-bin.zip

步骤 2：更新 AGP 版本

在 android/settings.gradle 中添加 AGP 版本声明：

pluginManagement {
    plugins {
        id "com.android.application" version "8.5.0" apply false
    }
}

步骤 3：清理并重建项目

flutter clean
flutter pub get
flutter build apk --release

---

🔧 备用方案：使用 Flutter 官方推荐配置

如果升级后仍遇到兼容问题，改用 Flutter 的预置变量更安全：

android {
    // 替换硬编码的SDK版本
    compileSdk = flutter.compileSdkVersion
    ndkVersion = flutter.ndkVersion

    defaultConfig {
        minSdk = flutter.minSdkVersion
        targetSdk = flutter.targetSdkVersion
    }
}

原理说明

Flutter SDK 内置了tool版本映射表，
动态分配的版本更稳定（比如 flutter.compileSdkVersion=34 而非 35）。

---

⚠️ 注意事项

1. 版本兼容性
   AGP 8.5.0 配合 API 35 时会出现警告（不影响编译）：

   WARNING: We recommend using a newer Android Gradle plugin...

   可忽略或添加配置到 gradle.properties：

   android.suppressUnsupportedCompileSdk=35

2. 临时解决方法（不推荐）
   如暂时无法升级 AGP，在 gradle.properties 中指定旧版 aapt2：

   android.aapt2Version=8.6.1-11315950

3. 常见误区

   • ✖️ 修改 minSdk/targetSdk 无效
   • ✔️ 必须同步更新 Gradle 和 AGP

---

修改后配置文件示例

android/app/build.gradle 正确示例：

plugins {
    id "com.android.application"
    id "com.google.gms.google-services"
    id "kotlin-android"
    id "dev.flutter.flutter-gradle-plugin"
}

android {
    namespace = "com.example.app"
    compileSdk = 35 // 确保升级AGP后再启用

    defaultConfig {
        applicationId = "com.example.app"
        minSdk = 33
        targetSdk = 34
        // 可考虑替换为flutter.defaultSdkVersion
    }
}

---

通过更新 AGP 和 Gradle 版本，可解决 API 35 的资源链接问题。
核心修复逻辑：新版本 AGP (≥8.5.0) 包含必要的 aapt2 修复，
完全支持 Android SDK Platform 35 的资源格式，避免二进制数据解析错误。