Android Developers
Essentials
  • Modern Android
  • Quickly bring your app to life with less code, using a modern declarative approach to UI, and the simplicity of Kotlin.
  • Explore Modern Android
  • Adopt Compose for teams
  • Get started
  • Start by creating your first app. Go deeper with our training courses or explore app development on your own.
  • Hello world
  • Training courses
  • Tutorials
  • Kotlin for Android
  • Monetization with Play
  • Extend by device
  • Build apps that give your users seamless experiences from phones to tablets, watches, and more.
  • Tablets and foldables
  • Wear OS
  • Android for Cars
  • Android TV
  • ChromeOS
  • Cross-device SDK
  • Build by category
  • Learn to build for your use case by following Google's prescriptive and opinionated guidance.
  • Games
  • Media apps
  • Health & Fitness
  • Enterprise apps
  • Get the latest
  • Stay in touch with the latest releases throughout the year, join our preview programs, and give us your feedback.
  • Platform releases
  • Android Studio preview
  • Jetpack & Compose libraries
  • Wear OS preview
  • Privacy Sandbox
Design & Plan
  • Kits & more
  • Get one of our Figma kits for Android, Material Design, or Wear OS, and start designing your app's UI today.
  • Go to Android & Material kits
  • Go to Wear OS kits
  • UI Design
  • Design a beautiful user interface using Android best practices.
  • Design for Android
  • Mobile
  • Large screens
  • Wear OS
  • TV
  • Architecture
  • Design robust, testable, and maintainable app logic and services.
  • Introduction
  • Libraries
  • Navigation
  • Modularization
  • Testing
  • Quality
  • Plan for app quality and align with Play store guidelines.
  • Overview
  • Core value
  • User experience
  • Technical quality
  • Privacy & security
  • Build for Billions
  • Create the best experience for entry-level devices
  • Overview
  • About new markets
  • Android (Go edition)
Develop Google Play
  • English
  • Bahasa Indonesia
  • Deutsch
  • Español
  • Español – América Latina
  • Français
  • Português – Brasil
  • Tiếng Việt
  • Türkçe
  • Русский
  • ภาษาไทย
  • 中文 – 简体
  • 中文 – 繁體
  • 日本語
  • 한국어
  • Android Studio
Download Android Studio editor Android Gradle Plugin SDK tools Preview
Android Developers
  • Essentials
    • More
  • Design & Plan
    • More
  • Develop
    • Download
    • Android Studio editor
    • Android Gradle Plugin
    • SDK tools
    • Preview
  • Google Play
  • What's new in Android build
    • Android Gradle Plugin release notes
    • Android Gradle Plugin roadmap
    • Android Gradle plugin API updates
    • Past Android Gradle Plugin releases
  • Configure your build
    • Understand the Android build system
    • Java versions in Android builds
    • Configure the app module
    • Add build dependencies
    • Configure build variants
    • Use the Android Gradle plugin Upgrade Assistant
    • Use the Android SDK Upgrade Assistant
    • Migrate to the Kotlin DSL
    • Migrate to version catalogs
    • Migrate to Kotlin Symbol Processing
    • Build your app from the command line
    • Build your app for release to users
  • Optimize your build
    • Overview
    • Troubleshoot build performance
    • Profile your build
    • Gradle tips and recipes
    • Manage manifest files
    • Shrink your app
    • D8 and R8 compiler version compatibility
    • Enable multidex
  • Extend your build
    • Write Gradle plugins
    • Integrate a custom C/C++ build system
  • Publish your library
    • Overview
    • Prepare your library for release
    • Configure publication variants
    • Configure test fixtures for publication
    • Upload your library
  • Troubleshoot
  • Android Gradle plugin API reference
  • Modern Android
  • Explore Modern Android
  • Adopt Compose for teams
  • Get started
  • Hello world
  • Training courses
  • Tutorials
  • Kotlin for Android
  • Monetization with Play
  • Extend by device
  • Tablets and foldables
  • Wear OS
  • Android for Cars
  • Android TV
  • ChromeOS
  • Cross-device SDK
  • Build by category
  • Games
  • Media apps
  • Health & Fitness
  • Enterprise apps
  • Get the latest
  • Platform releases
  • Android Studio preview
  • Jetpack & Compose libraries
  • Wear OS preview
  • Privacy Sandbox
  • Kits & more
  • Go to Android & Material kits
  • Go to Wear OS kits
  • UI Design
  • Design for Android
  • Mobile
  • Large screens
  • Wear OS
  • TV
  • Architecture
  • Introduction
  • Libraries
  • Navigation
  • Modularization
  • Testing
  • Quality
  • Overview
  • Core value
  • User experience
  • Technical quality
  • Privacy & security
  • Build for Billions
  • Overview
  • About new markets
  • Android (Go edition)
  • Android Developers
  • Develop
  • Android Studio
  • Android Gradle Plugin

Troubleshoot the Android Gradle plugin

If you encounter issues with the Android Gradle plugin, try the following actions:

  • Check whether your issue is listed in the Android Studio troubleshooting guide or the known issues. Those pages list known issues and workarounds.
  • If your issue persists, file a bug.

Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Last updated 2023-04-12 UTC.

  • WeChat WeChat
    Follow Google Developers on WeChat
  • Twitter Twitter
    Follow @AndroidDev on Twitter
  • YouTube YouTube
    Check out Android Developers on YouTube
  • More Android

    • Android
    • Enterprise
    • Security
    • Source
  • Support

    • Report platform bug
    • Report documentation bug
    • Google Play support
    • Join research studies
  • Documentation

    • Developer guides
    • Design guides
    • API reference
    • Samples
    • Android Studio
Google Developers
  • Android
  • Chrome
  • Firebase
  • Google Cloud Platform
  • All products
  • Privacy
  • License
  • Brand guidelines
  • ICP证合字B2-20070004号
  • Get news and tips by email Subscribe
  • English
  • Bahasa Indonesia
  • Deutsch
  • Español
  • Español – América Latina
  • Français
  • Português – Brasil
  • Tiếng Việt
  • Türkçe
  • Русский
  • ภาษาไทย
  • 中文 – 简体
  • 中文 – 繁體
  • 日本語
  • 한국어