【亲测免费】 PDFView 安卓PDF查看器使用教程

1、项目介绍

PDFView 是一个安卓平台的 PDF 查看器，支持滑动、缩放、三级缓存、放大展示高清图、支持一些功能配置。该项目使用自定义 View 实现，能够有效地避免 OOM（Out of Memory）问题，并且支持从本地或网络打开 PDF 文件。此外，PDFView 还支持为文档添加水印，使用系统自带的 PdfRenderer 来处理 PDF 原始文件渲染，最低支持安卓 5.0。

2、项目快速启动

2.1 依赖引入

在项目的 build.gradle 文件中添加以下依赖：

implementation 'com.wdeo3601:pdf-view:1.0.4'

2.2 布局文件

在布局文件中添加 PDFView 控件：

<com.wdeo3601.pdfview.PDFView
    android:id="@+id/pdf_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

2.3 代码实现

在 Activity 或 Fragment 中使用 PDFView：

// 获取 PDFView 实例
PDFView pdfView = findViewById(R.id.pdf_view);

// 设置当前显示页的前后缓存个数
pdfView.setOffscreenPageLimit(2);

// 是否支持缩放
pdfView.isCanZoom(true);

// 设置最大缩放倍数，最大支持20倍
pdfView.setMaxScale(10f);

// 添加水印
pdfView.setWatermark(R.drawable.ic_default_watermark);

// 设置当前页变化的回调监听
pdfView.setOnPageChangedListener(new PDFView.OnPageChangedListener() {
    @Override
    public void onPageChanged(int currentPageIndex, int totalPageCount) {
        // 显示当前页码
    }
});

// 从本地文件打开 PDF
pdfView.showPdfFromPath(filePath);

// 从网络打开 PDF
// pdfView.showPdfFromUrl("https://github.com/wdeo3601/PDFView/raw/master/sample.pdf");

3、应用案例和最佳实践

3.1 应用案例

PDFView 可以广泛应用于需要展示 PDF 文件的安卓应用中，例如：

• 电子书阅读器：用户可以下载或在线阅读 PDF 格式的电子书。
• 文档管理系统：用户可以查看和管理存储在设备或云端的 PDF 文档。
• 教育应用：教师可以上传 PDF 格式的课件，学生可以在线查看。

3.2 最佳实践

• 优化缓存：通过设置 setOffscreenPageLimit 方法，合理设置预加载页数，避免 OOM 问题。
• 水印保护：在需要保护版权的场景中，使用 setWatermark 方法为 PDF 文档添加水印。
• 网络加载优化：在从网络加载 PDF 文件时，建议使用异步加载和缓存机制，提升用户体验。

4、典型生态项目

PDFView 作为一个独立的 PDF 查看器组件，可以与其他安卓开发工具和库结合使用，例如：

• Glide：用于加载和缓存网络图片，可以与 PDFView 结合使用，优化网络 PDF 文件的加载速度。
• OkHttp：用于网络请求，可以与 PDFView 结合使用，实现从网络加载 PDF 文件的功能。
• Room：用于本地数据库存储，可以与 PDFView 结合使用，实现本地 PDF 文件的管理和查询。

通过这些生态项目的结合，可以进一步提升 PDFView 的功能和性能，满足更多复杂场景的需求。