Android 12下Bitmap保存至JPG文件失败问题求助

我在Android 12系统中开发应用，能通过自定义函数获取Bitmap，但保存后无法在已成功创建的DCIM/Clip文件夹中找到文件。以下是我的初始保存函数：

private val saveImageToFolder = View.OnClickListener {
        try {
            var fileName:String = "img" + imageName.text.toString() + ".jpg"
            var values:ContentValues = ContentValues()
            var path = "DCIM/Clip"

            val filePath = File(path)
            if(!filePath.exists()){
                filePath.mkdir()
            }

            values.put(MediaStore.Images.Media.DISPLAY_NAME,fileName)
            values.put(MediaStore.Images.Media.MIME_TYPE,"image/jpg")
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
                values.put(MediaStore.MediaColumns.RELATIVE_PATH,path)
                values.put(MediaStore.MediaColumns.IS_PENDING, 1)
            } else {
                values.put(MediaStore.MediaColumns.DATA, path)
            }

            val uri = contentResolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values)

            contentResolver.openOutputStream(uri!!).use { output ->
                val bm: Bitmap = mixBitmap(paintViewList)
                bm.compress(Bitmap.CompressFormat.JPEG, 100, output)
            }
        }
        catch (e:java.lang.Exception){
            Log.d("onBtnSavePng", e.toString());
        }
    }

更新尝试 #

我在压缩图片后将IS_PENDING设为0，但仍然无法成功保存，修改后的代码片段如下：

contentResolver.openOutputStream(uri!!).use { output ->
    var bm: Bitmap = mixBitmap(paintViewList)
    bm.compress(Bitmap.CompressFormat.PNG, 100, output)
    values.clear()
    values.put(MediaStore.MediaColumns.IS_PENDING, 0)
    contentResolver.update(uri,values,null,null)
}

问题解决方法 #

1. 修正Android Q+的路径处理逻辑 #

Android 10及以上版本，MediaStore会通过RELATIVE_PATH自动创建目录，不需要手动调用filePath.mkdir()——手动创建的目录可能无法被媒体库索引，导致文件看不到。直接删除手动创建文件夹的代码即可。

2. 调整IS_PENDING的更新时机 #

你之前把更新IS_PENDING=0的操作放在了use代码块内部，此时输出流还没完全关闭，更新操作不会生效。需要把这部分代码移到use块外部，确保流已经关闭后再执行更新。

3. 统一文件名后缀与压缩格式 #

代码里文件名用.jpg但压缩格式改成了PNG，要保持后缀和格式一致，避免媒体库识别错误。

4. 添加媒体库扫描通知 #

保存完成后调用MediaScannerConnection通知系统扫描文件，确保文件能立即被文件管理器和相册识别。

修正后的完整代码 #

private val saveImageToFolder = View.OnClickListener {
    try {
        // 统一文件名后缀和压缩格式
        val fileName = "img${imageName.text.toString()}.png"
        val values = ContentValues()
        val relativePath = "DCIM/Clip"

        values.put(MediaStore.Images.Media.DISPLAY_NAME, fileName)
        values.put(MediaStore.Images.Media.MIME_TYPE, "image/png")

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            values.put(MediaStore.MediaColumns.RELATIVE_PATH, relativePath)
            values.put(MediaStore.MediaColumns.IS_PENDING, 1)
        } else {
            // 兼容Android Q以下版本（Android 12无需走此分支）
            val dcimDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM)
            val clipDir = File(dcimDir, "Clip")
            if (!clipDir.exists()) {
                clipDir.mkdirs() // 用mkdirs创建多级目录
            }
            val targetFile = File(clipDir, fileName)
            values.put(MediaStore.MediaColumns.DATA, targetFile.absolutePath)
        }

        val uri = contentResolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values)
        uri ?: return@OnClickListener // 避免uri为空导致崩溃

        // 写入Bitmap到输出流
        contentResolver.openOutputStream(uri).use { output ->
            val bm = mixBitmap(paintViewList)
            bm.compress(Bitmap.CompressFormat.PNG, 100, output)
        }

        // 流关闭后再更新IS_PENDING为0
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            val updateValues = ContentValues()
            updateValues.put(MediaStore.MediaColumns.IS_PENDING, 0)
            contentResolver.update(uri, updateValues, null, null)
        }

        // 通知媒体库扫描文件，确保立即可见
        MediaScannerConnection.scanFile(
            context,
            arrayOf(uri.path),
            arrayOf("image/png"),
            null
        )

    } catch (e: Exception) {
        Log.d("onBtnSavePng", e.toString())
    }
}

额外检查项 #

• 确认mixBitmap函数返回的Bitmap不为空且有效
• 检查应用是否已获取必要权限：Android 12及以下如果targetSdkVersion<30，需要WRITE_EXTERNAL_STORAGE权限；Android 13+需要READ_MEDIA_IMAGES权限
• 如果文件管理器还是看不到，可以通过ADB命令进入/sdcard/DCIM/Clip目录查看文件是否实际存在，排除文件管理器缓存问题

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