Android开发实战：如何优雅调用系统工具打开文档

1次阅读

没有评论

共计 2974 个字符，预计需要花费 8 分钟才能阅读完成。

在 Android 开发过程中，调用系统工具打开文档是一个看似简单但实际暗藏玄机的功能。很多开发者可能会遇到这样的困扰：明明在测试机上运行良好的功能，到了用户手里就各种崩溃或不兼容。今天我们就来深入剖析这个问题，并提供一个健壮的解决方案。

直接使用简单 Intent 打开文档可能会遇到以下典型问题：

不同厂商 ROM 对文档处理程序的实现差异巨大，特别是国内定制 ROM
文件类型匹配失败导致无应用响应
Android 7.0 及以上版本的 FileProvider 配置不当引发 FileUriExposedException
缺少运行时权限检查导致安全异常
超大文件处理时内存溢出

Android 通过 Intent 的隐式调用机制来匹配最适合处理当前文档的应用。关键在于正确设置以下要素：

ACTION_VIEW：表示查看内容的通用动作
正确的 MIME 类型：系统据此筛选能处理该类型的应用
安全的文件 URI：通过 FileProvider 生成 content://URI

在 Android 7.0(Nougat) 之后，直接使用 file://URI 会抛出安全异常。必须通过 FileProvider 生成 content://URI。核心流程如下：

在 manifest 中声明 FileProvider
配置文件路径 xml
生成安全的 content URI
添加 URI 读取权限标志

现代 Android 需要处理两类权限：

运行时权限 (READ_EXTERNAL_STORAGE)
文件访问权限 (通过 FileProvider 授予临时权限)

下面是一个完整的 Kotlin 实现方案：

class DocumentOpener(private val context: Context) {

    // 主入口方法
    fun openDocument(file: File) {if (!file.exists()) {toast("文件不存在")
            return
        }

        checkPermissions {val uri = getFileUri(file)
            val intent = createViewIntent(uri, getMimeType(file))
            safelyStartActivity(intent)
        }
    }

    private fun checkPermissions(onGranted: () -> Unit) {if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            when {
                ContextCompat.checkSelfPermission(
                    context,
                    READ_EXTERNAL_STORAGE
                ) == PackageManager.PERMISSION_GRANTED -> onGranted()

                ActivityCompat.shouldShowRequestPermissionRationale(
                    context as Activity,
                    READ_EXTERNAL_STORAGE
                ) -> showPermissionRationale()

                else -> requestPermission()}
        } else {onGranted()
        }
    }

    @SuppressLint("QueryPermissionsNeeded")
    private fun safelyStartActivity(intent: Intent) {
        try {if (intent.resolveActivity(context.packageManager) != null) {context.startActivity(intent)
            } else {toast("未找到可以打开此文件的应用")
            }
        } catch (e: ActivityNotFoundException) {toast("打开文件失败")
        } catch (e: SecurityException) {toast("权限不足")
        }
    }

    private fun getFileUri(file: File): Uri {return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            FileProvider.getUriForFile(
                context,
                "${context.packageName}.fileprovider",
                file
            )
        } else {Uri.fromFile(file)
        }
    }

    private fun createViewIntent(uri: Uri, mimeType: String?): Intent {return Intent(Intent.ACTION_VIEW).apply {setDataAndType(uri, mimeType)
            addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)

            // 处理国产 ROM 的特殊情况
            if (Build.MANUFACTURER.equals("xiaomi", ignoreCase = true)) {putExtra("com.miui.extraphoto", true)
            }
        }
    }

    private fun getMimeType(file: File): String? {val extension = MimeTypeMap.getFileExtensionFromUrl(file.path)
        return MimeTypeMap.getSingleton().getMimeTypeFromExtension(extension)
    }

    // 其他辅助方法...
}