0Pricing
Kotlin Multiplatform Academy · Lezione

File system e percorsi per piattaforma

Legga e scriva file in modo portabile tra i vari target.

File system e percorsi per piattaforma è una lezione Kotlin Multiplatform Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Kotlin Multiplatform Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Kotlin Multiplatform Academy include 4 lezioni in totale.

I file si trovano in posizioni diverse

Android e iOS memorizzano i file dell'app in cartelle completamente diverse. Il codice condiviso ha bisogno di un modo portabile per trovare un luogo sicuro in cui scrivere. 📁

Dichiarare un expect per i percorsi

Inserisca in commonMain una piccola funzione expect che restituisca la directory dei dati dell'app come semplice percorso String.

expect fun dataDir(): String

Android usa filesDir

L'actual Android restituisce context.filesDir.path, la cartella privata che il sistema garantisce per i file dell'app.

actual fun dataDir(): String =
  appContext.filesDir.path

iOS usa la directory Documents

L'actual iOS richiede a NSFileManager la directory Documents, la posizione standard in cui un'app conserva i dati dell'utente.

actual fun dataDir(): String =
  NSSearchPathForDirectoriesInDomains(
    NSDocumentDirectory, NSUserDomainMask, true
  ).first() as String

Costruire i percorsi, non codificarli

Unisca la directory al nome del file invece di scrivere un percorso letterale. Percorsi codificati come /sdcard smettono di funzionare non appena cambia piattaforma.

val file = dataDir() + "/profile.json"

Una piccola API di lettura/scrittura

Racchiuda anche la lettura e la scrittura dietro un'interface condivisa, così chi effettua le chiamate può salvare testo senza conoscere la piattaforma sottostante.

interface Storage {
  fun write(name: String, text: String)
  fun read(name: String): String?
}

Scrivere dal codice condiviso

La logica comune chiama storage.write senza sapere nulla di file o cartelle. L'actual della piattaforma gestisce i byte reali sul disco.

storage.write("profile.json", json)

Rileggere in sicurezza

Restituisca una String nullable durante la lettura, così i file mancanti non causano arresti anomali. Un null significa semplicemente che il file non esiste ancora.

val saved = storage.read("profile.json")

Tenere i percorsi fuori dal dominio

Le regole di business non dovrebbero mai vedere un percorso grezzo. Nasconda ogni dettaglio delle directory dietro la funzionalità, così il dominio resta pulito.

Prestare attenzione a permessi e sandbox

Entrambe le piattaforme isolano lo spazio di archiviazione dell'app in una sandbox. Si attenga alle directory fornite dal sistema ed eviterà completamente gli errori di autorizzazione.

Usare okio per la gestione reale dei file

Per letture e scritture importanti, una libreria multipiattaforma come okio offre un'unica API FileSystem per tutti i target, evitando le chiamate dirette alla piattaforma.

Controllo rapido

Rifletta sulla provenienza di un percorso di directory portabile.

Riepilogo

Ha esposto un dataDir portabile tramite expect/actual, ha costruito i percorsi invece di codificarli e ha nascosto la gestione dei file dietro una piccola funzionalità di archiviazione. 🎉

Domande Frequenti

La lezione «File system e percorsi per piattaforma» è gratuita?

Sì — il testo completo di «File system e percorsi per piattaforma» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Kotlin Multiplatform Academy, passa a CoddyKit PRO. Il corso Kotlin Multiplatform Academy include 4 lezioni in totale.

Cosa imparerò in «File system e percorsi per piattaforma»?

Legga e scriva file in modo portabile tra i vari target. Eserciti Kotlin Multiplatform Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Kotlin Multiplatform Academy?

Non è richiesta alcuna esperienza precedente. Kotlin Multiplatform Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.

Quanto tempo richiede la lezione «File system e percorsi per piattaforma»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Kotlin Multiplatform Academy?

Sì. Ogni lezione Kotlin Multiplatform Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Progettare un'interfaccia per una funzionalità
  2. expect/actual per le informazioni sul dispositivo
  3. File system e percorsi per piattaforma
  4. Iniettare le implementazioni della piattaforma
← Torna a Kotlin Multiplatform Academy