本文详解如何在使用 CutOut 等图像处理库后，将返回的 Uri 对应的图片安全、可靠地保存至设备存储，涵盖 Bitmap 加载、输出流写入、权限适配及最佳实践。
本文详解如何在使用 cutout 等图像处理库后，将返回的 `uri` 对应的图片安全、可靠地保存至设备存储，涵盖 bitmap 加载、输出流写入、权限适配及最佳实践。
在 Android 开发中，调用第三方图像处理库（如 CutOut）完成背景移除后，通常会通过 Intent 返回一个 Uri，指向处理后的临时图片资源。但该 Uri 并不直接代表可持久化存储的文件路径——它可能是 content:// 协议的临时内容提供者 URI（如 content://media/...），也可能是应用私有缓存目录下的路径。因此，不能简单地用 FileOutputStream 写入 Uri.toString() 得到的字符串路径，而应通过 ContentResolver 安全读取并写入。
✅ 正确做法：通过 ContentResolver 加载 + 写入
核心逻辑分四步：
- 使用 ContentResolver 从 Uri 加载 Bitmap；
- 构造目标存储位置（推荐使用 MediaStore 插入媒体项，或应用专属目录）；
- 获取 OutputStream（优先使用 getContentResolver().openOutputStream(targetUri)）；
- 调用 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 图片持久化的标准路径。代码简洁、兼容性强、用户体验一致——这才是生产环境应有的实现方式。
