Configura il tuo ambiente (Kotlin Multiplatform)

Kotlin Multiplatform (KMP) consente di condividere il codice Kotlin su piattaforme diverse. Prima di iniziare a creare app con KMP, devi configurare il tuo ambiente come descritto in questo documento. Puoi anche consultare la documentazione ufficiale di JetBrains.

Installa o aggiorna gli strumenti richiesti

  • Installa o esegui l'aggiornamento alla versione stabile più recente di Android Studio.
  • Aggiorna il plug-in Kotlin incluso in Android Studio alla versione più recente per evitare problemi di compatibilità.
  • (Facoltativo) Per lo sviluppo per iOS, installa Xcode per creare l'UI e aggiungi il codice Swift o Objective-C in base alle esigenze.

Creare un progetto Kotlin Multiplatform

Puoi utilizzare la procedura guidata Kotlin Multiplatform di JetBrains per creare un nuovo progetto KMP. Assicurati di scegliere l'opzione Non condividere UI per mantenere l'interfaccia utente nativa.

Struttura del progetto

I progetti KMP seguono una struttura simile a quella dei progetti Android.

Un progetto KMP contiene moduli specifici della piattaforma e un modulo condiviso. Aggiungi il codice specifico della piattaforma al modulo pertinente. Ad esempio, aggiungi l'interfaccia utente della tua app Android nel modulo androidApp e l'interfaccia utente della tua app iOS in iosApp. Qualsiasi codice che vuoi condividere tra le piattaforme va nel modulo shared.

Il modulo condiviso utilizza Gradle come sistema di compilazione, come il resto del progetto. Puoi dichiarare dipendenze comuni e specifiche della piattaforma utilizzando i sourceset. Ad esempio, se la tua app utilizza Ktor per la rete, devi aggiungere una dipendenza OkHttp per Android e una dipendenza Darwin per iOS. Tieni presente che alcune librerie richiedono solo dipendenze comuni e non richiedono dipendenze specifiche della piattaforma.

sourceSets {
   commonMain.dependencies {
       //put your multiplatform dependencies here
       //...
       implementation(libs.ktor.client.core)
       implementation(libs.ktor.client.content.negotiation)
       implementation(libs.ktor.serialization.kotlinx.json)
       //...
   }
   androidMain.dependencies {
       implementation(libs.ktor.client.okhttp)
   }
   iosMain.dependencies {
       implementation(libs.ktor.client.darwin)
   }
}

Quando aggiungi una nuova libreria al modulo condiviso della tua app, assicurati di verificare le dipendenze richieste per ogni piattaforma.