图片文件插入系统相册(适配Androird10.0(Q) API Level 29)

1.前言

本文介绍兼容AndroidQ的“图片文件（包括gif文件）插入相册”方案。
以前的发送广播方式已失效，并且insertImage(ContentResolver cr, String imagePath, String name, String description)也已被废弃。
因此需要使用新的插入相册实现方式。并针对AndroidQ进行版本适配。

2. “图片插入相册”具体实现：

这里有一个需要注意的地方：put(MediaStore.Images.Media.IS_PENDING, 1)。这个设置是做耗时操作时，需要独占资源。但是使用结束后，务必注意解除独占。

    fun insertImage(context: Context, filePath: String) {
        if (!checkFile(filePath)) {
            return
        }
        val resolver = context.applicationContext.contentResolver
        val imageCollection = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY)
        } else {
            MediaStore.Images.Media.EXTERNAL_CONTENT_URI
        }
        val contentValues = ContentValues().apply {
            val saveFile = File(filePath)
            put(
                MediaStore.Images.Media.DISPLAY_NAME,
                saveFile.nameWithoutExtension + System.currentTimeMillis()
            )
            //设置文件类型为image/*
            put(MediaStore.MediaColumns.MIME_TYPE, getPhotoMimeType(filePath))
            val imageTime = System.currentTimeMillis()
            put(MediaStore.MediaColumns.DATE_ADDED, imageTime / 1000)
            put(MediaStore.MediaColumns.DATE_MODIFIED, imageTime / 1000)
            // 判断是否android10 以上
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
                // 设置相对路径（自动创建文件夹）
                val folder = context.resources.getString(R.string.app_name)
                val relativeName =
                    Environment.DIRECTORY_PICTURES + File.separator + folder + File.separator
                put(MediaStore.MediaColumns.RELATIVE_PATH, relativeName)
                // 设置独占锁：耗时操作，独占访问权限，完成操作需复位
                put(MediaStore.Images.Media.IS_PENDING, 1)
            }
        }
        resolver.insert(imageCollection, contentValues)?.let { insertUri ->
            val isSuccess = copyFile(context, resolver, filePath, insertUri)
            //判断是否android10 以上
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
                // 复位（解除）独占权限
                contentValues.clear()
                contentValues.put(MediaStore.Images.Media.IS_PENDING, 0)
                resolver.update(insertUri, contentValues, null, null)
            }
        }
    }

3. 以下是其他工具方法：

3.1 获取图片类型（mine_type）

   /**
     * 获取照片的mine_type
     *
     * @param path
     * @return
     */
    private fun getPhotoMimeType(path: String): String? {
        val lowerPath = path.toLowerCase()
        if (lowerPath.endsWith("jpg") || lowerPath.endsWith("jpeg")) {
            return "image/jpeg"
        } else if (lowerPath.endsWith("png")) {
            return "image/png"
        } else if (lowerPath.endsWith("gif")) {
            return "image/gif"
        }
        return "image/jpeg"
    }

3.2 检测文件是否存在

   /**
     * 检测文件存在
     *
     * @param filePath
     * @return
     */
    private fun checkFile(filePath: String): Boolean {
        //boolean result = FileUtil.fileIsExist(filePath);
        var result = false
        val mFile = File(filePath)
        if (mFile.exists()) {
            result = true
        }
        val logStr = if (result) "文件已存在" else "文件不存在"
        Log.e(TAG, "$logStr, path = $filePath")
        return result
    }

3.3 图片使用流写入相册

/**
     * 通过两个路径地址生成对应的输入输出流
     * 主要方式获取ContentResolver.openOutputStream(insertUri)
     */
    private fun copyFile(
        context: Context,
        contentResolver: ContentResolver,
        sourceFilePath: String,
        insertUri: Uri
    ): Boolean {
        var inputStream: InputStream? = null //输入流
        var outputStream: OutputStream? = null //输出流
        return try {
            var isCopySuccess = false
            outputStream = contentResolver.openOutputStream(insertUri)?.also { outStream ->
                val sourceFile = File(sourceFilePath)
                if (sourceFile.exists()) { // 文件存在时
                    // 读入原文件
                    inputStream = FileInputStream(sourceFile).also { inStream ->
                        //输入流读取文件，输出流写入指定目录
                        isCopySuccess = copyFileWithStream(outStream, inStream)
                    }
                }
            }
            isCopySuccess
        } catch (e: Exception) {
            e.printStackTrace()
            false
        } finally {
            try {
                inputStream?.close()
                outputStream?.close()
            } catch (e: IOException) {
                e.printStackTrace()
            }
        }
    }

    /**
     * 利用输入输出流边读边写，将文件(图片)写入指定路径
     */
    private fun copyFileWithStream(outputStream: OutputStream, inputStream: InputStream): Boolean {
        var isSuccess = false
        try {
            inputStream.use { ins ->
                val buf = ByteArray(2048)
                var len: Int
                while (ins.read(buf).also { len = it } != -1) {
                    outputStream.write(buf, 0, len)
                }
                outputStream.flush()
            }
            isSuccess = true
        } catch (e: IOException) {
            Log.e(TAG, Log.getStackTraceString(e))
            isSuccess = false
        } finally {
            try {
                outputStream.close()
                inputStream.close()
            } catch (e: IOException) {
                e.printStackTrace()
            }
        }
        return isSuccess
    }

参考文档：

官方文档地址：[https://developer.android.google.cn/training/data-storage/shared/media#add-item]