-
?前言
?? ??? ?最近项目上有一个需求，需要在Android端加载显示pdf文档，因为没有相关的经验，在刚接到需求的时候，第一想法就是打开程序员的第二大脑进行搜索，搜索结果还是蛮理想的，了解到了MuPDF，它支持多种文档格式，例如 PDF、XPS、OpenXPS、CBZ、EPUB 和 FictionBook 2。?
?? ??? ?我这里要记录的是 android-pdfview。PDFView是这个库中最核心的类，用于加载pdf文件，PDFView是的实现是继承于SurfaceView来实现的。主要用到了建造者模式来设置相关的属性。
? ? ? ? 另外还可以通过浏览器进行加载pdf等等。
-
效果图
-
?引用
android-pdfview的依赖为：? ? ? ?
compile 'com.joanzapata.pdfview:android-pdfview:1.0.4@aar'-
?权限
? ? ? ? 这里需要添加网络权限，将服务器上的pdf文档下载到本地保存。
<!-- 网络权限 -->
<uses-permission android:name="android.permission.INTERNET" />? ? ? ? 另外还需要添加文件读写的权限。
<!-- 写入外部存储权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- 读取外部存储权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />? ? ? ? 本文编辑时，对应的demo是在我们公司定制的开发板上边运行的，所有权限只需在manifest里边添加，无需手动申请权限，这里需要注意，自己进行文件读写权限的申请。
-
布局文件
? ? ? ? 布局文件就非常简单了，直接在activity对应的布局中，添加一个PDFView控件，宽高均设置为match_parent就可以了。
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context="cn.load.pdfview.LoadPdfViewActivity">
<com.joanzapata.pdfview.PDFView
android:id="@+id/loadPdfView"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</RelativeLayout>-
文档下载
? ? ? ? ?看到上边这个图片，顾名思义要开始撸代码了！！！
-
?View层
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_load_pdf_view) //找控件 loadPdfView = findViewById(R.id.loadPdfView) onLoadingView = findViewById(R.id.onLoadingView) //下载文档的Presenter mLoadFilePresenter = LoadFilePresenter() //绑定页面 mLoadFilePresenter?.attachView(this) //下载文档 mLoadFilePresenter?.downLoadFile("要加载的文档对应的服务器链接地址。") }在页面onCreate完成之后，将服务器上的pdf文档进行下载至本地。
-
Presenter层
override fun downLoadFile(fileUrl: String) { //提示正在加载文档 view?.downLoadingFile() //创建下载完成的回调 val mLoadFileModel: DloadFileInterface.LoadFileModelInterface = LoadFileModel() //开始下载pdf文档 mLoadFileModel.downLoadFile(object : DownLoadFileListener { //是否下载成功的监听 override fun onDownLoadListen(isSuccessFlag: Boolean, filePath: String) { if (isAvailable()!!)//判断view是都可见 view?.downLoadFileComplete(isSuccessFlag, filePath)//告诉view层，文档已经下载完了 } }, fileUrl) } -
Model层
//开始下载文档 override fun downLoadFile(mDownLoadFileListener: DloadFileInterface.DownLoadFileListener, fileUrl: String) { val mDownLoadFileUtils = DownLoadFileUtils( "training_plan.pdf",//下载文档完成后本地存储文档的名称 fileUrl,//服务器上文档的url object : DownLoadFileUtils.DownLoadCompleteListener {//下载完成的回调 override fun onDownLoadCompleteListener(isSuccessFlag: Boolean, filePath: String?) { if (filePath != null)//判空处理 mDownLoadFileListener.onDownLoadListen(isSuccessFlag, filePath) } } ) //这里要在子线程进行文档的下载 val scheduledExecutorService = Executors.newSingleThreadScheduledExecutor() scheduledExecutorService.execute(mDownLoadFileUtils) }
? ? ? ? 因为下载文档这地方，既有文件存储又有网络加载的过程，为了避免ANR，所有要在子线程中进行。?
-
加载文档
fun loadPdfFile2Show(filePath: String) {
//判断当前页面是否已经销毁
if (!isAvailable())
return
val file = File(filePath)
if (!file.exists() || !file.isFile) {
toastMessage("文件不存在或文件已损坏！")
return
}
loadPdfView?.fromFile(file)
?.defaultPage(1)//默认加载文档的第defaultPage页 默认设置为第一页
?.showMinimap(false)//pdf放大的时候，是否在右上角生成引导图 默认设置为不生成
?.enableSwipe(true)//是否允许翻页，默认为允许翻页
?.onDraw(object : OnDrawListener {
//正在绘制图像的监听
override fun onLayerDrawn(canvas: Canvas?, pageWidth: Float, pageHeight: Float, displayedPage: Int) {
LogUtils.d(TAG, "onLayerDrawn====")
}
})
?.onLoad(object : OnLoadCompleteListener {
//加载完成的监听
override fun loadComplete(nbPages: Int) {
LogUtils.d(TAG, "loadComplete====")
}
})
?.onPageChange(object : OnPageChangeListener {
//翻页的监听
override fun onPageChanged(page: Int, pageCount: Int) {
LogUtils.d(TAG, "onPageChanged===")
}
})
?.load()
}????????在加载对应的pdf文档之前一定要进行判断，文档是否存在，否则你要加载的文档不存在的话，应用会直接crash掉。
if (!file.exists() || !file.isFile) {
toastMessage("文件不存在或文件已损坏！")
return
}-
总结
?????????android-pdfview使用起来还是比较简单的，而且功能比较强大，如果有兴趣或者有更高层次的需求可以研究一下，本人现在只局限于加载并显示文档这里，后边会进行深层次的学习后进行相关分享。
-
结束
? ? ? ? 最后附上demo下载地址！
????????传送门！
