Scoped Storage — vad det är, filhantering och åtkomst till lagring

Vad är Scoped Storage i Android?

Scoped Storage — är en arkitektonisk förändring i Android 10 (API 29) som fundamentalt ändrar hur appar får åtkomst till enhetens filsystem. Istället för full åtkomst till den delade lagringen får appen endast åtkomst till sin egen sandlåda och till vissa samlingar av mediafiler via MediaStore.

Före Scoped Storage kunde alla appar med behörigheten READ_EXTERNAL_STORAGE läsa alla filer i den delade lagringen — foton, dokument, nedladdningar, data från andra appar. Detta skapade integritetsrisker: oärliga appar kunde samla in information om användaren utan dennes vetskap.

Enligt Google I/O 2019 anser mer än 65% av Android-användare att dataintegritet är en kritisk faktor vid val av app. Scoped Storage är ett direkt svar på denna efterfrågan: varje app arbetar i en isolerad miljö och får åtkomst till andras data endast med användarens uttryckliga samtycke.

Viktigt: Scoped Storage var valfritt i Android 10 (appen kunde inaktivera det via requestLegacyExternalStorage). Från och med Android 11 (API 30) blev Scoped Storage obligatoriskt för alla appar, oavsett target SDK.

Varför behövdes Scoped Storage

Google introducerade Scoped Storage för att lösa tre grundläggande problem med den gamla filåtkomstmodellen: integritet, behörighetshantering och rensning av kvarvarande filer.

Integritetsproblemet

I den gamla modellen kunde en app med READ_EXTERNAL_STORAGE skanna hela den delade lagringen och samla in metadata om användarens filer — geografiska koordinater för foton, dokumentnamn, katalogstruktur. Scoped Storage eliminerar denna möjlighet: även med behörigheten ser appen bara filer som den själv har skapat och filer som användaren uttryckligen har valt via SAF.

Rensningsproblemet vid borttagning av app

Före Scoped Storage kunde appen lämna kvar filer i den delade lagringen efter borttagning. Med tiden samlades skräp-kataloger på hög. Scoped Storage löser detta: alla filer i appens sandlåda raderas tillsammans med appen, och filer via MediaStore har en ägare och kan rensas av systemet.

Scoped Storage är en del av Googles övergripande strategi för att stärka integriteten i Android, som också inkluderar ”endast under användning”-behörigheter, indikatorer för kamera- och mikrofonåtkomst samt Privacy Dashboard.

Appens privata katalog

Varje app i Android får en egen privat katalog, tillgänglig via Context.getFilesDir() och context.getCacheDir(). För åtkomst till den externa (delade) privata katalogen används Context.getExternalFilesDir().

I Scoped Storage har appen full åtkomst till sin externa privata katalog utan några behörigheter. Detta är den primära platsen för att lagra filer som inte ska vara tillgängliga för andra appar eller som appen skapar för eget bruk.

import android.os.Environment
import java.io.File
import java.io.IOException

class FileManager {

    fun saveToAppStorage(context: Context, fileName: String, data: ByteArray) {
        val appDir = context.getExternalFilesDir(null)
            ?: return
        val file = File(appDir, fileName)
        file.writeBytes(data)
    }

    fun readFromAppStorage(context: Context, fileName: String): ByteArray? {
        val appDir = context.getExternalFilesDir(null)
            ?: return null
        val file = File(appDir, fileName)
        return file.takeIf { it.exists() }?.readBytes()
    }
}

Sökväg till den externa privata katalogen: /storage/emulated/0/Android/data/{packageName}/files/. Från och med Android 11 är direkt filsökväg inte tillgänglig — endast via API. Detta är ytterligare en förstärkning av Scoped Storages säkerhet.

MediaStore — åtkomst till mediafiler

MediaStore — är det primära API:t för åtkomst till delade mediafiler (bilder, video, ljud) i Scoped Storage. Appen arbetar inte med filsökvägar, utan med content URIs som tillhandahålls av MediaStore-leverantören.

MediaStore är uppdelat i tre huvudsamlingar: Images, Video och Audio. Varje samling stöder CRUD-operationer via ContentResolver. För att infoga en ny fil i Images-samlingen används MediaStore.Images.Media, för att fråga efter befintliga — query med motsvarande URI.

import android.content.ContentValues
import android.provider.MediaStore
import android.os.Environment
import java.io.OutputStream

fun saveImageToGallery(context: Context, bitmap: Bitmap, title: String) {
    val values = ContentValues().apply {
        put(MediaStore.Images.Media.DISPLAY_NAME, "$title.jpg")
        put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg")
        put(
            MediaStore.Images.Media.RELATIVE_PATH,
            "${Environment.DIRECTORY_PICTURES}/MyApp"
        )
    }

    val uri = context.contentResolver
        .insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values)
        ?: return

    context.contentResolver.openOutputStream(uri)?.use { output: OutputStream ->
        bitmap.compress(
            Bitmap.CompressFormat.JPEG,
            95,
            output
        )
    }
}

Viktigt: MediaStore stöder inte godtyckliga filsökvägar — endast content URIs. Ett försök att få filsökvägen från en URI via MediaStore.Files.getContentUri() ger inte en direkt sökväg till filen på Android 11+. Använd istället ContentResolver.openInputStream() och openOutputStream() för att arbeta med innehållet.

Storage Access Framework (SAF)

Storage Access Framework (SAF) — är API:t för åtkomst till godtyckliga filer och kataloger utanför appens sandlåda. SAF ger användaren ett gränssnitt för att välja en fil eller katalog, varefter appen får en content URI med temporär åtkomst.

SAF används för scenarier som inte täcks av MediaStore: arbete med godtyckliga dokument (PDF, ZIP, APK), åtkomst till kataloger på SD-kortet, import och export av filer från andra appar. Användaren väljer uttryckligen filen via systemets filväljare — detta garanterar dennes samtycke till åtkomst.

import android.app.Activity
import android.content.Intent
import android.net.Uri
import android.provider.DocumentsContract

const val REQUEST_CODE_PICK_DIR = 1001

fun pickDirectory(activity: Activity) {
    val intent = Intent(Intent.ACTION_OPEN_DOCUMENT_TREE)
    activity.startActivityForResult(intent, REQUEST_CODE_PICK_DIR)
}

fun handlePickResult(requestCode: Int, data: Intent?) {
    if (requestCode == REQUEST_CODE_PICK_DIR && data != null) {
        val treeUri: Uri = data.data ?: return

        // Få permanent URI-behörighet
        val flags = Intent.FLAG_GRANT_READ_URI_PERMISSION or
                       Intent.FLAG_GRANT_WRITE_URI_PERMISSION
        contentResolver.takePersistableUriPermission(treeUri, flags)
    }
}

SAF ger appen åtkomst till den av användaren valda katalogen tills enheten startas om (när takePersistableUriPermission används). Detta är det enda sättet att få åtkomst till godtyckliga filer i den delade lagringen på Android 11+.

Migrera appen till Scoped Storage

Migrering av en befintlig Android-app till Scoped Storage kräver ändringar inom flera viktiga områden. Google rekommenderar en stegvis metod med testning på Android 11+.

Ersätta filsökvägar med content URIs

Ersätt alla direkta File-operationer i den delade lagringen med ContentResolver.openInputStream / openOutputStream. För filer i appens sandlåda (getExternalFilesDir) fortsätter filsökvägar att fungera.

Uppdatera AndroidManifest

Ta bort READ_EXTERNAL_STORAGE och WRITE_EXTERNAL_STORAGE om de inte behövs för specifika scenarier (t.ex. filhantering — för det finns den särskilda behörigheten MANAGE_EXTERNAL_STORAGE).

Efter migreringen, testa appen på Android 11+ (API 30) med targetSdk = 30 eller högre i build.gradle. Se till att alla filoperationer i den delade lagringen fungerar via MediaStore eller SAF, inte via direkta filsökvägar.

import android.os.Build

fun isScopedStorage(): Boolean {
    return Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q
}

fun compatReadFile(context: Context, uri: Uri): ByteArray? {
    return if (isScopedStorage()) {
        context.contentResolver
            .openInputStream(uri)?.readBytes()
    } else {
        File(uri.path ?: return null)
            .takeIf { it.exists() }
            ?.readBytes()
    }
}

Enligt Google Play Console (2024) kör mer än 78% av aktiva Android-enheter Android 10+ med Scoped Storage. Migrering är ett obligatoriskt steg för att publicera uppdateringar i Google Play: nya appar måste rikta sig till API 31+, uppdateringar — API 30+.