Kotlin Academy · Lezione

expect e actual

Implementazioni specifiche della piattaforma

Lezione 2 di 413 passaggi

expect e actual è una lezione Kotlin Academy gratuita su CoddyKit. Questa è la lezione 2 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.

La necessità del codice specifico per la piattaforma

Alcune funzionalità non hanno un'implementazione comune, ad esempio ottenere il nome del sistema operativo, un UUID o la piattaforma corrente. KMM risolve il problema tramite il meccanismo expect/actual.

Dichiarazioni expect

In commonMain dichiara una funzione o una classe expect: un contratto privo di corpo. Il codice comune può richiamarla.

// commonMain
expect fun platformName(): String

actual su Android

Ogni piattaforma fornisce un'implementazione actual che corrisponde alla firma.

// androidMain
actual fun platformName(): String = "Android " + android.os.Build.VERSION.SDK_INT

actual su iOS

Il source set iOS fornisce la propria versione utilizzando le API native.

// iosMain
import platform.UIKit.UIDevice

actual fun platformName(): String =
    UIDevice.currentDevice.systemName + " " + UIDevice.currentDevice.systemVersion

Utilizzo nel codice comune

Il codice comune richiama la funzione attesa come se esistesse; il compilatore collega l'implementazione actual corretta per ogni target.

// commonMain
class Platform {
    val name: String get() = platformName()
}

Classi expect

Può dichiarare come expect un'intera classe. Ogni piattaforma fornisce una classe actual con membri corrispondenti.

// commonMain
expect class FileReader(path: String) {
    fun read(): String
}

Implementazioni di classi actual

Le piattaforme implementano la classe attesa utilizzando le API native per i file, ad esempio Java IO su Android e Foundation su iOS.

// androidMain
actual class FileReader actual constructor(private val path: String) {
    actual fun read(): String = java.io.File(path).readText()
}

expect con typealias

Un'implementazione actual può essere un typealias a un tipo della piattaforma già esistente, evitando così un wrapper.

// commonMain
expect class Uuid

// jvm/androidMain
actual typealias Uuid = java.util.UUID

Regole di corrispondenza delle firme

L'implementazione actual deve corrispondere esattamente alla dichiarazione expect: stesso nome, stessi parametri e stesso tipo restituito. Una differenza causa un errore di compilazione e garantisce la coerenza tra le piattaforme.

Quando non usare expect/actual

Preferisca semplici interfacce con implementazioni della piattaforma iniettate a runtime quando l'astrazione deve essere più flessibile. Riservi expect/actual a primitive di piattaforma piccole e fisse.

Un esempio nel codice comune

Al di fuori di KMM, la stessa idea consiste semplicemente nel richiamare un'astrazione. Qui una normale funzione funge da sostituto della chiamata alla piattaforma.

fun platformName(): String = "Demo Platform"

fun main() {
    println("Running on " + platformName())
}

Verifica rapida

Dove viene scritta una dichiarazione expect e dove vengono inserite le relative implementazioni actual?

Rispondi nella lezione interattiva

Riepilogo

expect/actual colma le differenze tra le piattaforme:

expect dichiara il contratto in commonMain
actual lo implementa per ogni piattaforma (oppure tramite typealias)
Le firme devono corrispondere esattamente
Preferisca le interfacce per le astrazioni flessibili

Successivamente: condividere la logica di business.

Gratis per iniziare

Impara Kotlin con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi: 51
Lezioni: 203

Inizia a imparare gratis Visualizza il corso completo

Domande Frequenti

La lezione «expect e actual» è gratuita?

Sì — il testo completo di «expect e actual» è 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 «expect e actual»?

Implementazioni specifiche della piattaforma 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 2 di 4.

Quanto tempo richiede la lezione «expect e actual»?

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