前言
最近需要实现一个 pdf 的阅读器，抱着很简单的心态就开始了调研，结果发现 Android 对 pdf 的展示只有 PdfRenderer 相关的类可以用，原理还是把 pdf 每一页转成图片来展示！并不能实现文字的复制粘贴等功能。要想有复杂功能的话需要接入第三方的库，怎么也要 10MB了 😢，基于此，就用第一种方案进行了开发。
把主要代码贴出来，供大家参考。
效果图
实现方案
整体是用一个RecyclerView 来实现的，每一页是一个 Bitmap 的图片，支持展示文件中的 pdf 。
PDF 转换器：
怕你直接贴代码跑不起来，提前说好：
- PDFManager 这个类，建议每个 ViewHolder 持有一个实例对象，避免创建太多实例对象。
- 其中的方法都要在子线程中调用，我是用 rxjava 切换的线程，你可以选择你项目里通用的方式
class PDFManager {
var renderer: PdfRenderer? = null
var page: PdfRenderer.Page? = null
/**
* 获取总页数，需要在子线程中请求，会耗时大概 200 ms
*/
@kotlin.jvm.Throws(Exception::class, IllegalStateException::class)
@Synchronized // 一定要加 Synchronized，PdfRenderer 底层不支持多线程调用！
fun getPageCount(pdfFile: File?): Int {
check(pdfFile != null && pdfFile.exists()) { "PDF File Does Not Exist" }
var pageCount: Int = 0
try {
var renderer = PdfRenderer(ParcelFileDescriptor.open(pdfFile, ParcelFileDescriptor.MODE_READ_ONLY))
pageCount = renderer.pageCount
} catch (ex: Exception) {
throw ex
} finally {
renderer?.close()
}
return pageCount
}
/**
* pdf 的第 {pageIndex} 页，转成一个 bitmap
*
* @param pdfFile pdf file
* @param pageIndex the index of the page
* @return bitmap
* @throws Exception
*/
@kotlin.jvm.Throws(Exception::class, IllegalStateException::class)
@Synchronized
fun pdfToBitmap(pdfFile: File?, pageIndex: Int, targetWidth: Int): Bitmap? {
check(pdfFile != null && pdfFile.exists()) { "PDF File Does Not Exist" }
var pBitmap: Bitmap? = null
try {
renderer = PdfRenderer(ParcelFileDescriptor.open(pdfFile, ParcelFileDescriptor.MODE_READ_ONLY))
page = renderer?.openPage(pageIndex)
val width = targetWidth
val height = width * (page?.height ?: 1) / (page?.width ?: 1)
pBitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888)
page?.render(pBitmap!!, null, null, PdfRenderer.Page.RENDER_MODE_FOR_DISPLAY)
} catch (ex: Exception) {
throw ex
} finally {
page?.close()
renderer?.close()
}
return pBitmap
}
}
然后就是 ViewHolder 里进行调用这些代码了，代码如下：
class PdfItemViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView), View.OnAttachStateChangeListener {
val imageView = itemView.pdf_item_view
lateinit var pdfPath: String // pdf 文件位置
var disposable: Disposable? = null
var bitmap: Bitmap? = null
val pdfManager: PDFManager = PDFManager()
init {
itemView.addOnAttachStateChangeListener(this)
}
fun setData(pdfPath: String) {
this.pdfPath = pdfPath
}
//1.view 展示时开始加载 bitmap
override fun onViewAttachedToWindow(v: View?) {
loadBitmap()
}
//2.view 隐藏时停止加载 bitmap
override fun onViewDetachedFromWindow(v: View?) {
RxSafeDispose.safeDispose(disposable)
imageView.setImageBitmap(null) //3.必须写的！不然 imageView 会报错 "bitmap is recycled"
bitmap?.recycle() // 回收 bitmap， 释放内存
bitmap = null
}
private fun loadBitmap() {
val uri = Uri.parse(pdfPath)
val file = File(uri.path)
Observable.create<Bitmap> {
try {
bitmap = pdfManager.pdfToBitmap(file, adapterPosition, pageWidth)
if (bitmap != null) {
it.onNext(bitmap!!)
} else {
it.onError(Throwable("pdf 页面转换失败: file: ${pdfPath}, pageIndex: $adapterPosition"))
}
} catch (e: Exception) {
it.onError(Throwable("pdf 页面转换失败: ${e.message}"))
}
}
.subscribeOn(Schedulers.io()) //4.io 线程里转换 bitmap 图片
.observeOn(AndroidSchedulers.mainThread())
.subscribe({
imageView.setImageBitmap(it)
}, {
Log.e("pdf", "pdf 页面转换失败: ${it.message}")
})
.apply {
disposable = this
}
}
}
核心代码就在这了， 至于要实现 pdf 的放大缩小也是可以做的，自己在 RecyclerView 外面套一层，对 RecyclerView 整体进行缩放就可以了。
RecyclerView 会在快速滑动时创建大量的 bitmap，对内存来说明显是压力很大的，所以可以在 view 层进行处理一下，滑动时不去调用 loadBitmap，比较简单就不上代码了。
一些思考
方案如上，下面是我开发过程中的一些思考。
上面的方案不是一下子想出来的，刚开始会考虑做 Bitmap 的 LruCache ，但是缓存的目的是什么呢，一是加快第二次加载的速度，二是网络请求中的话可以节省流量。但是我打印出每张图的转换时间最多 200ms，这也可以接受，而且 bitmap 的创建也不用流量，只是消耗一些 cpu 资源。缓存的话内存里也会放一下不太使用的bitmap，相对来说内存压力最大。所以直接放弃了 LruCache。
然后是 bitmap 对象要不要做个复用的池子呢？因为网上确实有很多 bitmap 复用的方案，比如
针对 bitmap 还会有采样率和压缩等优化，我也是跃跃欲试想用，但是，但是，PdfRenderer 并不支持啊，PdfRenderer.Page 的方法只有 page.render(pBitmap, null, null, PdfRenderer.Page.RENDER_MODE_FOR_DISPLAY) 这一种，只能传一个 bitmap 对象进入，但是压缩等技术都是 BitmapFactory 里才支持的，所以，也放弃。
还有是要仿照网络请求，一下转换 5 个 bitmap 出来，然后再一起更新数据呢，因为那样整体时间能降一些，但是那样就比较类似网络请求了，而本文的实现比较类似 ImageLoader，根据实际应用，还是每张图单独加载会好一些。
虽然没有很多代码，却要有很多思考，还要有足够的知识储备。
