如何保存Android Bitmap并实现永久访问？

你的问题核心是临时URI权限过期，导致后续跨模块访问时被系统拒绝。以下是几种可靠的实现永久访问的方法，可根据需求选择：

方法1：保存到应用私有目录（最省心，无权限问题） #

将Bitmap直接保存到应用私有存储目录，无需额外权限，仅自身应用可访问，卸载应用时会自动删除，不会残留垃圾文件。

代码示例（内部私有目录）： #

fun saveBitmapToInternalStorage(context: Context, bitmap: Bitmap, fileName: String): String {
    context.openFileOutput(fileName, Context.MODE_PRIVATE).use { fos ->
        bitmap.compress(Bitmap.CompressFormat.PNG, 100, fos)
    }
    return context.filesDir.absolutePath + "/" + fileName
}

// 读取时直接从路径加载
fun loadBitmapFromInternalStorage(context: Context, fileName: String): Bitmap? {
    return try {
        val filePath = context.filesDir.absolutePath + "/" + fileName
        BitmapFactory.decodeFile(filePath)
    } catch (e: Exception) {
        e.printStackTrace()
        null
    }
}

外部私有目录（Android 10+无需权限）： #

若需节省内部存储，可使用外部私有目录：

fun saveBitmapToExternalPrivateDir(context: Context, bitmap: Bitmap, fileName: String): String? {
    val dir = context.getExternalFilesDir(Environment.DIRECTORY_PICTURES) ?: return null
    if (!dir.exists()) dir.mkdirs()
    val file = File(dir, fileName)
    file.outputStream().use { fos ->
        bitmap.compress(Bitmap.CompressFormat.JPEG, 90, fos)
    }
    return file.absolutePath
}

方法2：插入到MediaStore公共媒体库（适合跨应用访问场景） #

如果希望图片能被相册等其他应用识别，或卸载应用后图片仍保留，可将Bitmap插入MediaStore，获取的URI永久有效（只要图片未被删除）。

代码示例： #

fun insertBitmapToMediaStore(context: Context, bitmap: Bitmap, displayName: String): Uri? {
    val contentValues = ContentValues().apply {
        put(MediaStore.Images.Media.DISPLAY_NAME, displayName)
        put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg")
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES + "/YourAppName")
            put(MediaStore.Images.Media.IS_PENDING, 1)
        }
    }

    val contentUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI
    var uri: Uri? = null
    try {
        uri = context.contentResolver.insert(contentUri, contentValues)
        uri?.let {
            context.contentResolver.openOutputStream(it)?.use { os ->
                bitmap.compress(Bitmap.CompressFormat.JPEG, 90, os)
            }
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
                contentValues.put(MediaStore.Images.Media.IS_PENDING, 0)
                context.contentResolver.update(it, contentValues, null, null)
            }
        }
    } catch (e: Exception) {
        uri?.let { context.contentResolver.delete(it, null, null) }
        e.printStackTrace()
    }
    return uri
}

插入后得到的uri可直接保存，后续随时通过ContentResolver访问（Android 13+需申请READ_MEDIA_IMAGES权限）。

方法3：使用SAF获取永久访问权限（用户自定义保存位置） #

若需让用户选择图片保存路径，可通过**存储访问框架（SAF）**的ACTION_CREATE_DOCUMENT发起请求，再获取持久化权限：

步骤1：发起创建文档请求 #

fun createDocumentForBitmap(context: Context, requestCode: Int) {
    val intent = Intent(Intent.ACTION_CREATE_DOCUMENT).apply {
        addCategory(Intent.CATEGORY_OPENABLE)
        type = "image/jpeg"
        putExtra(Intent.EXTRA_TITLE, "MyCreatedImage.jpg")
    }
    (context as Activity).startActivityForResult(intent, requestCode)
}

步骤2：处理返回结果并获取永久权限 #

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (resultCode == Activity.RESULT_OK && data != null) {
        val uri = data.data ?: return
        // 获取永久访问权限
        context.contentResolver.takePersistableUriPermission(
            uri,
            Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION
        )
        // 将Bitmap写入该URI
        context.contentResolver.openOutputStream(uri)?.use { os ->
            yourBitmap.compress(Bitmap.CompressFormat.JPEG, 90, os)
        }
        // 保存uri到本地（比如SharedPreferences）
        saveUriToPreferences(context, uri.toString())
    }
}

保存该URI后，可随时通过ContentResolver访问，权限永久有效（除非用户手动在系统设置中撤销）。

失败原因说明 #

你之前保存的content:// URI属于临时权限，系统仅在当前任务栈中授权，一旦应用退至后台或跨模块访问，权限即失效。上述三种方法可彻底规避该问题：私有目录直接用文件路径访问，MediaStore的URI由系统永久授权，SAF通过takePersistableUriPermission获取了持久权限。

内容的提问来源于stack exchange，提问作者alfietap