Kotlin 2.4 Yenilikleri Rehberi 2026: Context Parameters, Explicit Backing Fields ve Stabil UUID Desteği

Kotlin 2.4 Neler Getiriyor? (What's New in Kotlin 2.4)

Önce büyük resim. Kotlin 2.4 sürümü, dilin son yıllardaki en önemli "stabilleşme" sürümlerinden biri. Yeni bir sözdizimi bombardımanı yok; bunun yerine uzun süredir deneysel (experimental) bayrağıyla kullanılan özellikler üretime hazır hale getirildi. Bu, kurumsal projeler için aslında daha kıymetli bir haber.

Context Parameters: Bağımlılık Taşımaya Son (Context Parameters Explained)

Bu özelliği anlamak için önce sorunu görelim. Diyelim ki bir servis katmanı yazıyorsunuz ve her fonksiyonun bir Logger ile bir Transaction nesnesine ihtiyacı var. Klasik çözüm nedir? Hepsini parametre olarak taşırsınız:

fun createOrder(
    order: Order,
    logger: Logger,
    tx: Transaction
) {
    logger.info("Siparis olusturuluyor")
    tx.execute { /* ... */ }
}

fun cancelOrder(
    id: Long,
    logger: Logger,
    tx: Transaction
) { /* ayni sey tekrar */ }

Fonksiyon sayısı arttıkça bu liste büyür. Üstelik çağıran taraf da bu nesneleri sürekli elden ele taşımak zorunda kalır. Kotlin bunun için önce "context receivers" adında deneysel bir çözüm denedi, geri bildirimlerle yeniden tasarladı ve nihai hali context parameters olarak 2.4'te stabilleşti.

context(logger: Logger, tx: Transaction)
fun createOrder(order: Order) {
    logger.info("Siparis olusturuluyor")
    tx.execute { /* ... */ }
}

context(logger: Logger, tx: Transaction)
fun cancelOrder(id: Long) {
    logger.warn("Siparis iptal ediliyor: $id")
}

// Cagirma tarafi
with(myLogger) {
    with(myTransaction) {
        createOrder(order)
        cancelOrder(42L)
    }
}

Fark şurada: logger ve tx artık fonksiyonun imzasında görünmüyor ama gövdesinde kullanılabiliyor. Derleyici, çağrıldığı kapsamda uygun tipte bir bağlam olup olmadığını denetliyor. Yoksa derleme hatası alıyorsunuz — çalışma zamanında sürpriz yok.

Context receivers'dan farkı nedir?

Eski deneysel context(Logger) sözdiziminde bağlam nesnesinin adı yoktu; this üzerinden erişiliyordu ve birden fazla bağlam olduğunda hangisinin kastedildiği karışıyordu. Yeni sözdiziminde her bağlamın adı var (context(logger: Logger)), bu yüzden okunabilirlik ciddi şekilde arttı.

Explicit Backing Fields: StateFlow Kalıbının Sonu (Explicit Backing Fields)

Android geliştiricileri bu kalıbı ezbere bilir. Bir ViewModel'de değiştirilebilir bir akış tutarsınız, dışarıya salt-okunur halini açarsınız:

class OrderViewModel : ViewModel() {
    private val _orders = MutableStateFlow<List<Order>>(emptyList())
    val orders: StateFlow<List<Order>> = _orders

    private val _loading = MutableStateFlow(false)
    val loading: StateFlow<Boolean> = _loading
}

Her durum için iki property, alt çizgiyle başlayan isimler, sürekli tekrar eden bir kalıp. Kotlin 2.4 bunu tek satıra indiriyor:

class OrderViewModel : ViewModel() {
    val orders: StateFlow<List<Order>>
        field = MutableStateFlow(emptyList())

    val loading: StateFlow<Boolean>
        field = MutableStateFlow(false)

    fun load() {
        loading.value = true      // sinif icinde: MutableStateFlow
        // ...
    }
}

// Sinif disinda:
// viewModel.orders  -> StateFlow (salt okunur)
// viewModel.orders.value = ...  -> DERLEME HATASI

Sınıfın içinde orders bir MutableStateFlow, dışarıdan bakıldığında ise StateFlow. Tek isim, tek tanım, sıfır alt çizgi. Bu özellik yalnızca Android'de değil; salt-okunur arayüz açmak istediğiniz her yerde işe yarıyor.

@all Meta-Hedefi: Anotasyon Karmaşasına Çözüm (Annotation Use-Site Targets)

Kotlin'de bir property aslında birden fazla Java öğesine karşılık gelir: constructor parametresi, alan (field), getter, bazen setter. Bir anotasyon yazdığınızda hangisine uygulanacağı her zaman net değildir — ve yanlış hedefe giderse kütüphane onu görmez.

data class User(
    @param:JsonProperty("user_name")
    @get:JsonProperty("user_name")
    @field:JsonProperty("user_name")
    val userName: String
)

data class User(
    @all:JsonProperty("user_name")
    val userName: String
)

Tek satır, aynı sonuç. Derleyici anotasyonu uygulanabilir tüm hedeflere dağıtıyor. Jackson, Hibernate, Room gibi anotasyon yoğun kütüphanelerle çalışıyorsanız bu değişiklik kod tabanınızı gözle görülür şekilde sadeleştirir.

Bir de sessiz ama önemli bir iyileştirme var: anotasyon hedefi belirtilmediğinde varsayılan davranış artık daha öngörülebilir kurallara bağlandı. "Neden bu anotasyon çalışmıyor?" sorusunun cevabı çoğu zaman burada saklıydı.

Stabil UUID Desteği: Platform Bağımsız Kimlik (Multiplatform UUID)

Kotlin Multiplatform kullananlar için bu belki de sürümün en pratik yeniliği. Daha önce UUID üretmek için her platformda ayrı bir expect/actual yazmanız gerekiyordu: JVM'de java.util.UUID, iOS'ta NSUUID, JS'te bir npm paketi... Artık ortak koddan tek bir API ile hallediliyor.

import kotlin.uuid.Uuid

// Rastgele UUID uret (v4)
val id = Uuid.random()
println(id)  // ornek: 5b6f1e2a-...-9c3d

// Metinden ayristir
val parsed = Uuid.parse("550e8400-e29b-41d4-a716-446655440000")

// Metne cevir
val text = id.toString()

// Bayt dizisinden / bayt dizisine
val bytes = id.toByteArray()
val fromBytes = Uuid.fromByteArray(bytes)

// commonMain — Android, iOS, web hepsinde ayni kod
data class Order(
    val id: Uuid = Uuid.random(),
    val customerName: String,
    val total: Double
)

fun createDraftOrder(name: String) = Order(
    customerName = name,
    total = 0.0
)

Standart kütüphaneye ayrıca işaretsiz tam sayıları JVM tarafında BigInteger'a çeviren yardımcı fonksiyonlar ve bir koleksiyonun sıralı olup olmadığını kontrol eden yeni fonksiyonlar da eklendi. Küçük ama sık ihtiyaç duyulan eklemeler.

Platform Yenilikleri: JVM, Native, Wasm, JS (Platform Updates)

Kotlin/JVM

• Java 26 desteği — en yeni JDK ile derleme yapabilirsiniz
• Metadata içinde anotasyonlar varsayılan olarak açık; yansıma (reflection) tabanlı kütüphaneler için daha zengin bilgi

Kotlin/Native

• Swift paketleri artık doğrudan bağımlılık olarak eklenebiliyor (Swift packages as dependencies)
• Swift export geliştirildi — Kotlin kodunuz Swift tarafında daha doğal görünüyor
• CMS çöp toplayıcı (garbage collector) varsayılan hale geldi; duraklama süreleri daha öngörülebilir

Kotlin/Wasm

• Artımlı derleme (incremental compilation) varsayılan olarak açık — geliştirme döngüsü belirgin şekilde hızlandı
• WebAssembly Component Model desteği eklendi

Kotlin/JS

• Value class dışa aktarımı (value class export)
• JS kod satır içine alma işleminde (inlining) ES2015 desteği

Kotlin Multiplatform tarafını daha ayrıntılı merak ediyorsanız, Swift export ve platformlar arası geliştirmeyi ele aldığımız Kotlin Multiplatform rehberimiz bu yazının tamamlayıcısı niteliğinde.

Derleme tarafında ise Gradle 9.5.0 uyumluluğu ve Maven'da Java ile JVM hedef sürümlerinin otomatik hizalanması geldi. Bu ikincisi, "Java 21 ile derledim ama Kotlin 17 hedefliyor" tarzı can sıkıcı uyumsuzlukları kendiliğinden çözüyor.

Kotlin 2.4'e Geçiş Adımları (Migration Guide)

// build.gradle.kts
plugins {
    kotlin("jvm") version "2.4.0"
}

kotlin {
    jvmToolchain(21)
}

# gradle.properties — ARTIK GEREKMIYOR, SILIN
# kotlin.experimental.contextReceivers=true

# Derleyici argumanlarindan da kaldirin
# -Xcontext-receivers

# Eski (context receivers)
context(Logger)
fun islem() { info("...") }

# Yeni (context parameters) — bagalama isim verin
context(logger: Logger)
fun islem() { logger.info("...") }

./gradlew clean build --warning-mode all
./gradlew test

Sık Karşılaşılan Hatalar (Common Errors and Fixes)

./gradlew wrapper --gradle-version 9.5.0

📚 Kaynaklar ve Referanslar / Sources and References

Bu rehberdeki bilgiler resmî Kotlin dokümantasyonundan derlenmiş ve Alesta Web ekibi tarafından derlenerek test edilmiştir:

• Kotlin Docs — What's new in Kotlin 2.4.0 · Resmî sürüm notları
• JetBrains Blog — Kotlin 2.4.0 Released · Duyuru ve öne çıkan özellikler
• Kotlin Docs — What's new in Kotlin 2.4.20-Beta2 · Bir sonraki sürümde gelenler
• Kotlin Evolution and Enhancement Process (KEEP) · Özellik tasarım belgeleri
• Kotlin stdlib — kotlin.uuid API referansı · UUID fonksiyonları