The Android Troubleshooting Guide for Capacitor

Capacitor is a great tool to build cross-platform apps with web technologies. However, sometimes you might run into issues when building your Android app. This post will help you to troubleshoot common issues.

Help us to improve this guide

If you are aware of any other common issues, please send us an email to [email protected] so that we can update the guide.

Errors

Minimum supported Gradle version is 8.4. Current version is 8.2.1.

This error occurs if you are using a version of the Android Gradle plugin that is incompatible with Capacitor. To fix the problem, you need to use the correct version of the Gradle plugin in your project. You can find the correct version in the Capacitor documentation.

For Capacitor 6, for example, you must use version 8.2.1. Update the Android Gradle plugin version in your root-level (project-level) Gradle file (usually android/build.gradle):

android/build.gradle

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:8.2.1'
    }
}