Android 图片选择到裁剪的步步深坑

2023-11-18 23:50:00

引子：

当我们着手于 Android 应用开发时，往往会遇到图片处理的需求。从相册中选择图片再进行裁剪是一个常见的场景，看似简单，却暗藏着诸多坑点。本文将深入剖析 Android 图片选择到裁剪的各个环节，帮你规避常见的陷阱，踏上图片处理的康庄大道。

阶段一：图片选择

权限申请：

在访问相册之前，我们需要确保已获取 READ_EXTERNAL_STORAGE 权限。如果没有权限，系统会抛出异常。
Intent 选择：

使用 Intent.ACTION_PICK 来启动图片选择器。你可以通过设置 EXTRA_MIME_TYPES 来过滤可选择的文件类型。
onActivityResult 处理：

选择图片后，系统会返回一个 Intent。需要通过 getData() 获取图片的 Uri，并通过 getContentResolver().openInputStream(Uri) 打开图片流进行处理。

阶段二：图片裁剪

裁剪 Intent：

使用 Intent.ACTION_CROP 来启动图片裁剪器。设置 EXTRA_OUTPUT 以指定裁剪后的图片保存路径。
裁剪参数：

设置裁剪的参数，包括 EXTRA_ASPECT_X、EXTRA_ASPECT_Y（裁剪后的宽高比例）、EXTRA_OUTPUT_X、EXTRA_OUTPUT_Y（裁剪后的图片尺寸）等。
onActivityResult 处理：

裁剪完成后，系统会返回一个 Intent。可以通过 getData() 获取裁剪后的图片 Uri。

常见的陷阱：

图片过大：

如果选择的大图过大，可能会导致裁剪器崩溃。需要对图片进行预处理，缩小后再进行裁剪。
权限未授予：

如果用户拒绝了权限申请，则无法访问相册。需要进行权限判断并友好提示用户。
裁剪结果不符合预期：

裁剪参数设置错误会导致裁剪结果不符合预期。需要仔细检查裁剪参数的含义。
裁剪 URI 无效：

裁剪完成后，系统返回的裁剪结果 Uri 可能无效。需要验证 Uri 的正确性。

代码示例：

// 选择图片
Intent intent = new Intent(Intent.ACTION_PICK);
intent.setType("image/*");
startActivityForResult(intent, REQUEST_CODE_PICK);

// 裁剪图片
Intent intent = new Intent(Intent.ACTION_CROP);
intent.setDataAndType(imageUri, "image/*");
intent.putExtra("crop", "true");
intent.putExtra("aspectX", 1);
intent.putExtra("aspectY", 1);
intent.putExtra("outputX", 500);
intent.putExtra("outputY", 500);
intent.putExtra("scale", true);
intent.putExtra("return-data", false);
intent.putExtra(MediaStore.EXTRA_OUTPUT, outputUri);
startActivityForResult(intent, REQUEST_CODE_CROP);