Kotlin Academy · Lezione

Configurazione di kotlinx.serialization

Aggiunga il plugin

Configurazione di kotlinx.serialization è una lezione Kotlin Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Kotlin Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Kotlin Academy include 4 lezioni in totale.

Che cos'è kotlinx.serialization?

kotlinx.serialization è la libreria ufficiale di Kotlin per convertire oggetti da e verso formati come JSON.

Kotlin puro, pronta per il multipiattaforma
Generazione del codice in fase di compilazione (senza reflection)
Gestita da JetBrains

Funziona con un plugin del compilatore e una libreria di runtime.

Perché un plugin del compilatore?

A differenza delle librerie basate sulla reflection, kotlinx.serialization genera i serializzatori in fase di compilazione.

È più veloce e non ha il costo della reflection a runtime
Funziona su Kotlin/Native e JS, dove la reflection è limitata
È type-safe e verificato dal compilatore

Per questo deve applicare il plugin kotlin-serialization, non limitarsi ad aggiungere una dipendenza.

Applicare il plugin (Kotlin DSL)

In build.gradle.kts applichi il plugin di serializzazione usando la stessa versione del plugin Kotlin.

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

Aggiungere la dipendenza di runtime

Il plugin genera il codice, ma è necessaria anche la libreria di runtime JSON.

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

L'allineamento delle versioni è importante

La versione di plugin.serialization deve corrispondere alla versione del compilatore Kotlin. La libreria di runtime ha una propria versione indipendente.

Versione del plugin = versione di Kotlin (ad es. 2.0.0)
La versione del runtime è separata (ad es. 1.7.1)

Versioni non corrispondenti del plugin e di Kotlin causano errori di compilazione difficili da interpretare.

Altri formati

JSON è il formato più comune, ma kotlinx.serialization supporta altri formati tramite artefatti aggiuntivi:

kotlinx-serialization-json — JSON
kotlinx-serialization-cbor — formato binario CBOR
kotlinx-serialization-protobuf — Protocol Buffers

Deve aggiungere solo gli artefatti dei formati di cui ha bisogno.

Equivalente con Groovy DSL

Se il progetto usa Groovy con build.gradle invece del Kotlin DSL, la configurazione è la seguente.

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

Il punto di accesso Json

Una volta completata la configurazione, utilizzi l'oggetto Json di kotlinx.serialization.json come punto di accesso principale per la codifica e la decodifica.

import kotlinx.serialization.json.Json

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

Un esempio minimo funzionante

Ecco il più piccolo esempio completo, dall'inizio alla fine, dopo aver configurato il plugin e il runtime.

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

Configurazione multipiattaforma

In un progetto Kotlin Multiplatform aggiunga il runtime a commonMain, così tutte le piattaforme possono condividerlo.

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

Errori comuni di configurazione

Presti attenzione a questi problemi frequenti:

Dimenticare il plugin: si ottiene Serializer has not been found
La versione del plugin non corrisponde alla versione di Kotlin
Aggiungere il runtime ma non il plugin (o viceversa)
Dimenticare l'import di encodeToString

Verifica rapida

Perché kotlinx.serialization richiede un plugin del compilatore Gradle?

Riepilogo

Ha configurato kotlinx.serialization:

Applicando il plugin kotlin("plugin.serialization") con la versione corrispondente di Kotlin
Aggiungendo la dipendenza di runtime kotlinx-serialization-json
Utilizzando l'oggetto Json come punto di accesso

Ora annoterà le classi del modello con @Serializable.

Domande Frequenti

La lezione «Configurazione di kotlinx.serialization» è gratuita?

Sì — il testo completo di «Configurazione di kotlinx.serialization» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Kotlin Academy, passa a CoddyKit PRO. Il corso Kotlin Academy include 4 lezioni in totale.

Cosa imparerò in «Configurazione di kotlinx.serialization»?

Aggiunga il plugin Eserciti Kotlin Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Kotlin Academy?

Non è richiesta alcuna esperienza precedente. Kotlin Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.

Quanto tempo richiede la lezione «Configurazione di kotlinx.serialization»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Kotlin Academy?

Sì. Ogni lezione Kotlin Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Kotlin Academy