Kotlin Academy · Lektion

kotlinx.serialization einrichten

Fügen Sie das Plugin hinzu

kotlinx.serialization einrichten ist eine kostenlose Kotlin Academy-Lektion auf CoddyKit. Dies ist Lektion 1 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Kotlin Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Kotlin Academy-Kurs umfasst insgesamt 4 Lektionen.

Was ist kotlinx.serialization?

kotlinx.serialization ist die offizielle Kotlin-Bibliothek zum Konvertieren von Objekten in Formate wie JSON und zurück.

Reines Kotlin, für Multiplattform-Projekte geeignet
Codegenerierung zur Compilezeit (keine Reflection)
Von JetBrains gepflegt

Die Bibliothek verwendet ein Compiler-Plugin zusammen mit einer Laufzeitbibliothek.

Warum ein Compiler-Plugin?

Im Gegensatz zu Reflection-basierten Bibliotheken generiert kotlinx.serialization Serializer zur Compilezeit.

Schneller, ohne Reflection-Kosten zur Laufzeit
Funktioniert mit Kotlin/Native und JS, wo Reflection eingeschränkt ist
Typsicher und vom Compiler überprüft

Deshalb müssen Sie das kotlin-serialization-Plugin anwenden und dürfen nicht nur eine Abhängigkeit hinzufügen.

Plugin anwenden (Kotlin-DSL)

Wenden Sie in build.gradle.kts das Serialization-Plugin mit derselben Version wie Ihr Kotlin-Plugin an.

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

Laufzeitabhängigkeit hinzufügen

Das Plugin generiert Code, aber Sie benötigen zusätzlich die JSON-Laufzeitbibliothek.

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

Die Versionsabstimmung ist wichtig

Die Version von plugin.serialization muss mit der Version Ihres Kotlin-Compilers übereinstimmen. Die Laufzeitbibliothek hat eine eigene, unabhängige Version.

Plugin-Version = Kotlin-Version (z. B. 2.0.0)
Laufzeitversion ist separat (z. B. 1.7.1)

Nicht übereinstimmende Plugin- und Kotlin-Versionen verursachen schwer verständliche Build-Fehler.

Weitere Formate

JSON ist am weitesten verbreitet, aber kotlinx.serialization unterstützt über zusätzliche Artefakte weitere Formate:

kotlinx-serialization-json — JSON
kotlinx-serialization-cbor — CBOR-Binärformat
kotlinx-serialization-protobuf — Protocol Buffers

Sie fügen nur die benötigten Format-Artefakte hinzu.

Entsprechung für die Groovy-DSL

Wenn Ihr Projekt statt der Kotlin-DSL Groovy mit build.gradle verwendet, sieht die Einrichtung so aus.

// 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'
}

Der Json-Einstiegspunkt

Nach der Einrichtung verwenden Sie das Json-Objekt aus kotlinx.serialization.json als zentralen Einstiegspunkt zum Kodieren und Dekodieren.

import kotlinx.serialization.json.Json

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

Ein minimales funktionierendes Beispiel

Hier ist das kleinste durchgängige Beispiel, sobald Plugin und Laufzeitbibliothek konfiguriert sind.

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)
}

Multiplattform-Einrichtung

Fügen Sie in einem Kotlin-Multiplattform-Projekt die Laufzeitbibliothek zu commonMain hinzu, damit alle Ziele sie gemeinsam verwenden.

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

Häufige Fehler bei der Einrichtung

Achten Sie auf diese häufigen Probleme:

Plugin vergessen — Sie erhalten Serializer has not been found
Plugin-Version stimmt nicht mit der Kotlin-Version überein
Laufzeitbibliothek, aber kein Plugin hinzugefügt (oder umgekehrt)
Import von encodeToString fehlt

Schnelltest

Warum benötigt kotlinx.serialization ein Gradle-Compiler-Plugin?

Zusammenfassung

Sie haben kotlinx.serialization folgendermaßen eingerichtet:

Das zur Kotlin-Version passende kotlin("plugin.serialization")-Plugin angewendet
Die Laufzeitabhängigkeit kotlinx-serialization-json hinzugefügt
Das Json-Objekt als Einstiegspunkt verwendet

Als Nächstes versehen Sie Modellklassen mit der Annotation @Serializable.

Häufig gestellte Fragen

Ist die Lektion „kotlinx.serialization einrichten“ kostenlos?

Ja — der vollständige Text von „kotlinx.serialization einrichten“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Kotlin Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Kotlin Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „kotlinx.serialization einrichten“?

Fügen Sie das Plugin hinzu Du übst Kotlin Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um Kotlin Academy zu starten?

Keine Vorkenntnisse erforderlich. Kotlin Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 1 von 4.

Wie lange dauert die Lektion „kotlinx.serialization einrichten“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser Kotlin Academy-Lektion Code schreiben und ausführen?

Ja. Jede Kotlin Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

← Zurück zu Kotlin Academy