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("webp")) {
return "image/webp"
} 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
}
