Разбор шаблона .gitignore для Gradle

Gradle.gitignore состоит всего из 9 строк, но трижды использует отрицающие шаблоны, чтобы точно сохранить то, что игнорировать нельзя. Чаще всего его используют вместе с шаблонами Java и Kotlin.

Обёртку Gradle (gradlew, gradle/wrapper/gradle-wrapper.jar, gradle-wrapper.properties) нужно обязательно коммитить: она позволяет собирать проект одной и той же версией даже тем, у кого Gradle не установлен. Официальная документация Gradle тоже рекомендует хранить файлы обёртки в системе контроля версий.

Разбор правил

Шаблон	Что и почему игнорируется
.gradle	Кэш GradleПапка, где хранятся кэш задач проекта и хэши файлов. Если её удалить, она создастся при следующей сборке.
**/build/!**/src/**/build/	Папки сборки и исключенияВыходные папки build/ всех модулей исключаются, но если в дереве исходников (src/) случайно есть пакет или папка с именем build, они возвращаются. Например, это не даёт src/main/java/com/example/build/ исчезнуть, будучи принятым за артефакт сборки.
!gradle-wrapper.jar!gradle-wrapper.properties	Защита обёрткиСнова включает jar обёртки, чтобы его не игнорировало правило *.jar из шаблонов Java и Kotlin. git следует последнему совпавшему правилу, поэтому строка работает, только если стоит после *.jar.
gradle-app.setting.gradletasknamecache	Кэш GUI и задачНастройки Gradle GUI и кэш имён задач для автодополнения в оболочке.
.project.classpath	Файлы, создаваемые EclipseФайлы проекта, которые Eclipse Buildship создаёт из настроек Gradle. Их всегда можно пересоздать из скриптов сборки.

На что обратить внимание на практике

• В генераторе сначала выберите Java (или Kotlin), а потом Gradle. При обратном порядке !gradle-wrapper.jar окажется впереди, и *.jar снова проигнорирует файл ниже. Проверить это можно, введя gradle/wrapper/gradle-wrapper.jar в тестер шаблонов.
• gradle.properties не игнорируется. Однако личные данные подписи и токены храните не в файле проекта, а в ~/.gradle/gradle.properties в домашнем каталоге пользователя.
• local.properties (путь к Android SDK) в этом шаблоне нет, поэтому для проекта Android используйте вместе с ним шаблон Android.

Исходный шаблон

.gradle**/build/!**/src/**/build/# Ignore Gradle GUI configgradle-app.setting# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)!gradle-wrapper.jar# Avoid ignore Gradle wrapper properties!gradle-wrapper.properties# Cache of project.gradletasknamecache# Eclipse Gradle plugin generated files# Eclipse Core.project# JDT-specific (Eclipse Java Development Tools).classpath

Шаблоны, используемые вместе

Разборы других шаблонов