Android开发实战：如何高效调用系统工具打开文档（附避坑指南）

1次阅读

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

在 Android 应用开发中，经常需要调用系统工具来打开文档。这个看似简单的需求，却隐藏着不少新手容易踩的坑。今天我就来分享一个完整的解决方案，帮你避开这些陷阱。

想象一下这样的场景：你的应用下载了一个 PDF 文件，用户点击后希望能用他们喜欢的 PDF 阅读器打开。这时候就需要调用系统的文档打开功能。听起来很简单对吧？但实际上，不同 Android 版本、不同文件类型、不同设备厂商都会带来各种兼容性问题。

在开始编码前，我们先看看新手常遇到哪些问题：

文件路径问题 ：直接使用文件路径在 Android 7.0+ 会报 FileUriExposedException
MIME 类型错误 ：没有设置正确的 MIME 类型导致系统无法识别文件格式
权限缺失 ：忘记申请存储权限或申请时机不对
URI 解析错误 ：FileProvider 配置不当导致 URI 无法解析
没有安装对应应用 ：用户设备上没有能打开该文件类型的应用

下面我们就一步步来实现一个健壮的文档打开功能。

首先在 AndroidManifest.xml 中添加权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

由于 Android 7.0+ 禁止直接暴露 file://URI，我们需要使用 FileProvider。在 AndroidManifest.xml 中添加：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

然后创建 res/xml/file_paths.xml：

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <external-path name="external_files" path="." />
</paths>

在 Activity 中请求存储权限：

private fun checkAndRequestPermission() {
    if (ContextCompat.checkSelfPermission(this, 
            Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, 
            arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE), 
            REQUEST_CODE_STORAGE_PERMISSION)
    } else {openDocument()
    }
}

override fun onRequestPermissionsResult(requestCode: Int, 
                                       permissions: Array<String>, 
                                       grantResults: IntArray) {super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    if (requestCode == REQUEST_CODE_STORAGE_PERMISSION) {if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {openDocument()
        } else {Toast.makeText(this, "需要存储权限才能打开文件", Toast.LENGTH_SHORT).show()}
    }
}

下面是核心的打开文档代码：

private fun openDocument() {val file = File(getExternalFilesDir(null), "example.pdf")
    if (!file.exists()) {Toast.makeText(this, "文件不存在", Toast.LENGTH_SHORT).show()
        return
    }

    try {
        // 获取文件的 URI
        val uri = FileProvider.getUriForFile(
            this, 
            "${packageName}.fileprovider", 
            file
        )

        // 创建 Intent
        val intent = Intent(Intent.ACTION_VIEW).apply {setDataAndType(uri, getMimeType(file))
            addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
            addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
        }

        // 检查是否有应用可以处理这个 Intent
        if (intent.resolveActivity(packageManager) != null) {startActivity(intent)
        } else {Toast.makeText(this, "没有找到可以打开该文件的应用", Toast.LENGTH_SHORT).show()}
    } catch (e: ActivityNotFoundException) {Toast.makeText(this, "打开文件失败: ${e.message}", Toast.LENGTH_SHORT).show()} catch (e: Exception) {Toast.makeText(this, "发生错误: ${e.message}", Toast.LENGTH_SHORT).show()}
}

private fun getMimeType(file: File): String {return when (file.extension.toLowerCase()) {
        "pdf" -> "application/pdf"
        "doc", "docx" -> "application/msword"
        "xls", "xlsx" -> "application/vnd.ms-excel"
        "ppt", "pptx" -> "application/vnd.ms-powerpoint"
        "txt" -> "text/plain"
        "jpg", "jpeg" -> "image/jpeg"
        "png" -> "image/png"
        "gif" -> "image/gif"
        else -> "*/*"
    }
}