Template .gitignore do Gradle explicado
Explica a estrutura com que o Gradle.gitignore ignora as pastas .gradle e build e recupera com padrões de negação as pastas build sob src e o jar do wrapper do Gradle.
O Gradle.gitignore tem só 9 linhas, mas usa três padrões de negação para proteger com precisão o que não deve ser ignorado. Na maioria das vezes é usado junto com os templates de Java ou Kotlin.
O wrapper do Gradle (gradlew, gradle/wrapper/gradle-wrapper.jar, gradle-wrapper.properties) permite compilar com a mesma versão até para quem não tem o Gradle instalado, então deve sempre ser commitado. A documentação oficial do Gradle também orienta colocar os arquivos do wrapper no controle de versão.
Explicação regra por regra
| Padrão | O que ignora e por quê |
|---|---|
.gradle | Cache do GradleÉ a pasta onde ficam o cache de tarefas e os hashes de arquivos de cada projeto. Se apagada, é criada de novo no próximo build. |
**/build/!**/src/**/build/ | Pasta de build e exceçãoExclui as pastas de saída build/ de todos os módulos, mas, se dentro da árvore de código (src/) houver por acaso um pacote ou pasta chamado build, ele é recuperado. Por exemplo, evita que src/main/java/com/example/build/ seja confundido com um artefato de build e desapareça. |
!gradle-wrapper.jar!gradle-wrapper.properties | Proteção do wrapperInclui de novo o jar do wrapper para que a regra *.jar dos templates de Java e Kotlin não o ignore. Como o git segue a última regra que corresponde, esta linha só tem efeito se vier depois de *.jar. |
gradle-app.setting.gradletasknamecache | Cache de GUI e tarefasSão a configuração da GUI do Gradle e o cache de nomes de tarefas para o autocompletar do shell. |
.project.classpath | Arquivos gerados do EclipseSão arquivos de projeto que o Eclipse Buildship gera a partir da configuração do Gradle. Podem ser criados de novo a qualquer momento a partir do script de build. |
Cuidados na prática
- No gerador, selecione primeiro Java (ou Kotlin) e depois Gradle. Se a ordem for inversa,
!gradle-wrapper.jarfica antes e*.jar, depois, volta a ignorá-lo. Dá para conferir colocandogradle/wrapper/gradle-wrapper.jarno testador de padrões. - O
gradle.propertiesnão é ignorado. Mas informações pessoais de assinatura e tokens devem ficar em~/.gradle/gradle.properties, no diretório do usuário, e não no arquivo do projeto. - O
local.properties(caminho do SDK do Android) não está neste template, então, em um projeto Android, use também o template do Android.
Template original
.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
Origem dos templates: github/gitignore/Gradle.gitignore @356fd7b (2026-09-11) · CC0-1.0