Android Java基于voghDev/PdfViewPager实现URL下载PDF并存入内部存储

核心逻辑说明 #

• 当前使用的RemotePDFViewPager类内置了远程PDF拉取能力，但拉取的文件仅作为临时缓存存放在应用公开缓存目录，既不属于应用私有内部存储，也不会被持久化保留，页面销毁后随时可能被系统清理，无法满足下载存储到内部存储的需求。
• 要完成目标需要拆分两个独立流程：第一，主动实现网络下载逻辑，将PDF文件持久化写入应用私有内部存储路径；第二，替换库的内置远程加载流程，直接从内部存储读取已下载的PDF完成预览，完全绕开库自带的临时缓存机制。

分步实操实现 #

1. 实现独立下载流程，存储到应用内部存储 #

• 选择应用的私有内部存储路径作为目标目录，也就是context.getFilesDir()下的专属子目录，该路径不需要申请任何存储权限，仅应用本身可以访问，完全符合存储要求。
• 使用系统原生网络请求能力实现下载，不需要额外引入第三方下载框架，核心代码参考：

// 初始化内部存储下的PDF专属保存目录
File pdfSaveDir = new File(context.getFilesDir(), "downloaded_pdf");
if (!pdfSaveDir.exists()) {
    pdfSaveDir.mkdirs();
}

// 下载任务必须在子线程执行，*禁止在主线程发起网络请求*
new Thread(() -> {
    HttpURLConnection pdfConnection = null;
    InputStream netInputStream = null;
    FileOutputStream fileOutputStream = null;
    try {
        URL targetUrl = new URL(待下载的PDF链接);
        pdfConnection = (HttpURLConnection) targetUrl.openConnection();
        pdfConnection.connect();
        // 校验网络请求状态，请求失败则直接终止流程
        if (pdfConnection.getResponseCode() != HttpURLConnection.HTTP_OK) {
            return;
        }
        netInputStream = pdfConnection.getInputStream();
        // 用链接的哈希值生成不重复的文件名，避免同名文件冲突
        String saveFileName = String.valueOf(待下载的PDF链接.hashCode()) + ".pdf";
        File saveFile = new File(pdfSaveDir, saveFileName);
        fileOutputStream = new FileOutputStream(saveFile);
        byte[] buffer = new byte[4096];
        int readLen;
        while ((readLen = netInputStream.read(buffer)) != -1) {
            fileOutputStream.write(buffer, 0, readLen);
        }
        fileOutputStream.flush();
        // 下载完成后切回主线程，触发PDF预览流程
        new Handler(Looper.getMainLooper()).post(() -> {
            loadLocalPdfToView(saveFile);
        });
    } catch (Exception e) {
        e.printStackTrace();
    } finally {
        // 手动释放所有资源，避免内存泄漏
        try {
            if (netInputStream != null) netInputStream.close();
            if (fileOutputStream != null) fileOutputStream.close();
            if (pdfConnection != null) pdfConnection.disconnect();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}).start();

2. 替换原有远程加载逻辑，从内部存储读取PDF预览 #

• 移除原来直接初始化RemotePDFViewPager的代码，换成库提供的本地PDF加载接口，直接读取内部存储中已经下载完成的文件完成预览，核心代码参考：

private void loadLocalPdfToView(File localPdfFile) {
    PDFViewPager pdfViewPager = findViewById(R.id.pdfViewPager);
    // 初始化本地文件加载源，传入内部存储的PDF文件对象
    LocalFileDescriptorPDVDocumentSource localSource = 
        new LocalFileDescriptorPDVDocumentSource(context, localPdfFile);
    pdfViewPager.setDocumentSource(localSource);
}

3. 流程优化补充 #

• 原有XML布局文件不需要做任何调整，已经配置的PDFViewPager组件id、尺寸参数都可以直接复用。
• 增加重复下载判断：每次触发加载前，先检查内部存储的downloaded_pdf目录下是否已经存在和当前URL对应的PDF文件，如果存在就直接加载，不需要重复发起网络请求，节省用户流量。
• 基础权限配置：记得在AndroidManifest文件中添加网络权限<uses-permission android:name="android.permission.INTERNET" />，如果PDF链接是http开头的明文地址，需要适配Android 9以上的网络明文配置规则，避免网络请求被系统拦截。

常见踩坑提示 #

• 不要把下载的PDF文件放到应用的外部缓存目录、公共共享存储目录，这类路径不属于应用私有内部存储，Android 10以上访问还需要申请额外的存储权限，和需求不匹配。
• 不要把库远程加载时生成的临时缓存文件当做持久化的下载文件，这类临时文件的生命周期和ViewPager组件绑定，没有长期保留的保障，随时可能被系统清理。

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