Welcome to the Gradle 9 Migration Helper documentation! This guide will help you migrate your Gradle projects to Gradle 9.
- Quick Start Guide - Get up and running in 5 minutes
- Installation - How to install and run
- System Requirements - What you need
- User Guide - Complete guide to using the tool
- Web UI Guide - Using the web interface
- CLI Guide - Using via command line
- API Reference - REST API endpoints and examples
- Detection Patterns - What issues are detected
- Troubleshooting - Common problems and solutions
- Spring Boot Projects - Migrating Spring Boot apps
- Android Projects - Migrating Android projects
- Multi-Module Projects - Complex project structures
New to the tool? → Start with Getting Started
Already installed? → Jump to User Guide
Having issues? → Check Troubleshooting
Need API details? → See API Reference
Want to contribute? Check out our Contributing Guidelines
The Gradle 9 Migration Helper automatically:
- Detects 12 types of Gradle 9 compatibility issues in your project
- Explains what needs to change and why
- Auto-fixes 9 out of 12 issue types automatically
- Creates backups before making any changes
- Works with single and multi-module projects
- ✅ 12 Detection Patterns - Catches all common Gradle 9 issues
- ✅ 75% Auto-Fix Rate - 9 out of 12 patterns can be fixed automatically
- ✅ Multi-Module Support - Handles complex project structures
- ✅ Web UI - Easy-to-use browser interface
- ✅ REST API - Integrate with CI/CD pipelines
- ✅ Safe Backups - Never lose your original code
The tool detects these Gradle 9 compatibility issues:
| Issue Type | Severity | Auto-Fix |
|---|---|---|
Deprecated configurations (compile, runtime) |
Critical | ✅ Yes |
| Deprecated dependency methods | Critical | ✅ Yes |
| Gradle version compatibility | Critical | ✅ Yes |
| Deprecated Convention API | High | ✅ Yes |
| Archive task properties | High | ✅ Yes |
| Task left-shift operator | High | ✅ Yes |
| Deprecated API methods | High | ✅ Yes |
| SourceSet output properties | High | ✅ Yes |
| Property assignments | Medium | ✅ Yes |
| Dynamic properties usage | Medium | ❌ Manual |
| Legacy buildscript classpath | Medium | ❌ Manual |
| Deprecated task types | High | ❌ Manual |
See Detection Patterns for detailed information.
- Issues & Bugs: Check Troubleshooting first
- Questions: See the User Guide FAQ section
- Examples: Browse Examples for your use case
Ready to get started? → Quick Start Guide