Android

安卓拍照、裁切、选取图片实践

前言

最近项目里面有用到裁切功能，没弄多复杂，就是系统自带的，顺便就总结了一下系统拍照、裁切、选取的使用。网上的资料说实话真是没什么营养，但是Android官网上的说明也有点太简单了，真就要实践出真理。

更新

最近花了点时间把拍照、裁切的功能整理了下，并解决了下Android11上裁切闪退的问题、相册裁切闪退问题，就不多写一篇文章了，可以看我github的demo:

TakePhotoFragment.kt

BitmapFileUtil.kt

拍照

本来拍照是没什么难度的，不就是调用intent去系统相机拍照么，但是由于文件权限问题，Uri这东西就能把人很头疼。下面是代码(onActivityResult见后文)：

    private fun openCamera() {
val intent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
// 应用外部私有目录：files-Pictures
val picFile = createFile("Camera")
val photoUri = getUriForFile(picFile)
// 保存路径，不要uri，读取bitmap时麻烦

        picturePath = picFile.absolutePath
// 给目标应用一个临时授权

        intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
//android11以后强制分区存储，外部资源无法访问，所以添加一个输出保存位置，然后取值操作

        intent.putExtra(MediaStore.EXTRA_OUTPUT, photoUri)

        startActivityForResult(intent, REQUEST_CAMERA_CODE)

    }

private fun createFile(type: String): File {
// 在相册创建一个临时文件
val picFile = File(requireContext().getExternalFilesDir(Environment.DIRECTORY_PICTURES),
"${type}_${System.currentTimeMillis()}.jpg")
try {
if (picFile.exists()) {

                picFile.delete()

            }

            picFile.createNewFile()

        } catch (e: IOException) {

            e.printStackTrace()

        }

// 临时文件，后面会加long型随机数
//        return File.createTempFile(
//            type,
//            ".jpg",
//            requireContext().getExternalFilesDir(Environment.DIRECTORY_PICTURES)
//        )

return picFile

    }

private fun getUriForFile(file: File): Uri {
// 转换为uri
return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
//适配Android 7.0文件权限，通过FileProvider创建一个content类型的Uri

            FileProvider.getUriForFile(

                requireActivity(),
"com.xxx.xxx.fileProvider", file

            )

        } else {

            Uri.fromFile(file)

        }

    }

简单说明

这里的file是使用getExternalFilesDir和Environment.DIRECTORY_PICTURES生成的，它的文件保存在应用外部私有目录：files-Pictures里面。这里要注意不能存放在内部的私有目录里面，不然是无法访问的，外部私有目录虽然也是私有的，但是外面是可以访问的，这里拿官网上的说明：

在搭载 Android 9（API 级别 28）或更低版本的设备上，只要您的应用具有适当的存储权限，就可以访问属于其他应用的应用专用文件。为了让用户更好地管理自己的文件并减少混乱，以 Android 10（API 级别 29）及更高版本为目标平台的应用在默认情况下被授予了对外部存储空间的分区访问权限（即分区存储）。启用分区存储后，应用将无法访问属于其他应用的应用专属目录。

Uri的获取

再一个比较麻烦的就是Uri的获取了，网上有一大堆资料，不过我这也贴一下，网上的可能有问题。

manifest.xml

        <provider
android:name="androidx.core.content.FileProvider"
android:authorities="com.xxx.xxx.fileProvider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/file_paths"

                />
</provider>

res -> xml -> file_paths.xml

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<!--1、对应内部内存卡根目录：Context.getFileDir()-->
<files-path
name="int_root"
path="/" />
<!--2、对应应用默认缓存根目录：Context.getCacheDir()-->
<cache-path
name="app_cache"
path="/" />
<!--3、对应外部内存卡根目录：Environment.getExternalStorageDirectory()-->
<external-path
name="ext_root"
path="/" />
<!--4、对应外部内存卡根目录下的APP公共目录：Context.getExternalFileDir(String)-->
<external-files-path
name="ext_pub"
path="/" />
<!--5、对应外部内存卡根目录下的APP缓存目录：Context.getExternalCacheDir()-->
<external-cache-path
name="ext_cache"
path="/" />
</paths>

ps. 注意authorities这个最好填自己的包名，不然有两个应用用了同样的authorities，后面的应用会安装不上。

path里面填 “/” 和 “*” 是有区别的，前者包含了子目录，后面只包含当前目录，最好就是用 “/”，不然创建个子文件夹，到时候访问搞出了线上问题，那就凉凉喽(还好我遇到的时候测试测出来了)。

打开相册

这里打开相册用的是SAF框架，使用intent去选取(onActivityResult见后文)。

    private fun openAlbum() {
val intent = Intent()

        intent.type = "image/*"

        intent.action = "android.intent.action.GET_CONTENT"

        intent.addCategory("android.intent.category.OPENABLE")

        startActivityForResult(intent, REQUEST_ALBUM_CODE)

    }

裁切

裁切这里比较麻烦，参数比较多，而且Uri那里有坑，不能使用provider，再一个就是图片传递那因为安卓版本变更，不会传略缩图了，很坑。

    private fun cropImage(path: String) {

        cropImage(getUriForFile(File(path)))

    }

private fun cropImage(uri: Uri) {
val intent = Intent("com.android.camera.action.CROP")
// Android 7.0需要临时添加读取Url的权限

        intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
//        intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION)

        intent.setDataAndType(uri, "image/*")
// 使图片处于可裁剪状态

        intent.putExtra("crop", "true")
// 裁剪框的比例（根据需要显示的图片比例进行设置）
//        if (Build.MANUFACTURER.contains("HUAWEI")) {
//            //硬件厂商为华为的，默认是圆形裁剪框，这里让它无法成圆形
//            intent.putExtra("aspectX", 9999)
//            intent.putExtra("aspectY", 9998)
//        } else {
//            //其他手机一般默认为方形
//            intent.putExtra("aspectX", 1)
//            intent.putExtra("aspectY", 1)
//        }

// 设置裁剪区域的形状，默认为矩形，也可设置为圆形，可能无效
// intent.putExtra("circleCrop", true);
// 让裁剪框支持缩放

        intent.putExtra("scale", true)
// 属性控制裁剪完毕，保存的图片的大小格式。太大会OOM（return-data）
//        intent.putExtra("outputX", 400)
//        intent.putExtra("outputY", 400)

// 生成临时文件
val cropFile = createFile("Crop")
// 裁切图片时不能使用provider的uri，否则无法保存
//        val cropUri = getUriForFile(cropFile)
val cropUri = Uri.fromFile(cropFile)

        intent.putExtra(MediaStore.EXTRA_OUTPUT, cropUri)
// 记录临时位置

        cropPicPath = cropFile.absolutePath

// 设置图片的输出格式

        intent.putExtra("outputFormat", Bitmap.CompressFormat.JPEG.toString())

// return-data=true传递的为缩略图，小米手机默认传递大图， Android 11以上设置为true会闪退

        intent.putExtra("return-data", false)


        startActivityForResult(intent, REQUEST_CROP_CODE)

    }

回调处理

下面是对上面三个操作的回调处理，一开始我觉得uri没什么用，还制造麻烦，后面发现可以通过流打开uri，再去获取bitmap，好像又不是那么麻烦了。

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
if (resultCode == RESULT_OK) {

            when(requestCode) {

                REQUEST_CAMERA_CODE -> {
// 通知系统文件更新
//                    requireContext().sendBroadcast(Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE,
//                        Uri.fromFile(File(picturePath))))
if (!enableCrop) {
val bitmap = getBitmap(picturePath)

                        bitmap?.let {
// 显示图片

                            binding.image.setImageBitmap(it)

                        }

                    }else {

                        cropImage(picturePath)

                    }

                }

                REQUEST_ALBUM_CODE -> {

                    data?.data?.let { uri ->
if (!enableCrop) {
val bitmap = getBitmap("", uri)

                            bitmap?.let {
// 显示图片

                                binding.image.setImageBitmap(it)

                            }

                        }else {

                            cropImage(uri)

                        }

                    }

                }

                REQUEST_CROP_CODE -> {
val bitmap = getBitmap(cropPicPath)

                    bitmap?.let {
// 显示图片

                        binding.image.setImageBitmap(it)

                    }

                }

            }

        }

    }

private fun getBitmap(path: String, uri: Uri? = null): Bitmap? {
var bitmap: Bitmap?
val options = BitmapFactory.Options()
// 先不读取，仅获取信息

        options.inJustDecodeBounds = true
if (uri == null) {

            BitmapFactory.decodeFile(path, options)

        }else {
val input = requireContext().contentResolver.openInputStream(uri)

            BitmapFactory.decodeStream(input, null, options)

        }

// 预获取信息，大图压缩后加载
val width = options.outWidth
val height = options.outHeight

        Log.d("TAG", "before compress: width = " +

                options.outWidth + "， height = " + options.outHeight)

// 尺寸压缩
var size = 1
while (width / size >= MAX_WIDTH || height / size >= MAX_HEIGHT) {

            size *= 2

        }

        options.inSampleSize = size

        options.inJustDecodeBounds = false
bitmap = if (uri == null) {

            BitmapFactory.decodeFile(path, options)

        }else {
val input = requireContext().contentResolver.openInputStream(uri)

            BitmapFactory.decodeStream(input, null, options)

        }

        Log.d("TAG", "after compress: width = " +

                options.outWidth + "， height = " + options.outHeight)

// 质量压缩
val baos = ByteArrayOutputStream()

        bitmap!!.compress(Bitmap.CompressFormat.JPEG, 80, baos)
val bais = ByteArrayInputStream(baos.toByteArray())

        options.inSampleSize = 1

        bitmap = BitmapFactory.decodeStream(bais, null, options)

return bitmap

    }