Kotlin Academy · Leçon

API des plateformes

Accéder aux fonctionnalités natives

Leçon 4 sur 413 étapes

API des plateformes est une leçon Kotlin Academy gratuite sur CoddyKit. Ceci est la leçon 4 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.

Accéder aux fonctionnalités natives

Le code partagé doit parfois accéder aux fonctionnalités de l’appareil — au stockage, aux paramètres, à l’horloge et au moteur réseau. KMM propose plusieurs façons d’atteindre proprement les API natives.

expect/actual pour les types primitifs

Pour les petites valeurs propres à une plateforme, utilisez expect/actual. Le code commun reste clair, tandis que chaque plateforme fournit les détails nécessaires.

// commonMain
expect fun currentTimeMillis(): Long

// androidMain
actual fun currentTimeMillis(): Long = System.currentTimeMillis()

Injection de code de plateforme

Une approche plus flexible consiste à définir une interface dans le code commun et à injecter une implémentation propre à chaque plateforme depuis chaque application.

// commonMain
interface Storage {
    fun save(key: String, value: String)
    fun load(key: String): String?
}

Implémentation Android

Android implémente l’interface avec SharedPreferences et la fournit au code partagé.

// androidMain
import android.content.SharedPreferences

class AndroidStorage(private val prefs: SharedPreferences) : Storage {
    override fun save(key: String, value: String) {
        prefs.edit().putString(key, value).apply()
    }
    override fun load(key: String): String? = prefs.getString(key, null)
}

Implémentation iOS

iOS implémente la même interface avec NSUserDefaults du cadre Foundation.

// iosMain
import platform.Foundation.NSUserDefaults

class IosStorage : Storage {
    private val defaults = NSUserDefaults.standardUserDefaults
    override fun save(key: String, value: String) = defaults.setObject(value, key)
    override fun load(key: String): String? = defaults.stringForKey(key)
}

Appeler les API natives d’iOS

Depuis iosMain, vous pouvez appeler directement les cadres d’Apple, car Kotlin/Native génère pour eux des liaisons d’interopérabilité.

import platform.UIKit.UIDevice

fun deviceModel(): String = UIDevice.currentDevice.model

Appeler les API Android

androidMain dispose de l’intégralité du SDK Android, puisqu’il est compilé pour la plateforme Android.

import android.os.Build

fun deviceModel(): String = Build.MODEL

Bibliothèques multiplateformes prêtes à l’emploi

Souvent, vous n’avez pas besoin d’une interopérabilité personnalisée. Des bibliothèques encapsulent déjà les fonctionnalités courantes :

multiplatform-settings — stockage clé-valeur
Ktor — réseau
SQLDelight — base de données locale

Fournir des implémentations

Injectez les implémentations des plateformes au démarrage de l’application, généralement au moyen d’un cadre de DI comme Koin, afin que le code partagé reçoive la bonne implémentation.

// Android: provide AndroidStorage(prefs)
// iOS: provide IosStorage()
// Shared Repository(storage) uses whichever was injected

Choisir une approche

Lignes directrices :

Petite valeur → expect/actual
Comportement avec plusieurs méthodes → interface + injection
Besoin courant → utilisez une bibliothèque multiplateforme existante

Démonstration exécutable d’une abstraction

L’idée d’interface s’exprime en Kotlin simple. Ici, une implémentation en mémoire remplace un stockage de plateforme.

interface Storage {
    fun save(key: String, value: String)
    fun load(key: String): String?
}

class MemoryStorage : Storage {
    private val map = mutableMapOf<String, String>()
    override fun save(key: String, value: String) { map[key] = value }
    override fun load(key: String): String? = map[key]
}

fun main() {
    val s: Storage = MemoryStorage()
    s.save("name", "Ada")
    println(s.load("name"))
}

Vérification rapide

Vous avez besoin d’une fonctionnalité de stockage comportant plusieurs méthodes, implémentée différemment sur chaque plateforme et facile à tester. Quelle approche est recommandée ?

Réponds-y dans la leçon interactive

Récapitulatif

Vous pouvez accéder proprement aux fonctionnalités natives :

expect/actual pour les types primitifs
Interface commune + implémentation de plateforme injectée pour le comportement
Interopérabilité directe dans androidMain/iosMain
Réutilisation des bibliothèques multiplateformes lorsque c’est possible

Le cours KMM Basics est maintenant terminé.

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 « API des plateformes » est-elle gratuite ?

Oui — le texte complet de « API des plateformes » 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 « API des plateformes » ?

Accéder aux fonctionnalités natives 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 4 sur 4.

Combien de temps prend la leçon « API des plateformes » ?

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