Gradle 7.3.1 User Guide

userguide.md

Gradle 7.3.1 User Guide

Running Gradle Builds

Authoring Gradle Builds

Learning the Basics

• Build Script Basics
• Authoring Tasks
• Writing Build Scripts
• Working With Files
• Using Gradle Plugins
• Build Lifecycle
• Logging
• Avoiding traps

Structuring Individual Builds (個々のビルドの構造化)

• Structuring and Building a Software Component with Gradle
• Declaring Dependencies between Subprojects
• Sharing Build Logic between Subprojects
• Fine Tuning the Project Layout
• Configuration time and execution time

Structuring Software Products

• Structuring Large Projects
• Tweaking Project Structure
• Composing builds

Authoring Sustainable Builds (持続可能なビルドのオーサリング)

• Organizing Gradle Projects
• Best practices for authoring maintainable builds

Advanced Techniques

• Testing Build Logic with TestKit
• Using Ant from Gradle

Authoring JVM Builds

Authoring JVM Builds

• Building Java & JVM projects
• Testing in Java & JVM projects
• Toolchains for JVM projects
• Managing Dependencies of JVM Projects

JVM Plugins

• The Java Library Plugin
• The Application Plugin
• The Java Platform Plugin
• The Groovy Plugin
• The Scala Plugin

Working with Dependencies

Learning the Basics

• Dependency management in Gradle
• Declaring repositories
• Declaring dependencies
• Understanding the difference between libraries and applications
• Viewing and debugging dependencies
• Understanding dependency resolution
• Verifying dependencies

Declaring Versions

• Declaring Versions and Ranges
• Declaring Rich Versions
• Handling versions which change over time
• Locking dependency versions

Controlling Transitives

• Upgrading versions of transitive dependencies
• Downgrading versions and excluding dependencies
• Sharing dependency versions between projects
• Aligning dependency versions
• Handling mutually exclusive dependencies
• Fixing metadata with component metadata rules
• Customizing resolution of a dependency directly
• Preventing accidental dependency upgrades

Producing and Consuming Variants of Libraries

• Declaring Capabilities of a Library
• Modeling feature variants and optional dependencies
• Understanding variant selection
• Working with Variant Attributes
• Sharing outputs between projects
• Transforming dependency artifacts on resolution

Publishing Libraries

• Publishing a project as module
• Understanding Gradle Module Metadata
• Signing artifacts
• Customizing publishing
• Maven Publish Plugin
• Ivy Publish Plugin

Dependency Management Terminology

• Terminology

Authoring C++/Swift Builds

Extending Gradle

Reference

• Gradle Plugin Reference
• Command-Line Interface
• Gradle & Third-party Tools
• Executing Gradle builds on Jenkins
• Executing Gradle builds on TeamCity
• Executing Gradle builds on Travis CI
• The Gradle Wrapper
• The Directories and Files Gradle Uses