解决Isar Flutter库在compileSdk 34下的资源链接错误

在Flutter开发中使用Isar数据库时，许多开发者遇到了一个常见的构建错误，特别是在升级到compileSdk 34后。这个错误通常表现为Android资源链接失败，提示"resource android:attr/lStar not found"。

问题背景

当开发者尝试构建Flutter应用时，特别是在发布模式下，Gradle任务:isar_flutter_libs:verifyReleaseResources会失败。错误信息表明系统找不到Android资源属性lStar，这通常发生在使用较新版本的compileSdk时。

根本原因

这个问题的根源在于Isar Flutter库与最新Android SDK版本的兼容性问题。lStar是Android较新版本引入的一个属性，当库的compileSdk版本与项目配置不一致时，就会出现这种资源链接错误。

解决方案

通过在项目的android/build.gradle文件中添加特定的Gradle配置脚本，可以解决这个问题。以下是完整的解决方案：

allprojects {
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.buildDir = "../build"
subprojects {
  afterEvaluate { project ->
    if (project.plugins.hasPlugin("com.android.application") ||
      project.plugins.hasPlugin("com.android.library")) {
      project.android {
        compileSdkVersion 34
        buildToolsVersion "34.0.0"
      }
    }
    if (project.hasProperty("android")) {
      project.android {
        if (namespace == null) {
          namespace project.group
        }
      }
    }
  }
  
  project.buildDir = "${rootProject.buildDir}/${project.name}"
}

subprojects {
  project.evaluationDependsOn(":app")
}

tasks.register("clean", Delete) {
  delete rootProject.buildDir
}

解决方案解析

1. 统一compileSdk版本：脚本确保所有子项目都使用compileSdk 34，避免了版本不一致导致的资源链接问题。

2. 命名空间处理：为没有明确设置namespace的Android模块提供默认命名空间，这是Android Gradle插件的新要求。

3. 构建目录配置：正确设置构建目录结构，确保Gradle能找到所有必要的构建产物。

4. 项目依赖管理：通过project.evaluationDependsOn(":app")确保正确的项目评估顺序。

注意事项

如果遇到"Cannot run Project.afterEvaluate(Closure) when the project is already evaluated"错误，请注意：

• 将project.evaluationDependsOn(":app")放在单独的subprojects块中
• 确保配置顺序正确，避免在项目已经评估后尝试修改配置

结论

这个解决方案不仅适用于Isar Flutter库，对于其他Flutter插件在compileSdk 34下出现的类似资源链接问题也有参考价值。通过统一SDK版本和正确配置Gradle，可以确保构建过程顺利进行。

对于Flutter开发者来说，理解这些构建配置的细节非常重要，特别是在处理原生Android模块时。这种问题通常会在Flutter或插件升级时出现，掌握解决方法可以节省大量调试时间。