React Native Android项目Gradle构建报错及后续问题求助

云原生阿岚

2026-7-21

解决方案

1. 修复 `Unresolved reference: TIRAMISU` 错误

TIRAMISU 是 Android API 33（Android 13）的版本代号，react-native-gesture-handler 较新版本的代码中使用了这个常量，要求项目的 compileSdkVersion 至少为 33。你已将其改为33，接下来同步配置并解决新架构相关错误即可。

2. 修复 `BuildConfig.IS_NEW_ARCHITECTURE_ENABLED` 找不到符号错误

该错误源于新架构相关的 BuildConfig 字段未生成，按以下步骤处理：

步骤1：确认新架构配置状态

打开项目根目录的 gradle.properties，检查配置：

newArchEnabled=false

如果该值为 true 但你并未启用新架构，改为 false；若确实需要启用新架构，确保后续配置匹配。

步骤2：清理构建缓存并同步依赖

执行命令清理缓存、刷新依赖后重新构建：

./gradlew clean
./gradlew build --refresh-dependencies

步骤3：对齐依赖版本兼容性

确保 react-native-gesture-handler 版本与当前 React Native 版本匹配。若版本过高，可尝试降级到兼容版本（例如 RN 0.70+ 可搭配 gesture-handler 2.8.0 系列）。修改 package.json 后执行 npm install 或 yarn install。

步骤4：统一项目的 SDK 版本配置

打开项目级 android/build.gradle，统一 SDK 版本变量：

buildscript {
    ext {
        compileSdkVersion = 33
        targetSdkVersion = 33
        // 其他配置...
    }
}

打开应用级 android/app/build.gradle，引用项目级变量：

android {
    compileSdkVersion rootProject.ext.compileSdkVersion
    defaultConfig {
        targetSdkVersion rootProject.ext.targetSdkVersion
        // 其他配置...
    }
}