Ajouter SQLDelight et écrire des schémas .sq
Définissez des tables et générez des API Kotlin sûres du point de vue des types.
Ajouter SQLDelight et écrire des schémas .sq est une leçon Kotlin Multiplatform Academy gratuite sur CoddyKit. Ceci est la leçon 1 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.
Découvrez SQLDelight
SQLDelight transforme votre SQL en Kotlin sûr du point de vue des types, que vous pouvez appeler depuis le code partagé. Vous écrivez du vrai SQL, il génère le code répétitif. 🗄️
Pourquoi convient-il à KMP ?
Comme il génère du Kotlin standard à partir du SQL, le même code de base de données fonctionne sur Android et iOS. Les requêtes sont partagées, tandis que le moteur est natif sur chaque plateforme.
Ajoutez le module d'extension Gradle
Activez SQLDelight en ajoutant son module d'extension Gradle à votre module partagé, afin qu'il puisse analyser et traiter les fichiers de schéma.
plugins {
id("app.cash.sqldelight") version "2.0.2"
}Ajoutez l'environnement d'exécution
Le module d'extension génère le code, mais vous devez également ajouter la dépendance d'environnement d'exécution dans commonMain pour que les requêtes générées s'exécutent réellement.
commonMain.dependencies {
implementation("app.cash.sqldelight:runtime:2.0.2")
}Déclarez une base de données
Vous indiquez à SQLDelight le nom de la base de données et son emplacement. Ce bloc de bases de données nomme la classe générée que vous utiliserez plus tard.
sqldelight {
databases {
create("AppDatabase") {
packageName.set("com.example.db")
}
}
}Qu'est-ce qu'un fichier .sq ?
Votre schéma se trouve dans des fichiers .sq : du texte brut contenant des instructions SQL ainsi que des requêtes nommées. SQLDelight les lit et génère du Kotlin.
Où placer les fichiers .sq
Placez les fichiers .sq sous commonMain/sqldelight, dans le paquet que vous avez déclaré. Le module d'extension ne cherche votre schéma qu'à cet emplacement.
commonMain/sqldelight/com/example/db/Player.sqDéfinir une table
Dans un fichier .sq, vous écrivez une instruction CREATE TABLE normale. SQLDelight l'utilise pour vérifier le typage de chacune de vos requêtes.
CREATE TABLE player (
id INTEGER NOT NULL PRIMARY KEY,
name TEXT NOT NULL
);Nommez vos requêtes
Chaque requête commence par un label qui se termine par deux-points. SQLDelight transforme ce label en fonction Kotlin que vous pouvez appeler.
selectAll:
SELECT * FROM player;Les paramètres deviennent des arguments
Un espace réservé ? en SQL devient un paramètre typé de fonction Kotlin, afin que le compilateur vérifie vos entrées à votre place.
selectById:
SELECT * FROM player WHERE id = ?;Sécurité de typage générée
SQLDelight associe vos colonnes à des types Kotlin. Une colonne ou un type incorrect est détecté à la compilation, et non à l'exécution en production.
Vérification rapide
Où doivent se trouver les fichiers de schéma SQLDelight dans un projet KMP ?
Récapitulatif : le schéma d'abord
Vous avez ajouté le plug-in et l'environnement d'exécution, déclaré une base de données et écrit un schéma .sq avec des requêtes nommées. Ensuite, vous fournissez un pilote à chaque plate-forme. ✅
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
- 30
- Leçons
- 120
Questions Fréquemment Posées
La leçon « Ajouter SQLDelight et écrire des schémas .sq » est-elle gratuite ?
Oui — le texte complet de « Ajouter SQLDelight et écrire des schémas .sq » 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 « Ajouter SQLDelight et écrire des schémas .sq » ?
Définissez des tables et générez des API Kotlin sûres du point de vue des types. 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 1 sur 4.
Combien de temps prend la leçon « Ajouter SQLDelight et écrire des schémas .sq » ?
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