Plantilla .gitignore de Gradle explicada
Explica la estructura con la que Gradle.gitignore ignora las carpetas .gradle y build y recupera con patrones de negación las carpetas build bajo src y el jar del wrapper de Gradle.
Gradle.gitignore tiene solo 9 líneas, pero usa tres patrones de negación para proteger con precisión lo que no debe ignorarse. Casi siempre se usa junto con las plantillas de Java o Kotlin.
El wrapper de Gradle (gradlew, gradle/wrapper/gradle-wrapper.jar, gradle-wrapper.properties) permite compilar con la misma versión incluso a quien no tiene Gradle instalado, así que siempre se debe confirmar. La documentación oficial de Gradle también indica incluir los archivos del wrapper en el control de versiones.
Explicación regla por regla
| Patrón | Qué ignora y por qué |
|---|---|
.gradle | Caché de GradleEs la carpeta donde se guardan la caché de tareas y los hashes de archivos de cada proyecto. Si se borra, se vuelve a crear en la siguiente compilación. |
**/build/!**/src/**/build/ | Carpeta de compilación y excepciónExcluye las carpetas de salida build/ de todos los módulos, pero si dentro del árbol de código (src/) hay por casualidad un paquete o carpeta llamado build, lo recupera. Por ejemplo, evita que src/main/java/com/example/build/ se tome por un artefacto de compilación y desaparezca. |
!gradle-wrapper.jar!gradle-wrapper.properties | Protección del wrapperVuelve a incluir el jar del wrapper para que la regla *.jar de las plantillas de Java y Kotlin no lo ignore. Como git sigue la última regla que coincide, esta línea solo tiene efecto si está después de *.jar. |
gradle-app.setting.gradletasknamecache | Caché de GUI y tareasSon la configuración de la GUI de Gradle y la caché de nombres de tareas para el autocompletado del shell. |
.project.classpath | Archivos generados de EclipseSon archivos de proyecto que Eclipse Buildship genera a partir de la configuración de Gradle. Se pueden volver a crear en cualquier momento desde el script de compilación. |
Precauciones en la práctica
- En el generador, selecciona primero Java (o Kotlin) y después Gradle. Si el orden es el inverso,
!gradle-wrapper.jarqueda delante y*.jarvuelve a ignorarlo detrás. Puedes comprobarlo poniendogradle/wrapper/gradle-wrapper.jaren el probador de patrones. gradle.propertiesno se ignora. Pero la información de firma personal y los tokens van en~/.gradle/gradle.properties, en el directorio del usuario, no en el archivo del proyecto.local.properties(ruta del SDK de Android) no está en esta plantilla, así que en un proyecto Android usa también la plantilla de Android.
Plantilla 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
Origen de las plantillas: github/gitignore/Gradle.gitignore @356fd7b (2026-09-11) · CC0-1.0