使用AndroidX PdfViewer加载Uri显示PDF遇‘未解析引用PDFView’错误

API 探路者

2026-6-15

解决PDFView未找到的问题

原因分析

出现Unresolved reference PDFView错误，核心原因是未正确导入PDFView类，或是依赖配置未同步、版本存在兼容性问题。

修复步骤

1. 确保依赖同步完成

点击Android Studio右上角的「Sync Project with Gradle Files」按钮，确认依赖已下载并生效。
若同步失败，可尝试清理缓存（路径：File → Invalidate Caches... → Invalidate and Restart）后重新同步。

2. 导入正确的PDFView类

在Composable文件顶部添加对应包的导入语句：

import androidx.pdfviewer.widget.PDFView

注意：androidx.pdfviewer库的PDFView类位于androidx.pdfviewer.widget包下，不要混淆导入第三方库的同名类。

3. 升级依赖到稳定版本

你使用的1.0.0-alpha04是早期测试版，存在兼容性风险，建议替换为最新稳定版（当前最新稳定版为2.1.0），修改应用级build.gradle的依赖配置：

dependencies {
    implementation("androidx.pdfviewer:pdfviewer:2.1.0")
}

修改完成后重新同步Gradle。

4. 完善PDF加载代码

补充错误监听逻辑，避免加载失败无提示，同时确保代码调用正确：

@Composable
fun PdfViewer(uri: Uri) {
    AndroidView(
        factory = { context ->
            PDFView(context).apply {
                fromUri(uri)
                    .defaultPage(0)
                    .onError { t ->
                        Toast.makeText(context, "PDF加载失败: ${t.message}", Toast.LENGTH_SHORT).show()
                    }
                    .load()
            }
        },
        modifier = Modifier.fillMaxSize()
    )
}