Template .gitignore do Kotlin explicado

O Kotlin.gitignore consiste nas regras do template de Java mais o diretório .kotlin/ usado pelo plugin Gradle do Kotlin. Isso porque compilar código Kotlin/JVM produz os mesmos .class e .jar que o Java.

Não inclui regras de ferramentas de build. A maioria dos projetos Kotlin usa Gradle, então escolha também o template do Gradle, ou o do Android se for um app Android.

Explicação regra por regra

Padrão	O que ignora e por quê
.kotlin/	Dados do plugin Gradle do KotlinA partir do Kotlin 2.0, o plugin Gradle salva na pasta .kotlin da raiz do projeto dados como informações de sessão e logs de erro. A documentação do Kotlin também orienta adicionar essa pasta ao .gitignore.
*.class*.jar*.war*.nar*.ear*.zip*.tar.gz*.rar	Resultados de compilação e arquivos de pacoteSão bytecode da JVM e arquivos de distribuição. Com o código-fonte e os scripts de build, podem ser criados de novo.
hs_err_pid*replay_pid*	Logs de falha da JVMSão arquivos de diagnóstico deixados quando a JVM termina de forma anormal.
*.log*.ctxt.mtj.tmp/	OutrosSão logs de execução e arquivos das ferramentas BlueJ e J2ME. São regras herdadas como estão do template de Java.

Cuidados na prática

• Para que *.jar não ignore o jar do wrapper do Gradle, coloque o template do Gradle depois do Kotlin, de modo que !gradle-wrapper.jar seja aplicado por último.
• Se você usa um alvo iOS no Kotlin Multiplatform, também precisa de regras relacionadas a Xcode e Swift e do template macOS.
• As configurações do IntelliJ IDEA são tratadas com o template JetBrains.

Template original

# Compiled class file*.class# Log file*.log# BlueJ files*.ctxt# Mobile Tools for Java (J2ME).mtj.tmp/# Package Files #*.jar*.war*.nar*.ear*.zip*.tar.gz*.rar# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xmlhs_err_pid*replay_pid*# Kotlin Gradle plugin data, see https://kotlinlang.org/docs/whatsnew20.html#new-directory-for-kotlin-data-in-gradle-projects.kotlin/

Templates usados em conjunto

Outros templates explicados