Android 版本适配：巧用 Kotlin 扩展轻松解决 URI 曝光问题

前言

随着 Android 系统的不断更新迭代，开发者面临着适配新版本带来的各种挑战。其中，Android 7.0 引入的 StrictMode API 政策，对应用公开 file:/// URI 类型的 Intent 做出了限制，导致应用在跨进程传递文件时容易崩溃。本文将探讨如何使用 Kotlin 扩展轻松解决此问题，并提供详细的示例代码，帮助开发者从容应对 Android 版本适配。

StrictMode API 政策及限制

StrictMode API 政策是一种用于检测和防止应用程序中潜在问题的工具。在 Android 7.0 及更高版本中，StrictMode API 政策默认禁止应用程序向外部公开 file:/// URI 类型的 Intent。当一个包含 file:/// URI 类型数据的 Intent 离开应用程序时，系统将抛出 FileUriExposedException 异常，导致应用程序崩溃。

解决方法：Kotlin 扩展

为了解决 FileUriExposedException 异常问题，我们可以使用 Kotlin 扩展来巧妙地将 file:/// URI 转换为 content:/// URI，从而绕过 StrictMode API 政策的限制。Kotlin 扩展是一种语法糖，允许我们为现有类添加新的功能，而不必修改源代码。

fun Uri.toContentUri(): Uri? {
    if (scheme == "file") {
        return MediaStore.Images.Media.EXTERNAL_CONTENT_URI.buildUpon()
            .appendQueryParameter("path", path)
            .build()
    }
    return this
}

这个扩展函数将 Uri 对象转换为 content:/// URI。如果 Uri 对象的 scheme 为 "file"，则它将使用 MediaStore.Images.Media.EXTERNAL_CONTENT_URI 作为基础 URI，并添加一个 "path" 查询参数来指定文件路径。如果 Uri 对象的 scheme 不是 "file"，则它将直接返回原 Uri 对象。

使用示例

在实际应用中，我们可以使用 Kotlin 扩展来轻松转换 file:/// URI 类型的 Intent 数据，从而避免 FileUriExposedException 异常。

val intent = Intent(Intent.ACTION_SEND)
val uri = Uri.parse("file:///path/to/file.png")
intent.putExtra(Intent.EXTRA_STREAM, uri.toContentUri())
startActivity(intent)

在上面的示例中，我们使用 toContentUri() 扩展函数将 file:/// URI 转换为 content:/// URI，然后将转换后的 URI 设置为 Intent 的 EXTRA_STREAM 字段。这样，当 Intent 离开应用程序时，系统将检测到 content:/// URI，而不是 file:/// URI，从而避免触发 FileUriExposedException 异常。

优势

使用 Kotlin 扩展来解决 Android 版本适配中的 URI 曝光问题具有以下优势：

• 简洁优雅： 扩展函数语法简洁，无需修改源代码，便可添加新功能。
• 代码复用： 扩展函数可以被多个类复用，提高代码的可维护性和可读性。
• 避免异常： 将 file:/// URI 转换为 content:/// URI 可以有效避免 FileUriExposedException 异常，确保应用程序稳定运行。
• 兼容性高： Kotlin 扩展与 Android 系统高度兼容，在各个 Android 版本上都能正常使用。

总结

通过使用 Kotlin 扩展，开发者可以轻松解决 Android 版本适配中 URI 曝光带来的问题。这种方法不仅简洁优雅，而且兼容性高，有效避免了 FileUriExposedException 异常的发生，保障了应用程序的稳定运行。希望本文能够帮助开发者在 Android 版本适配中游刃有余，为用户提供无缝顺畅的体验。