How to Fix Gradle Error in React Native Projects

To fix a Gradle error in React Native, first check your android/build.gradle and android/app/build.gradle files for version mismatches or missing dependencies. Then, run ./gradlew clean and rebuild the project to clear caches and fix configuration issues.

Why This Happens

Gradle errors in React Native often happen because of version conflicts, missing SDK components, or corrupted build caches. For example, if your build.gradle files specify incompatible versions of the Android Gradle plugin or dependencies, the build will fail.

groovy

buildscript {
    ext {
        buildToolsVersion = "29.0.2"
        minSdkVersion = 21
        compileSdkVersion = 29
        targetSdkVersion = 29
        kotlinVersion = "1.3.50"
    }

    repositories {
        google()
        jcenter()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:3.5.0'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion"
    }
}

Output

FAILURE: Build failed with an exception.
* What went wrong:
A problem occurred configuring project ':app'.
> Could not resolve all files for configuration ':app:debugCompileClasspath'.
   > Could not find com.android.support:appcompat-v7:28.0.0.
     Searched in the following locations:
       - https://jcenter.bintray.com/com/android/support/appcompat-v7/28.0.0/appcompat-v7-28.0.0.pom
   > Could not find com.facebook.react:react-native:+.
     Searched in the following locations:
       - https://jcenter.bintray.com/com/facebook/react/react-native/maven-metadata.xml

The Fix

Update your build.gradle files to use compatible versions and add missing repositories. Then clean the build cache and rebuild the project. This ensures Gradle downloads the correct dependencies and clears corrupted caches.

groovy

buildscript {
    ext {
        buildToolsVersion = "31.0.0"
        minSdkVersion = 21
        compileSdkVersion = 31
        targetSdkVersion = 31
        kotlinVersion = "1.6.10"
    }

    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:7.0.4'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion"
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://www.jitpack.io' }
    }
}

Output

BUILD SUCCESSFUL in 45s
35 actionable tasks: 35 executed

Prevention

Keep your React Native and Android Gradle plugin versions updated and compatible. Always add google() and mavenCentral() repositories in your Gradle files. Run ./gradlew clean before builds after dependency changes. Use version control to track Gradle file changes and test builds regularly.

Related Errors

• Could not find com.android.support libraries: Add google() repository and update to AndroidX.
• Execution failed for task ':app:compileDebugJavaWithJavac': Check Java SDK version compatibility.
• Gradle daemon out of memory: Increase heap size in gradle.properties with org.gradle.jvmargs=-Xmx2048m.

Key Takeaways

Always keep Gradle and React Native versions compatible and updated.

Add google() and mavenCentral() repositories in all Gradle files.

Run ./gradlew clean to clear caches after dependency changes.

Check error messages carefully to identify missing dependencies or version conflicts.

Use version control to track Gradle configuration changes.