Kotlin Academy · Leçon

Configuration de kotlinx.serialization

Ajouter le plug-in

Leçon 1 sur 413 étapes

Configuration de kotlinx.serialization est une leçon Kotlin Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Kotlin Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Kotlin Academy comprend 4 leçons au total.

Qu'est-ce que kotlinx.serialization ?

kotlinx.serialization est la bibliothèque officielle de Kotlin qui convertit les objets depuis et vers des formats comme JSON.

Entièrement en Kotlin et prête pour le multiplateforme
Génération de code à la compilation, sans réflexion
Maintenue par JetBrains

Elle fonctionne avec un greffon du compilateur et une bibliothèque d'exécution.

Pourquoi un greffon du compilateur ?

Contrairement aux bibliothèques fondées sur la réflexion, kotlinx.serialization génère les sérialiseurs à la compilation.

Plus rapide, sans coût de réflexion à l'exécution
Fonctionne avec Kotlin/Native et JS, où la réflexion est limitée
Sûre du point de vue des types et vérifiée par le compilateur

C'est pourquoi vous devez appliquer le greffon kotlin-serialization, et pas seulement ajouter une dépendance.

Appliquer le greffon (DSL Kotlin)

Dans build.gradle.kts, appliquez le greffon de sérialisation avec la même version que votre greffon Kotlin.

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

Ajouter la dépendance d'exécution

Le greffon génère le code, mais vous avez également besoin de la bibliothèque d'exécution JSON.

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

L'alignement des versions est important

La version de plugin.serialization doit correspondre à celle de votre compilateur Kotlin. La bibliothèque d'exécution possède sa propre version indépendante.

Version du greffon = version de Kotlin (par exemple 2.0.0)
La version d'exécution est distincte (par exemple 1.7.1)

Des versions incompatibles du greffon et de Kotlin provoquent des erreurs de compilation difficiles à interpréter.

Autres formats

JSON est le format le plus courant, mais kotlinx.serialization en prend en charge d'autres grâce à des artefacts supplémentaires :

kotlinx-serialization-json — JSON
kotlinx-serialization-cbor — format binaire CBOR
kotlinx-serialization-protobuf — Protocol Buffers

Ajoutez uniquement les artefacts correspondant aux formats dont vous avez besoin.

Équivalent avec le DSL Groovy

Si votre projet utilise Groovy et build.gradle au lieu du DSL Kotlin, la configuration se présente ainsi.

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

Le point d'entrée Json

Une fois la configuration terminée, utilisez l'objet Json de kotlinx.serialization.json comme point d'entrée principal pour l'encodage et le décodage.

import kotlinx.serialization.json.Json

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

Un extrait minimal fonctionnel

Voici le plus petit exemple de bout en bout une fois le greffon et la bibliothèque d'exécution configurés.

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

Configuration multiplateforme

Dans un projet Kotlin Multiplatform, ajoutez la bibliothèque d'exécution à commonMain afin que toutes les cibles la partagent.

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

Erreurs de configuration courantes

Surveillez les problèmes fréquents suivants :

Oubli du greffon — vous obtenez Serializer has not been found
Version du greffon différente de la version de Kotlin
Ajout de la bibliothèque d'exécution sans le greffon, ou inversement
Import manquant de encodeToString

Vérification rapide

Pourquoi kotlinx.serialization nécessite-t-il un greffon de compilation Gradle ?

Réponds-y dans la leçon interactive

Récapitulatif

Vous avez configuré kotlinx.serialization en :

Appliquant le greffon kotlin("plugin.serialization") correspondant à votre version de Kotlin
Ajoutant la dépendance d'exécution kotlinx-serialization-json
Utilisant l'objet Json comme point d'entrée

Vous allez maintenant annoter les classes de modèle avec @Serializable.

Gratuit pour commencer

Apprends Kotlin avec un tuteur IA — gratuit

Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.

Cours: 51
Leçons: 203

Commencer gratuitement Voir le cours complet

Questions Fréquemment Posées

La leçon « Configuration de kotlinx.serialization » est-elle gratuite ?

Oui — le texte complet de « Configuration de kotlinx.serialization » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Kotlin Academy, passe à CoddyKit PRO. Le cours Kotlin Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Configuration de kotlinx.serialization » ?

Ajouter le plug-in Tu pratiques Kotlin Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Kotlin Academy ?

Aucune expérience préalable n'est requise. Kotlin Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « Configuration de kotlinx.serialization » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Kotlin Academy ?

Oui. Chaque leçon Kotlin Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Kotlin Academy