gradle-guide

CURRENTLY IN PROGRESS

A guide for writing good Gradle plugins and a plugin to check for bad Gradle code.

Table of Contents

1. Introduction
   1. What is this guide?
   2. In the lair of the complexity demon
2. Background: What is a Gradle file?
   1. .gradle files
   2. Gradle script Groovy <-> Java transliteration
   3. settings.gradle file
   4. build.gradle files
3. Anatomy of a Gradle Plugin
   1. A simple motivating example
   2. Plugins
   3. Extensions
   4. Tasks
   5. Next steps
4. Testing and running your plugins
   1. Testing locally
   2. Running your plugin in other repos locally
   3. Debugging your Gradle plugin running on a different repo
   4. Running your plugin in other repos on CI
5. Managed Types and Properties
   1. Managed types
6. Diagnosing Build Performance
   1. Expectations of performance
   2. Finding a build scan
   3. Tasks: How to diagnose performance issues
   4. Configuration: How to diagnose performance issues
   5. Common perf issues