升级ImagePicker库后getFile方法失效的Android适配问题求助

变更背景 #

ImagePicker v2.0版本移除了ImagePicker.getFile()方法，同时为适配Android 13的存储权限规范，原有依赖该方法的代码需要调整。

官方变更说明（翻译） #

• 移除ImagePicker.getFile()方法：Android Q及以上版本的Scoped Storage机制限制了直接访问外部存储文件的权限，该方法已不符合新规范。
• 推荐通过返回的Uri直接操作文件，或自行将Uri转换为可访问的File对象。
• 错误处理逻辑保持不变，仍可通过ImagePicker.getError()获取错误信息。

适配代码实现 #

1. 新增Uri转File工具方法 #

由于库不再提供getFile方法，需自行实现从Uri到File的转换，将图片复制到应用缓存目录以规避权限问题：

private fun uriToFile(context: Context, uri: Uri): File? {
    return try {
        val inputStream = context.contentResolver.openInputStream(uri) ?: return null
        // 创建临时文件存储图片，存放在应用缓存目录
        val tempFile = File(context.cacheDir, "temp_img_${System.currentTimeMillis()}.jpg")
        inputStream.use { input ->
            tempFile.outputStream().use { output ->
                input.copyTo(output)
            }
        }
        tempFile
    } catch (e: Exception) {
        e.printStackTrace()
        null
    }
}

2. 修改图片选择逻辑 #

替换原有依赖getFile()的代码，改用上述工具方法处理返回的Uri：

private fun addPhoto() {
    requireActivity().showImagePicker {
        when (it.resultCode) {
            Activity.RESULT_OK -> {
                it.data?.data?.let { uri ->
                    val imageFile = uriToFile(requireContext(), uri)
                    imageFile?.let { file ->
                        listPhotos = arrayListOf(file)
                        savePhoto()
                    } ?: toastError("图片转换失败")
                } ?: toastError("未选择有效图片")
            }
            ImagePicker.RESULT_ERROR -> {
                ImagePicker.getError(it.data)?.let { errorMsg ->
                    toastError(errorMsg)
                } ?: toastError("图片选择出错")
            }
        }
    }
}

注意事项 #

• 缓存目录的文件会在应用卸载时自动清除，若需长期保存图片，可将文件移动到应用私有目录（如context.filesDir）。
• Android 13及以上版本无需申请WRITE_EXTERNAL_STORAGE权限，该方案完全适配Scoped Storage规范。
• 若需支持多种图片格式，可根据Uri的MIME类型动态调整临时文件的后缀名。

内容的提问来源于stack exchange，提问作者Hasan Ozan