前言

图片上传操作基本上是每个应用都会有的功能，但是由于Android碎片话严重，导致适配很繁琐，比如6.0以下版本、6.0的动态权限、7.0的FileProvider、8.0的特殊情况，再加上马上要出的Android Q权限变化。我个人项目中三方库能少用就少用，能自己解决，绝不用三方库，因为很多时候三方库不一定能满足自身要求，尤其是UI方面。下面记录下我项目中用到的图片操作，用Android原生方式实现，并且适配了Andrioid 7.0的FileProvider。

动态权限

6.0以上危险权限需要动态获取，那可能不知道哪些是危险权限，那么看下图：

危险权限列表

选取图片用的文件读写和相机操作都需要动态获取，我们这里依然用原生实现，代码如下：

    override fun onResume() {
        super.onResume()
        checkPermission()
    }

     /**
     * 获取权限
     * 因为是一次请求完几个权限，不是在用到的时候再请求，
     * 所以不需要重写onRequestPermissionsResult方法
     */
    private fun checkPermission() {
        val storage = arrayOf(
            Manifest.permission.WRITE_EXTERNAL_STORAGE,
            Manifest.permission.READ_EXTERNAL_STORAGE
        )
        val camera = arrayOf(Manifest.permission.CAMERA)
        //检查相机权限
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
            // 之前拒绝了权限，但没有点击 不再询问 这个时候让它继续请求权限
            if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CAMERA)) {
                Log.d(TAG, "用户曾拒绝打开相机权限")
                ActivityCompat.requestPermissions(this, camera, 100)
            } else {
                //注册相机权限
                ActivityCompat.requestPermissions(this, camera, 100)
            }
        }
        //检查文件读写权限
        if (ContextCompat.checkSelfPermission(
                this,
                Manifest.permission.READ_EXTERNAL_STORAGE
            ) != PackageManager.PERMISSION_GRANTED
            || ContextCompat.checkSelfPermission(
                this,
                Manifest.permission.WRITE_EXTERNAL_STORAGE
            ) != PackageManager.PERMISSION_GRANTED
        ) {
            if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CAMERA)) {
                Log.d(TAG, "用户曾拒绝打开文件读写权限")
                ActivityCompat.requestPermissions(this, storage, 101)
            } else {
                //注册相机权限
                ActivityCompat.requestPermissions(this, storage, 101)
            }
        }
    }

7.0FileProvider适配

第一步

在res目录下创建xml文件夹，在文件夹下创建一个文件，比如：file_paths.xml，文件里添加如下代码：

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <files-path
        name="files"
        path="/"/>
    <cache-path
        name="cache"
        path="/"/>
    <external-path
        name="external"
        path="/"/>
    <external-files-path
        name="external_file_path"
        path="/"/>
    <external-cache-path
        name="external_cache_path"
        path="/"/>
</paths>

第二步

在AndroidManifest.xml的application中添加provider标签，如下图所示：

provider.png

其中${applicationId}你可以直接这么写，也可以替换成你的包名。这两步配置好了后7.0适配算是完成了三分之二，后面如何在代码中读取文件，请耐心往后看。

目录创建

相机拍照后保存在手机DCIM/Image目录下，如下代码中getFileUri方法就是对7.0的兼容

/**
 * @author limh
 * @function
 * @date 2019/4/19 9:40
 */
object FileUtils {
    val BASE_PATH = "${Environment.getExternalStorageDirectory()}/DCIM/Image"
    /**
     * 根据文件名称 生成目录
     * @param fileName 文件名称
     */
    fun getFilePath(fileName: String): String {
        val dir = File(BASE_PATH)
        //如果目录不存在 先创建目录
        if (!dir.exists()) {
            dir.mkdir()
        }
        return "$BASE_PATH/$fileName"
    }

    /**
     * 获取文件Uri
     * @param fileName 文件名称
     */
    fun getFileUri(context: Context, fileName: String): Uri {
        val filePah = getFilePath(fileName)
        return if (Build.VERSION.SDK_INT >= 24) {
            FileProvider.getUriForFile(context, "${BuildConfig.APPLICATION_ID}.fileprovider", File(filePah))
        } else {
            Uri.fromFile(File(filePah))
        }
    }
}

打开相机

    /**
     * 打开相机
     */
    private fun openCamera() {
        Log.d(TAG, "打开相机")
        imgUri = FileUtils.getFileUri(context, "{${System.currentTimeMillis()}}.jpg")
        // 创建Intent，用于启动手机的照相机拍照
        val intent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
        // 指定输出到文件uri中
        intent.putExtra(MediaStore.EXTRA_OUTPUT, imgUri)
        // 启动intent开始拍照
        startActivityForResult(intent, REQUEST_CAMERA)
    }

• 注意：上面打开相机方式拍照后文件会保存在imgUri中，onActivityResult回调不会返回数据，当回调成功后直接拿imgUri就是你拍的照片内容。拍照完成打开DCIM/Image/Album_xxxxxx.jpg，就是你刚拍摄的图片。

打开相册

    /**
     * 打开相册
     */
    private fun openAlbum() {
        Log.d(TAG, "打开相册")
        val albumIntent = Intent(Intent.ACTION_PICK)
        albumIntent.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, "image/*")
        startActivityForResult(albumIntent, REQUEST_ALBUM)
    }

• 注意：这种方式打开相册 打开相册后选择的图片uri会在intent的data中，需要我们从里面取.

原生裁剪

    /**
     * 裁剪图片
     * @param uri:要裁剪的文件
     */
    private fun corpPic(uri: Uri?) {
        //裁剪后的文件名称
        val fileName = "Crop_${System.currentTimeMillis()}.jpg"
        //裁剪后文件Uri
        imgUri = FileUtils.getFileUri(context, fileName)
        val intent = Intent("com.android.camera.action.CROP")
        intent.setDataAndType(uri, "image/*")
        //以下两行添加，解决无法加载此图片的提示
        intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
        intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION)
        intent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(File(FileUtils.getFilePath(fileName))))
        intent.putExtra("crop", "true")
        intent.putExtra("aspectX", 1) // 裁剪框比例
        intent.putExtra("aspectY", 1)
        intent.putExtra("outputX", 100) // 输出图片大小
        intent.putExtra("outputY", 100)
        intent.putExtra("scale", false)
        intent.putExtra("outputFormat", Bitmap.CompressFormat.JPEG.toString())
        startActivityForResult(intent, REQUEST_CORP)
    }

-注意：裁剪输出目录一定要用Uri.fromFile生成，直接用imgUri的话会提示：无法保存经过裁剪的图片，图片也无法正常加载。

个人感觉原生裁剪很好用，可以设置裁剪比例和输出大小。设置完后图片很小，也不需要做压缩操作。

相机相册以及裁剪回调

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        Log.d(TAG, "返回结果：${data ?: data.toString()}")
        if (requestCode == REQUEST_CAMERA) {
            //相机结果返回
            if (resultCode == Activity.RESULT_OK) {
                imgUri?.let { corpPic(it) }
            }
        } else if (requestCode == REQUEST_ALBUM) {
            //相册返回结果
            if (resultCode == Activity.RESULT_OK) {
                //选择的图片转存 在DCIM/Image目录
                data?.let { corpPic(it.data) }
            }
        } else if (requestCode == REQUEST_CORP) {
            //裁剪回调
            Picasso.get().load(imgUri).memoryPolicy(MemoryPolicy.NO_CACHE).into(image)
        }
    }

至此，整个相机相册以及裁剪操作完成，最终的结果都保存到Uri中，但是有时候还需要解析文件路径，这个解析就涉及到版本兼容，又是另一个大坑，5.0上下获取方式都不同，好歹踩过坑的人，因此再上一个文件路径解析工具，直接调用ImagePath.getRealPathFromUri将Uri转换为String路径：

/**
 * @author limh
 * @function 解析图片路径
 * @date 2019/2/25 11:29
 */
object ImagePath {
    /**
     * 根据Uri获取图片的绝对路径
     *
     * @param context 上下文对象
     * @param uri     图片的Uri
     * @return 如果Uri对应的图片存在, 那么返回该图片的绝对路径, 否则返回null
     */
    fun getRealPathFromUri(context: Context, uri: Uri?): String? {
        if (null == uri) return ""
        val sdkVersion = Build.VERSION.SDK_INT
        return if (sdkVersion >= 19) {
            getRealPathFromUriAboveApi19(context, uri)
        } else { // api < 19
            getRealPathFromUriBelowAPI19(context, uri)
        }
    }

    /**
     * 适配api19以下(不包括api19),根据uri获取图片的绝对路径
     *
     * @param context 上下文对象
     * @param uri     图片的Uri
     * @return 如果Uri对应的图片存在, 那么返回该图片的绝对路径, 否则返回null
     */
    private fun getRealPathFromUriBelowAPI19(context: Context, uri: Uri): String? {
        return getDataColumn(context, uri, null, null)
    }

    /**
     * 适配api19及以上,根据uri获取图片的绝对路径
     *
     * @param context 上下文对象
     * @param uri     图片的Uri
     * @return 如果Uri对应的图片存在, 那么返回该图片的绝对路径, 否则返回null
     */
    @SuppressLint("NewApi")
    private fun getRealPathFromUriAboveApi19(context: Context, uri: Uri): String? {
        var filePath: String? = null
        if (DocumentsContract.isDocumentUri(context, uri)) {
            // 如果是document类型的 uri, 则通过document id来进行处理
            val documentId = DocumentsContract.getDocumentId(uri)
            if (isMediaDocument(uri)) { // MediaProvider
                // 使用':'分割
                val id = documentId.split(":".toRegex()).dropLastWhile { it.isEmpty() }.toTypedArray()[1]

                val selection = MediaStore.Images.Media._ID + "=?"
                val selectionArgs = arrayOf(id)
                filePath =
                    getDataColumn(context, MediaStore.Images.Media.EXTERNAL_CONTENT_URI, selection, selectionArgs)
            } else if (isDownloadsDocument(uri)) { // DownloadsProvider
                val contentUri = ContentUris.withAppendedId(
                    Uri.parse("content://downloads/public_downloads"),
                    java.lang.Long.valueOf(documentId)
                )
                filePath = getDataColumn(context, contentUri, null, null)
            }
        } else if ("content".equals(uri.scheme!!, ignoreCase = true)) {
            // 如果是 content 类型的 Uri
            filePath = getDataColumn(context, uri, null, null)
        } else if ("file" == uri.scheme) {
            // 如果是 file 类型的 Uri,直接获取图片对应的路径
            filePath = uri.path
        }
        return filePath
    }

    /**
     * 获取数据库表中的 _data 列，即返回Uri对应的文件路径
     *
     * @return
     */
    private fun getDataColumn(context: Context, uri: Uri, selection: String?, selectionArgs: Array<String>?): String? {
        var path: String? = null

        val projection = arrayOf(MediaStore.Images.Media.DATA)
        var cursor: Cursor? = null
        try {
            cursor = context.contentResolver.query(uri, projection, selection, selectionArgs, null)
            if (cursor != null && cursor.moveToFirst()) {
                val columnIndex = cursor.getColumnIndexOrThrow(projection[0])
                path = cursor.getString(columnIndex)
            }
        } catch (e: Exception) {
            cursor?.close()
        }

        return path
    }

    /**
     * @param uri the Uri to check
     * @return Whether the Uri authority is MediaProvider
     */
    private fun isMediaDocument(uri: Uri): Boolean {
        return "com.android.providers.media.documents" == uri.authority
    }

    /**
     * @param uri the Uri to check
     * @return Whether the Uri authority is DownloadsProvider
     */
    private fun isDownloadsDocument(uri: Uri): Boolean {
        return "com.android.providers.downloads.documents" == uri.authority
    }
}

总结

生命不息，踩坑不止，很多Android三方库追根揭底也是对原生SDK的封装，多了解下原生的写法，你就是下一个轮子大神。

最后附上github地址：
https://github.com/limhGeek/Album