本文详解如何在使用 CutOut 等图像处理库（如背景去除）后，将 onActivityResult 中返回的 Uri 对应的图像持久化保存至设备存储，涵盖 Bitmap 加载、安全写入、文件命名与权限适配等关键步骤。
本文详解如何在使用 cutout 等图像处理库（如背景去除）后，将 `onactivityresult` 中返回的 `uri` 对应的图像持久化保存至设备存储，涵盖 bitmap 加载、安全写入、文件命名与权限适配等关键步骤。
在调用类似 CutOut 这类第三方图像背景去除库时，处理完成后会通过 Intent 返回一个 Uri（通常指向临时缓存或沙盒内的图像资源）。但该 Uri 并非可直接写入的文件路径——它可能指向 content:// 协议（如 MediaStore 或临时 provider），因此不能简单拼接 file:// 路径并用 FileOutputStream 写入。错误地使用 Environment.getExternalStorageDirectory() 构造 file:// URI 在 Android 10+（API 29+）上将导致 SecurityException 或静默失败。
✅ 正确做法是：通过 ContentResolver 安全读取原始图像数据 → 解码为 Bitmap → 再写入目标位置（推荐使用 MediaStore 插入新条目）。以下是生产环境推荐的完整实现：
✅ 推荐方案：使用 MediaStore 保存（兼容 Android 7.0–14，无需动态存储权限）
case Activity.RESULT_OK:
Uri imageUri = CutOut.getUri(data);
if (imageUri == null) {
Toast.makeText(this, "获取图像 URI 失败", Toast.LENGTH_SHORT).show();
return;
}
try {
// 1. 从 content URI 安全加载 Bitmap
Bitmap bitmap = MediaStore.Images.Media.getBitmap(getContentResolver(), imageUri);
// 2. 构建 MediaStore 插入参数（推荐方式）
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.DATE_ADDED, System.currentTimeMillis());
// 3. 插入新图像条目，获取可写入的 output Uri
Uri insertUri = getContentResolver().insert(
MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
values
);
if (insertUri == null) {
throw new IOException("无法插入到 MediaStore");
}
// 4. 写入压缩后的图像数据
try (OutputStream os = getContentResolver().openOutputStream(insertUri)) {
if (os == null) throw new IOException("无法打开输出流");
bitmap.compress(Bitmap.CompressFormat.PNG, 95, os); // PNG 无损，质量设为 95 平衡清晰度与体积
}
// 5. 通知系统刷新图库（可选，部分设备需要）
sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, insertUri));
Toast.makeText(this, "图像已保存至相册", Toast.LENGTH_LONG).show();
// 启动目标 Activity
startActivity(new Intent(BackgroundRemover.this, MainActivity.class));
} catch (IOException e) {
e.printStackTrace();
Toast.makeText(this, "保存失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
}
break;⚠️ 注意事项与最佳实践
- 不要硬编码 file:// 路径：Environment.getExternalStorageDirectory() 在 Android 10+ 已被弃用（Scoped Storage），且 file:// URI 在 targetSdkVersion >= 24 下需 FileProvider，否则抛出 FileUriExposedException。
- 优先使用 MediaStore 写入：它自动处理分区存储（Android 10+）、媒体扫描和权限隔离，无需申请 WRITE_EXTERNAL_STORAGE 权限（targetSdkVersion ≥ 30 时该权限已废弃）。
- Bitmap 加载需防 OOM：若原图过大，建议先采样缩放（例如用 BitmapFactory.Options.inSampleSize），尤其在内存受限设备上。
- 异常必须捕获：getBitmap() 可能因 URI 无效、权限缺失或 I/O 中断抛出 IOException；openOutputStream() 在存储空间不足或权限拒绝时也会失败。
- 命名建议唯一性：使用时间戳或 UUID 避免文件名冲突，如 "bg_removed_" + System.currentTimeMillis() + ".png"。
- PNG vs JPEG：背景去除后图像常含透明通道（Alpha），务必使用 PNG 格式；JPEG 不支持透明，会丢失背景信息。
✅ 总结
保存 CutOut 返回的 Uri 图像，核心在于尊重 Android 存储模型演进：放弃旧式 file:// 直写，转而通过 ContentResolver + MediaStore 实现安全、兼容、可维护的图像持久化。该方案覆盖 API 24–34，无需额外运行时权限，且天然适配分区存储（Scoped Storage），是当前最稳健的工程实践。
