Android(Java)保存Bitmap至本地并供Flutter应用读取的最优方案

核心思路 #

要让跨应用读取图片，不能用应用私有目录（其他应用无权限访问），需将Bitmap保存到公共媒体目录（如图片库），通过MediaStore API实现，既符合Android权限规范，又能保证Flutter应用可访问。

步骤1：保存Bitmap到MediaStore并获取绝对路径 #

以下是兼容Android全版本的Java实现代码：

import android.content.ContentResolver;
import android.content.ContentValues;
import android.graphics.Bitmap;
import android.net.Uri;
import android.os.Build;
import android.provider.MediaStore;
import java.io.OutputStream;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Locale;

public String saveBitmapToPublicStorage(Bitmap bitmap) {
    String displayName = new SimpleDateFormat("yyyyMMdd_HHmmss", Locale.getDefault()).format(new Date()) + ".png";
    String mimeType = "image/png";
    ContentValues values = new ContentValues();
    values.put(MediaStore.Images.Media.DISPLAY_NAME, displayName);
    values.put(MediaStore.Images.Media.MIME_TYPE, mimeType);
    
    // Android 10及以上，设置相对存储路径
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        values.put(MediaStore.Images.Media.RELATIVE_PATH, "Pictures/YourAppName");
        values.put(MediaStore.Images.Media.IS_PENDING, 1);
    } else {
        // 低版本需申请WRITE_EXTERNAL_STORAGE权限
        values.put(MediaStore.Images.Media.DATA, getExternalFilesDir(null) + "/Pictures/" + displayName);
    }

    ContentResolver resolver = getContentResolver();
    Uri uri = resolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
    String absolutePath = null;

    try (OutputStream outputStream = resolver.openOutputStream(uri)) {
        bitmap.compress(Bitmap.CompressFormat.PNG, 100, outputStream);
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            values.clear();
            values.put(MediaStore.Images.Media.IS_PENDING, 0);
            resolver.update(uri, values, null, null);
            // 查询获取绝对路径
            String[] projection = {MediaStore.Images.Media.DATA};
            try (var cursor = resolver.query(uri, projection, null, null, null)) {
                if (cursor != null && cursor.moveToFirst()) {
                    absolutePath = cursor.getString(cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA));
                }
            }
        } else {
            // 低版本直接取设置的DATA路径
            absolutePath = values.getAsString(MediaStore.Images.Media.DATA);
        }
    } catch (Exception e) {
        e.printStackTrace();
        // 保存失败时删除插入的空记录
        if (uri != null) {
            resolver.delete(uri, null, null);
        }
    }
    return absolutePath;
}

步骤2：权限处理 #

• Android 9及以下：需在AndroidManifest.xml中声明WRITE_EXTERNAL_STORAGE权限，并在运行时动态申请。
• Android 10及以上：无需申请WRITE_EXTERNAL_STORAGE权限，MediaStore API自动处理权限。

步骤3：Flutter应用读取路径 #

Flutter端可直接通过获取到的绝对路径，使用Image.file(File(path))或文件读取API加载图片，需确保Flutter应用已申请READ_EXTERNAL_STORAGE权限（Android 13及以上需申请READ_MEDIA_IMAGES）。

注意事项 #

• 避免使用私有目录：应用私有目录（如getFilesDir()）仅当前应用可访问，Flutter应用无法读取。
• 兼容性：使用MediaStore是Android官方推荐的跨应用媒体访问方式，适配所有版本的存储政策。
• 图片格式：示例中用PNG，可根据需求改为JPEG（调整CompressFormat.JPEG和对应MIME类型）。

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