Android应用无需下载、不使用WebView显示PDF及AndroidPdfViewer异常解决

核心问题根因 #

AndroidPdfViewer原生仅支持本地File、Assets资源、字节数组、ParcelFileDescriptor类数据源，无内置网络请求能力，直接传入远程URL无法识别，自然不会显示内容。

前置依赖与配置校验 #

• 首先确认模块级build.gradle依赖配置正确，无版本冲突：

implementation 'com.github.barteksc:android-pdf-viewer:3.2.0-beta.1'

• 清单文件配置必要权限，如请求HTTP协议地址需额外适配Android 9+明文请求限制：

<uses-permission android:name="android.permission.INTERNET" />
<application
    ...
    android:networkSecurityConfig="@xml/network_security_config">

res/xml/network_security_config.xml配置示例：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true" />
</network-security-config>

无本地落地在线加载实现方案 #

通过OkHttp请求PDF输入流，结合管道实现内存中转，全程不会将PDF文件写入本地存储，核心逻辑如下（需在子线程执行网络相关操作，避免阻塞主线程）：

// 基于协程实现的示例代码
lifecycleScope.launch(Dispatchers.IO) {
    // 构建网络请求，如有鉴权需求可在Request中添加对应Header
    val pdfResponse = OkHttpClient().newCall(
        Request.Builder().url("替换为你的PDF远程地址").build()
    ).execute()
    if (!pdfResponse.isSuccessful) {
        withContext(Dispatchers.Main) {
            Toast.makeText(this@PdfDisplayActivity, "PDF资源请求失败", Toast.LENGTH_SHORT).show()
        }
        return@launch
    }
    // 创建管道实现内存流中转，无本地IO操作
    val pipe = ParcelFileDescriptor.createReliablePipe()
    // 异步将网络输入流写入管道写入端
    lifecycleScope.launch(Dispatchers.IO) {
        pdfResponse.body?.byteStream()?.use { inputStream ->
            ParcelFileDescriptor.AutoCloseOutputStream(pipe[1]).use { outputStream ->
                inputStream.copyTo(outputStream)
            }
        }
    }
    // 主线程调用AndroidPdfViewer加载管道读取端的流数据
    withContext(Dispatchers.Main) {
        pdfView.fromParcelFileDescriptor(pipe[0])
            .defaultPage(0)
            .enableSwipe(true)
            .onError {
                it.printStackTrace()
                Toast.makeText(this@PdfDisplayActivity, "PDF加载失败", Toast.LENGTH_SHORT).show()
            }
            .load()
    }
}

无显示问题排查清单 #

• 确认PDF资源可正常访问：通过浏览器直接访问PDF地址，确认无404、鉴权拦截、地址过期等问题。
• 确认PDF格式兼容：AndroidPdfViewer对1.7版本以上的PDF、加密PDF、带动态内容的特殊PDF支持有限，可先用标准公开测试PDF验证逻辑是否正常。
• 确认混淆配置正确：如开启了代码混淆，需在混淆规则文件中添加如下配置：

-keep class com.shockwave.** { *; }
-keep class com.github.barteksc.pdfviewer.** { *; }

• 大文件适配：如加载的PDF超过50M，建议添加分片加载逻辑，避免出现OOM导致加载中断。

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