PdfViewPager：Android 端的 PDF 显示控件

文章目录PdfViewPagerAndroid 端的 PDF 显示控件它做了什么性能和细节Kotlin 也能直接用一个现实问题谁适合用PdfViewPagerAndroid 端的 PDF 显示控件做 Android 应用的时候经常会撞上一个需求在页面里展示一份 PDF。听起来不复杂真上手做就会发现问题。Android 系统原生就没给一个直接能用的 PDF 视图控件要么自己画要么塞进 WebView 里硬撑。PdfViewPager 这个项目就是来解决这个麻烦的。当前 Star 数 1,715规模不算大但稳。它做了什么PdfViewPager 是一个 Android 控件把 PDF 文件渲染成一页一页可滑动的视图类似相册那样的 ViewPager 体验。底层用的是系统自带的 PdfRenderer 类所以有一个硬限制只能跑在 API 21 及以上的设备上。低于这个版本的手机不能用老项目接入前要确认下用户的机型分布。它支持三种 PDF 来源应用内置的 assets 目录SD 卡上的本地文件远程 URL 下载后显示三种场景基本覆盖了常见需求。我看过它的 sample 代码接法不绕。assets 路径下就是一行 new PDFViewPager(this, “sample.pdf”)或者直接在 XML 里写控件配一个 app:assetFileName 属性。SD 卡和远程 URL 稍微多几步主要是文件拷贝和下载回调的处理。性能和细节PDF 这种东西渲染起来吃内存。PdfViewPager 内部做了缩放和平移的支持捏合放大、双击缩放这些手势都自带。这点挺重要光能翻页不能放大用户体验会差一截。资源释放也考虑到了。PDFPagerAdapter 在 Activity 的 onDestroy 里要主动调 close()把 native 的 PdfRenderer 资源释放掉。不调的话会有内存泄漏长期使用或者多次打开 PDF 的场景下能看出来。文档里写得很明白跟着抄就行。远程 PDF 那部分的实现思路是先下载到本地再用本地的方式渲染。需要权限 INTERNET、READ_EXTERNAL_STORAGE、WRITE_EXTERNAL_STORAGE老 Android 版本要写Android 10 以上用 Scoped Storage 的话这部分得自己适配一下仓库里没特别说明接入的时候留意。Kotlin 也能直接用虽然这是个 Java 库Kotlin 项目里接入没有障碍。作者还专门给了一个 HelloKotlin 的样例分支代码在 Kotlin 里写更短一些。gradle 依赖照常加就行不需要额外配置。一个现实问题API 21 这条线现在是绕不开的。Android 5.0 以下机型在统计里占比已经很低但还有些老旧工业设备、车载设备、教育平板在上面跑。如果你的目标用户包含这类设备PdfViewPager 不适用得去找基于 PdfBox 或者 PDF.js 的方案。仓库里有一条 TODO 列着Support API Levels under 21, by downloading PDF and invoking system native intent作者有考虑这件事但一直没做完。看 commit 时间这个项目更新不快最近一两年基本是维护状态。新项目接入时心理预期要摆正。谁适合用如果你的 Android 应用需要在内部展示 PDF目标机型明确是 Android 5.0 以上又不想引入体积巨大的第三方 PDF 库PdfViewPager 是个挺合适的选择。代码量小依赖就一个接进去加起来几兆。Apache 2.0 协议商用也没问题。复杂场景就别指望它了。带表单、带签名、带动画的 PDF这个控件应付不来只能渲染纯页面。还有那种扫描版、几百兆的大 PDF渲染慢、内存吃紧的问题会很明显。这种需求建议直接上商业方案。整体看 PdfViewPager 是个定位清晰的小工具不贪多把在 ViewPager 里翻 PDF这件事做结实了。中小应用接入够用。工具不贪多把在 ViewPager 里翻 PDF这件事做结实了。中小应用接入够用。