Jetpack Compose 如何打开内部缓存目录中存储的PDF文件

1. 核心问题根因 #

你遇到的跳转异常属于Jetpack Compose场景下Intent调用、FileProvider配置两个环节的常见问题，PDF生成正常说明编解码和文件写入逻辑没问题，只需要修改启动逻辑和配置项即可。 #

2. 具体修复步骤 #

2.1 补充Intent必要启动Flag #

非Activity类型的Context启动Activity时，必须新增FLAG_ACTIVITY_NEW_TASK标记，否则会触发启动异常，修改Intent配置部分代码：

val intent = Intent(Intent.ACTION_VIEW)
intent.setDataAndType(path, "application/pdf")
// 新增以下两个flag配置
intent.flags = Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_NEW_TASK
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)

2.2 确认FileProvider配置正确 #

检查AndroidManifest.xml中是否已经正确注册FileProvider：

<application>
    <!-- 其余application配置不变 -->
    <provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="${applicationId}.provider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>
</application>

再检查res/xml/file_paths.xml中是否包含缓存目录映射：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 必须配置该行，匹配内部缓存目录的访问权限 -->
    <cache-path name="internal_cache" path="." />
</paths>

2.3 优化Compose场景的Context调用 #

Compose中默认获取的LocalContext.current可能是ContextWrapper而非Activity实例，建议增加工具方法提取Activity实例再调用启动逻辑：

// 新增Context扩展方法提取Activity
fun Context.getActivity(): Activity? {
    var current = this
    while (current is ContextWrapper) {
        if (current is Activity) return current
        current = current.baseContext
    }
    return null
}

// Compose侧调用示例
val localContext = LocalContext.current
Button(onClick = {
    val activity = localContext.getActivity()
    activity?.let {
        decodeTestPdfString(你的PDFBase64字符串, it)
    }
}) {
    Text("打开PDF")
}

2.4 优化原有方法的空安全逻辑 #

你原有代码存在大量非空断言，容易引发空指针崩溃，优化后代码如下：

fun decodeTestPdfString(pdfString: String, context: Context) {
    var fos: FileOutputStream? = null
    try {
        val pdfFile = File(context.cacheDir, "testFile.pdf")
        if (!pdfFile.exists()) pdfFile.createNewFile()
        fos = FileOutputStream(pdfFile)
        val decodedString = Base64.decode(pdfString, Base64.DEFAULT)
        fos.write(decodedString)
        fos.flush()

        val path = FileProvider.getUriForFile(
            context,
            context.packageName + ".provider",
            pdfFile
        )
        val intent = Intent(Intent.ACTION_VIEW)
        intent.setDataAndType(path, "application/pdf")
        intent.flags = Intent.FLAG_ACTIVITY_CLEAR_TOP
        if (context !is Activity) intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
        intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
        context.startActivity(intent)
    } catch (e: Exception) {
        e.printStackTrace()
    } finally {
        runCatching { fos?.close() }
    }
}

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