Configurer SqlDriver selon la plateforme
Fournissez les pilotes Android et iOS avec expect/actual.
Configurer SqlDriver selon la plateforme est une leçon Kotlin Multiplatform Academy gratuite sur CoddyKit. Ceci est la leçon 2 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 Multiplatform Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Kotlin Multiplatform Academy comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
What a Driver Does
SQLDelight generates queries, but it needs a SqlDriver to actually talk to SQLite. Each platform ships its own driver.
Why Drivers Differ
Android and iOS open SQLite differently, so there is no single shared driver. This is exactly the job for expect/actual.
Declare the expect Factory
In commonMain you declare an expect function that promises a SqlDriver, without saying how each platform builds it.
expect fun driverFactory(): SqlDriverAdd Platform Driver Deps
Each source set pulls in its own driver artifact: an Android driver in androidMain and a native driver in iosMain.
androidMain: "app.cash.sqldelight:android-driver:2.0.2"
iosMain: "app.cash.sqldelight:native-driver:2.0.2"Android actual Driver
On Android you build an AndroidSqliteDriver, passing the generated schema and a Context to open the file.
actual fun driverFactory(): SqlDriver =
AndroidSqliteDriver(AppDatabase.Schema, context, "app.db")Context on Android
The Android driver needs a Context. Pass the application context in so the database survives the whole app lifecycle.
iOS actual Driver
On iOS you build a NativeSqliteDriver from the same schema. No Context needed; it stores the file in the app sandbox.
actual fun driverFactory(): SqlDriver =
NativeSqliteDriver(AppDatabase.Schema, "app.db")The Schema Object
Both drivers take AppDatabase.Schema. SQLDelight generated it from your .sq file, and it creates the tables on first launch.
Build the Database
With a driver in hand you create the database instance. This AppDatabase is your typed entry point to every query.
val database = AppDatabase(driverFactory())Share One Instance
Creating many databases wastes file handles. Build the driver once and reuse a single AppDatabase across the app.
Inject the Driver
Pass the driver in from each platform rather than hardcoding it. This keeps shared code testable with a fake or in-memory driver.
Quick Check
How does SQLDelight get a platform-specific database driver into shared code?
Recap: Wire the Engine
You declared an expect driver factory, supplied AndroidSqliteDriver and NativeSqliteDriver, and built one AppDatabase. Now you can run queries. ✅
Questions Fréquemment Posées
La leçon « Configurer SqlDriver selon la plateforme » est-elle gratuite ?
Oui — le texte complet de « Configurer SqlDriver selon la plateforme » 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 Multiplatform Academy, passe à CoddyKit PRO. Le cours Kotlin Multiplatform Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Configurer SqlDriver selon la plateforme » ?
Fournissez les pilotes Android et iOS avec expect/actual. Tu pratiques Kotlin Multiplatform 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 Multiplatform Academy ?
Aucune expérience préalable n'est requise. Kotlin Multiplatform 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 2 sur 4.
Combien de temps prend la leçon « Configurer SqlDriver selon la plateforme » ?
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 Multiplatform Academy ?
Oui. Chaque leçon Kotlin Multiplatform 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
- Ajouter SQLDelight et écrire des schémas .sq
- Configurer SqlDriver selon la plateforme
- Insérer, interroger et mettre à jour des lignes
- Observer les tables comme un Flow