Flutter Gradle Doctor
A CLI tool to automatically fix common Gradle & Android Gradle Plugin (AGP) issues in Flutter projects, especially when using Java versions 8β24.
Features
- π Detects your Java version and required Gradle version.
- π Checks & fixes Gradle/AGP issues automatically.
- πΎ Creates
.bak
backups before modifying. - π Optional
flutter clean && pub get
. - π§Ή Cleanup and restore commands.
π Coming Soon: Flutter Gradle Doctor Pro
Looking for a one-click solution to fix all Gradle & AGP issues without touching the command line?
Flutter Gradle Doctor Pro will include:
- β Beautiful Desktop GUI (Windows, macOS, Linux)
- β Drag & Drop your Flutter project folders
- β One-click Fix for all Gradle & AGP problems
- β Detailed visual reports and logs
- β Auto-update
π Donβt miss out! Sign up now to get notified when Flutter Gradle Doctor Pro launches: Sign up here
π¦ Installation
Add this to your dev_dependencies
in pubspec.yaml:
dev_dependencies:
flutter_gradle_doctor: ^0.0.1
Then run: dart pub get
π Usage Run from your Flutter project root:
Check the project
dart run gradle_doctor check
Fix Gradle & AGP issues
dart run gradle_doctor fix
Cleanup old backups
dart run gradle_doctor cleanup
Restore files from backups
dart run gradle_doctor restore
β οΈ Notes Supports Java versions 8β24. Versions 25+ are not officially supported.
.bak backups are created before any modification.
If unexpected issues occur, run restore to revert changes.
π License
MIT License Β© 2025 Mohamed Fawzy