Konfigurasi Kotlin Compiler

Memasang kompilator hanya langkah pertama; kompilator harus dapat dipanggil dari terminal mana pun agar alur kerja harian kita lancar. Tanpa konfigurasi PATH yang benar, kita harus mengetik path lengkap setiap kali memanggil kotlinc. Pada chapter ini kita akan memastikan direktori bin kompilator berada di PATH, mengatur variabel KOTLIN_HOME sebagai referensi instalasi, dan menguji kompilasi file .kt menjadi berkas .jar yang dapat dieksekusi.

Memahami Struktur Instalasi #

Pemasangan Kotlin dari arsip resmi menghasilkan satu direktori induk yang berisi seluruh komponen kompilator. Mengenali struktur ini membantu kita saat mengonfigurasi variabel lingkungan.

kotlinc/
├── bin/                # Skrip launcher: kotlinc, kotlin, kotlinc-jvm, dll.
├── lib/                # Pustaka Kotlin (kotlin-compiler.jar, kotlin-stdlib.jar, dll.)
├── build.txt           # Versi build kompilator
└── license/

Direktori bin berisi skrip launcher. Skrip kotlinc (di Linux/macOS) dan kotlinc.bat (di Windows) adalah pintu masuk utama yang kita panggil dari terminal. Direktori induk inilah yang akan kita tunjukkan sebagai KOTLIN_HOME.

Mengatur PATH #

PATH adalah variabel lingkungan yang berisi daftar direktori tempat sistem operasi mencari perintah yang kita ketik. Agar kotlinc dapat dipanggil dari mana saja, direktori bin instalasi Kotlin harus masuk ke daftar PATH.

# Linux: tambahkan ke ~/.bashrc atau ~/.profile
export KOTLIN_HOME=/opt/kotlinc
export PATH=$KOTLIN_HOME/bin:$PATH

# macOS (jika dipasang manual di /opt/kotlinc)
export KOTLIN_HOME=/opt/kotlinc
export PATH=$KOTLIN_HOME/bin:$PATH

# Windows (PowerShell, persisten untuk pengguna saat ini)
[Environment]::SetEnvironmentVariable(
    "KOTLIN_HOME",
    "C:\kotlinc",
    "User")
[Environment]::SetEnvironmentVariable(
    "PATH",
    "$env:PATH;C:\kotlinc\bin",
    "User")

Setelah konfigurasi di atas, muat ulang shell agar perubahan dibaca.

# Linux/macOS
source ~/.bashrc    # atau source ~/.profile

# Verifikasi
echo $KOTLIN_HOME
which kotlinc

Output yang umum di Linux setelah konfigurasi benar:

/opt/kotlinc
/opt/kotlinc/bin/kotlinc

Variabel KOTLIN_HOME #

KOTLIN_HOME tidak digunakan secara langsung oleh skrip launcher kotlinc, tetapi banyak tool pihak ketiga — termasuk beberapa plugin editor dan skrip build Gradle — yang membaca variabel ini untuk menemukan instalasi Kotlin. Menetapkan variabel ini sejak awal menyelamatkan kita dari konfigurasi ulang di kemudian hari.

# Cek nilai KOTLIN_HOME
echo "KOTLIN_HOME = $KOTLIN_HOME"

# Cek struktur folder
ls $KOTLIN_HOME/bin

Verifikasi Versi Kompilator #

Perintah kotlinc -version mencetak versi kompilator yang terpasang beserta versi JRE yang digunakan. Perintah ini adalah uji paling cepat untuk memastikan kompilator siap dipakai.

kotlinc -version

Output yang Dihasilkan di lingkungan dengan Kotlin 2.0.21 dan JDK 21:

Kotlin version 2.0.21 (JRE 21)

Perbedaan -version dan -help #

Kompilator kotlinc menerima banyak flag. Dua di antaranya paling sering dipakai untuk inspeksi lingkungan:

Kompilasi File .kt Menjadi .jar #

Setelah kotlinc dapat dipanggil, mari kita uji dengan mengompilasi file sederhana menjadi berkas .jar yang dapat dieksekusi. Simpan kode berikut sebagai hello.kt.

fun main() {
    val versi = KotlinVersion.CURRENT
    val namaCompiler = "kotlinc"
    println("Compiler   : $namaCompiler")
    println("Versi      : ${versi.major}.${versi.minor}.${versi.patch}")
    println("Konfigurasi PATH berhasil")
}

Output yang Dihasilkan:

Compiler   : kotlinc
Versi      : 2.0.21
Konfigurasi PATH berhasil

Mari kita bedah kode di atas:

1. val versi = KotlinVersion.CURRENT: properti bawaan KotlinVersion.CURRENT mengembalikan objek yang merepresentasikan versi kompilator yang sedang berjalan.
2. ${versi.major}.${versi.minor}.${versi.patch}: kita menggunakan string template dengan ekspresi kompleks di dalam ${...} agar properti dapat dirangkai dengan pemisah titik.
3. println(...): mencetak teks ke stdout diikuti newline. String template $namaCompiler menyisipkan nilai variabel ke dalam string tanpa perlu penggabungan manual.

Untuk mengompilasi dan menjalankan file hello.kt, gunakan dua perintah berikut. Flag -include-runtime memastikan berkas .jar akhir dapat dijalankan tanpa library tambahan di classpath.

# 1. Kompilasi menjadi hello.jar (flag -include-runtime menyertakan stdlib)
kotlinc hello.kt -include-runtime -d hello.jar

# 2. Jalankan dengan java -jar
java -jar hello.jar

Mengatasi Masalah Umum #

Beberapa gejala yang sering muncul setelah pemasangan kompilator baru:

• kotlinc: command not found: direktori bin belum masuk PATH. Periksa kembali langkah ekspor PATH dan source file konfigurasi shell.
• Error: could not find or load main class: biasanya JDK yang dipakai terlalu lama (di bawah 17). Perbarui JDK dan pastikan JAVA_HOME konsisten.
• No Java runtime: kotlinc tidak menemukan java di PATH. Verifikasi dengan which java sebelum memanggil kotlinc.

Referensi Resmi #

Dokumentasi resmi untuk pemasangan dan konfigurasi kompilator Kotlin tersedia di:

• https://kotlinlang.org/docs/command-line.html
• https://kotlinlang.org/docs/getting-started.html

Referensi Lanjutan #

• Kotlin command-line compiler — rujukan kompilator CLI Kotlin untuk mengonfigurasi kotlinc dan KOTLIN_HOME

Selanjutnya #

Konfigurasi PATH dan KOTLIN_HOME selesai, dan kompilasi pertama berhasil. Namun, ada kalanya kita ingin bereksperimen tanpa harus membuka editor dan menyimpan file. Pada chapter berikutnya, Menggunakan Kotlin Playground, kita akan memakai playground web resmi untuk menulis dan menjalankan kode Kotlin langsung dari browser tanpa instalasi apa pun.