Android 保存背景移除图片方法

本文深入解析了在 Android 中如何安全、可靠地保存 CutOut 等图像处理库返回的背景移除图片，直击开发者常踩的坑：不能直接解析 content:// URI 为文件路径，也不能滥用已弃用的 file:// 方式。文章手把手教你通过 ContentResolver 加载 Bitmap、利用 MediaStore 在分区存储（Scoped Storage）下合规插入图片并获取可写 Uri、高效压缩写入，同时覆盖权限适配（Android 10+ 无需 WRITE_EXTERNAL_STORAGE）、内存优化（防 OOM）、异常防护等关键细节——一套兼具兼容性、健壮性与用户体验的生产级实现方案，让你告别保存失败、图库不显示、应用崩溃等烦人问题。

本文详解如何在使用 CutOut 等图像处理库后，将返回的 Uri 对应的图片安全、可靠地保存至设备存储，涵盖 Bitmap 加载、输出流写入、权限适配及最佳实践。

本文详解如何在使用 CutOut 等图像处理库后，将返回的 `Uri` 对应的图片安全、可靠地保存至设备存储，涵盖 Bitmap 加载、输出流写入、权限适配及最佳实践。

在 Android 开发中，调用第三方图像处理库（如 CutOut）完成背景移除后，通常会通过 Intent 返回一个 Uri，指向处理后的临时图片资源。但该 Uri 并不直接代表可持久化存储的文件路径——它可能是 content:// 协议的临时内容提供者 URI（如 content://media/...），也可能是应用私有缓存目录下的路径。因此，不能简单地用 FileOutputStream 写入 Uri.toString() 得到的字符串路径，而应通过 ContentResolver 安全读取并写入。

✅ 正确做法：通过 ContentResolver 加载 + 写入

核心逻辑分四步：

1. 使用 ContentResolver 从 Uri 加载 Bitmap；
2. 构造目标存储位置（推荐使用 MediaStore 插入媒体项，或应用专属目录）；
3. 获取 OutputStream（优先使用 getContentResolver().openOutputStream(targetUri)）；
4. 调用 bitmap.compress() 将数据写入流，并妥善关闭资源。

以下是在 onActivityResult 中 RESULT_OK 分支的完整、健壮实现（适配 Android 10+ 分区存储）：

case Activity.RESULT_OK: {
    Uri imageUri = CutOut.getUri(data);
    if (imageUri == null) {
        Toast.makeText(this, "获取图片失败", Toast.LENGTH_SHORT).show();
        return;
    }

    try {
        // Step 1: 从 URI 加载 Bitmap（自动处理 content:// 或 file://）
        Bitmap bitmap = MediaStore.Images.Media.getBitmap(getContentResolver(), imageUri);

        // Step 2: 创建目标保存路径 —— 推荐使用 MediaStore（兼容 Scoped Storage）
        ContentValues values = new ContentValues();
        values.put(MediaStore.Images.Media.DISPLAY_NAME, "bg_removed_" + System.currentTimeMillis() + ".png");
        values.put(MediaStore.Images.Media.MIME_TYPE, "image/png");
        values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES + "/BackgroundRemover/");

        Uri collection = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
        Uri targetUri = getContentResolver().insert(collection, values);

        if (targetUri == null) {
            throw new IOException("无法插入媒体库条目");
        }

        // Step 3 & 4: 写入压缩后的图片数据
        try (OutputStream os = getContentResolver().openOutputStream(targetUri)) {
            if (os == null) throw new IOException("无法打开输出流");
            bitmap.compress(Bitmap.CompressFormat.PNG, 95, os); // PNG 无损，质量设为 95 平衡清晰与体积
        }

        // 可选：通知图库刷新（Android 10+ 通常自动触发）
        sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, targetUri));

        Toast.makeText(this, "图片已保存至相册 > BackgroundRemover 文件夹", Toast.LENGTH_LONG).show();

        // 启动下一页
        startActivity(new Intent(BackgroundRemover.this, MainActivity.class));

    } catch (IOException e) {
        e.printStackTrace();
        Toast.makeText(this, "保存失败：" + e.getMessage(), Toast.LENGTH_LONG).show();
    }
    break;
}

⚠️ 关键注意事项

• 不要硬编码 file:// 路径：Environment.getExternalStorageDirectory() 在 Android 10（API 29）及以上已被弃用，且 file:// URI 在 targetSdkVersion >= 24 时可能触发 FileUriExposedException。
• 优先使用 MediaStore 保存：它天然适配分区存储（Scoped Storage），无需额外申请 WRITE_EXTERNAL_STORAGE 权限（Android 10+），且图片自动出现在系统图库中。
• Bitmap 加载需注意内存：若原图较大，建议先采样缩放（BitmapFactory.Options.inSampleSize），避免 OOM。
• 权限声明（仅 Android 9 及以下需显式声明）：

  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
      android:maxSdkVersion="28" />

  Android 10+ 无需此权限（使用 MediaStore 时）。

• 异常必须捕获并处理：getBitmap() 和 openOutputStream() 均可能抛出 IOException，不可忽略。

✅ 总结

保存 CutOut 返回的 Uri 图片，本质是「安全读取 → 格式转换 → 安全写入」的过程。摒弃旧式 File 操作，拥抱 ContentResolver + MediaStore 是现代 Android 图片持久化的标准路径。代码简洁、兼容性强、用户体验一致——这才是生产环境应有的实现方式。

以上就是《Android 保存背景移除图片方法》的详细内容，更多关于的资料请关注golang学习网公众号！