Système de fichiers et chemins par plateforme
Lisez et écrivez des fichiers de manière portable sur toutes les cibles.
Système de fichiers et chemins par plateforme est une leçon Kotlin Multiplatform Academy gratuite sur CoddyKit. Ceci est la leçon 3 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.
Files Live in Different Places
Android and iOS store app files in totally different folders. Shared code needs a portable way to find a safe place to write. 📁
Declare a Paths expect
Put a small expect function in commonMain that returns the app's data directory as a plain String path.
expect fun dataDir(): StringAndroid Uses filesDir
The Android actual returns context.filesDir.path, the private folder the system guarantees for your app's files.
actual fun dataDir(): String =
appContext.filesDir.pathiOS Uses the Documents Dir
The iOS actual asks NSFileManager for the Documents directory, the standard place an app keeps user data.
actual fun dataDir(): String =
NSSearchPathForDirectoriesInDomains(
NSDocumentDirectory, NSUserDomainMask, true
).first() as StringBuild Paths, Do Not Hardcode
Join the directory with a file name instead of writing a literal path. Hardcoded paths like /sdcard break the moment you switch platform.
val file = dataDir() + "/profile.json"A Tiny Read/Write API
Wrap reading and writing behind a shared interface too, so callers save text without knowing the platform underneath.
interface Storage {
fun write(name: String, text: String)
fun read(name: String): String?
}Write From Shared Code
Common logic calls storage.write knowing nothing about files or folders. The platform actual handles the real bytes on disk.
storage.write("profile.json", json)Read It Back Safely
Return a nullable String on read so missing files do not crash. A null simply means the file is not there yet.
val saved = storage.read("profile.json")Keep Paths Out of the Domain
Your business rules should never see a raw path. Hide every directory detail behind the capability so the domain stays clean.
Mind Permissions and Sandboxes
Both platforms sandbox app storage. Stick to the directories the system gives you and you avoid permission errors entirely.
Use okio for Real File Work
For serious reads and writes, a multiplatform library like okio gives one FileSystem API across targets, so you skip raw platform calls.
Quick Check
Think about where a portable directory path comes from.
Recap
You exposed a portable dataDir via expect/actual, built paths instead of hardcoding them, and hid file work behind a small storage capability. 🎉
Questions Fréquemment Posées
La leçon « Système de fichiers et chemins par plateforme » est-elle gratuite ?
Oui — le texte complet de « Système de fichiers et chemins par 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 « Système de fichiers et chemins par plateforme » ?
Lisez et écrivez des fichiers de manière portable sur toutes les cibles. 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 3 sur 4.
Combien de temps prend la leçon « Système de fichiers et chemins par 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
- Concevoir une interface de capacités
- expect/actual pour les informations de l’appareil
- Système de fichiers et chemins par plateforme
- Injecter les implémentations de plateforme