0Pricing
Kotlin Multiplatform Academy · Aula

Sistema de arquivos e caminhos por plataforma

Leia e grave arquivos de forma portável em diferentes destinos.

Sistema de arquivos e caminhos por plataforma é uma aula grátis de Kotlin Multiplatform Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Kotlin Multiplatform Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Kotlin Multiplatform Academy inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

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(): String

Android 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.path

iOS 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 String

Build 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. 🎉

Perguntas Frequentes

A aula “Sistema de arquivos e caminhos por plataforma” é grátis?

Sim — o texto completo de “Sistema de arquivos e caminhos por plataforma” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Kotlin Multiplatform Academy, atualize para CoddyKit PRO. O curso de Kotlin Multiplatform Academy inclui 4 aulas no total.

O que vou aprender em “Sistema de arquivos e caminhos por plataforma”?

Leia e grave arquivos de forma portável em diferentes destinos. Você pratica Kotlin Multiplatform Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Kotlin Multiplatform Academy?

Nenhuma experiência prévia é necessária. Kotlin Multiplatform Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.

Quanto tempo leva a aula “Sistema de arquivos e caminhos por plataforma”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Kotlin Multiplatform Academy?

Sim. Cada aula de Kotlin Multiplatform Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Projete uma interface de capacidades
  2. expect/actual para informações do dispositivo
  3. Sistema de arquivos e caminhos por plataforma
  4. Injete implementações da plataforma
← Voltar para Kotlin Multiplatform Academy