Kotlin Academy · Ders

kotlinx.serialization Kurulumu

Eklentiyi ekleyin

kotlinx.serialization Kurulumu, CoddyKit'te ücretsiz bir Kotlin Academy dersidir. Bu, 4 dersinin 1. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, Kotlin Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. Kotlin Academy kursu toplamda 4 dersten oluşur.

kotlinx.serialization Nedir?

kotlinx.serialization, nesneleri JSON gibi biçimlere dönüştürmek ve bu biçimlerden geri çevirmek için kullanılan resmi Kotlin kütüphanesidir.

Saf Kotlin, çok platformlu kullanıma hazır
Derleme zamanında kod üretimi (yansıma yok)
JetBrains tarafından sürdürülür

Bir derleyici eklentisiyle birlikte çalışma zamanı kütüphanesi kullanır.

Neden Derleyici Eklentisi?

Yansıma tabanlı kütüphanelerin aksine, kotlinx.serialization serileştiricileri derleme zamanında üretir.

Daha hızlıdır; çalışma zamanında yansıma maliyeti yoktur
Yansımanın sınırlı olduğu Kotlin/Native ve JS üzerinde çalışır
Tür güvenlidir ve derleyici tarafından doğrulanır

Bu nedenle yalnızca bağımlılık eklemekle kalmayıp kotlin-serialization eklentisini de uygulamanız gerekir.

Eklentiyi Uygulama (Kotlin DSL)

build.gradle.kts içinde serileştirme eklentisini, Kotlin eklentinizle aynı sürümde uygulayın.

plugins {
    kotlin("jvm") version "2.0.0"
    kotlin("plugin.serialization") version "2.0.0"
}

Çalışma Zamanı Bağımlılığını Ekleme

Eklenti kod üretir, ancak JSON çalışma zamanı kütüphanesine de ihtiyacınız vardır.

dependencies {
    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.1")
}

Sürüm Uyumu Önemlidir

plugin.serialization sürümü Kotlin derleyicinizin sürümüyle eşleşmelidir. Çalışma zamanı kütüphanesinin kendine ait bağımsız bir sürümü vardır.

Eklenti sürümü = Kotlin sürümü (ör. 2.0.0)
Çalışma zamanı sürümü ayrıdır (ör. 1.7.1)

Uyumsuz eklenti ve Kotlin sürümleri, anlaşılması güç derleme hatalarına yol açar.

Diğer Biçimler

JSON en yaygın biçimdir, ancak kotlinx.serialization ek yapılar aracılığıyla daha fazla biçimi destekler:

kotlinx-serialization-json — JSON
kotlinx-serialization-cbor — CBOR ikili biçimi
kotlinx-serialization-protobuf — Protokol arabellekleri

Yalnızca ihtiyacınız olan biçim yapılarını eklersiniz.

Groovy DSL Eşdeğeri

Projeniz Kotlin DSL yerine Groovy build.gradle kullanıyorsa kurulum şu şekilde görünür.

// build.gradle (Groovy)
plugins {
    id 'org.jetbrains.kotlin.jvm' version '2.0.0'
    id 'org.jetbrains.kotlin.plugin.serialization' version '2.0.0'
}

dependencies {
    implementation 'org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.1'
}

Json Giriş Noktası

Kurulum tamamlandıktan sonra kodlama ve kod çözme için ana giriş noktanız olarak kotlinx.serialization.json içindeki Json nesnesini kullanırsınız.

import kotlinx.serialization.json.Json

val format = Json
// format.encodeToString(...) / format.decodeFromString(...)

En Küçük Çalışan Kod Parçası

Eklenti ve çalışma zamanı yapılandırıldıktan sonra baştan sona çalışan en küçük örnek aşağıdadır.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json

@Serializable
data class City(val name: String, val population: Int)

fun main() {
    val city = City("Istanbul", 15000000)
    val json = Json.encodeToString(city)
    println(json)
}

Çok Platformlu Kurulum

Bir Kotlin Multiplatform projesinde, tüm hedeflerin ortak kullanabilmesi için çalışma zamanını commonMain içine ekleyin.

sourceSets {
    val commonMain by getting {
        dependencies {
            implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.1")
        }
    }
}

Yaygın Kurulum Hataları

Şu sık karşılaşılan sorunlara dikkat edin:

Eklentiyi unutmak — Serializer has not been found hatasını alırsınız
Eklenti sürümünün Kotlin sürümüyle eşleşmemesi
Çalışma zamanını ekleyip eklentiyi eklememek veya bunun tersini yapmak
encodeToString içe aktarmasının eksik olması

Hızlı Kontrol

kotlinx.serialization neden bir Gradle derleyici eklentisi gerektirir?

Özet

kotlinx.serialization kurulumunu şu şekilde yaptınız:

Kotlin sürümünüzle eşleşen kotlin("plugin.serialization") eklentisini uyguladınız
kotlinx-serialization-json çalışma zamanı bağımlılığını eklediniz
Giriş noktası olarak Json nesnesini kullandınız

Sırada model sınıflarına @Serializable ek açıklamasını eklemek var.

Sıkça Sorulan Sorular

“kotlinx.serialization Kurulumu” dersi ücretsiz mi?

Evet — “kotlinx.serialization Kurulumu” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve Kotlin Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. Kotlin Academy kursu toplamda 4 dersten oluşur.

“kotlinx.serialization Kurulumu” dersinde ne öğreneceğim?

Eklentiyi ekleyin Kotlin Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

Kotlin Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te Kotlin Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 1. dersidir.

“kotlinx.serialization Kurulumu” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu Kotlin Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her Kotlin Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

← Kotlin Academy Sayfasına Dön