由于公司在项目中新增一个开发票的功能,而从第三方返回的数据(文档所在服务器地址,即一个url)来看,既有图片格式,也有PDF格式,因此需要在项目中实现查看PDF文档的功能。
从目前的实现方案来看,分别有以下几种:
一、先将远程服务器的pdf文档下载到本地,然后在本地中进行操作,但是考虑到这样做体验不大好,因此排除了;
二、使用第三方库的实现:https://github.com/barteksc/AndroidPdfViewer,但是使用该库,一下子项目会增大16MB左右,至于原因,文档中有解释,感兴趣的童鞋可以去看看;
三、使用webview的方式配合JS实现,目前网上成熟的方案Mozilla(火狐)的pdf.js,这种方式也可以浏览本地pdf文档。因此,这篇文章讲的就是怎么把这种方案集成到android项目中。
1、到Mozilla pdf.js的官网下载最新的稳定版本
2、解压下载后的压缩文件,将解压后的文件夹整份粘贴到项目中的asset文件夹下(记得解压后改成一个合法的名称)
3、在所要展示pdf文档的页面对web进行代码配置
WebSettings settings = pdfViewerWeb.getSettings();
settings.setSavePassword(false);
settings.setJavaScriptEnabled(true);
settings.setAllowFileAccessFromFileURLs(true);
settings.setAllowUniversalAccessFromFileURLs(true);
settings.setBuiltInZoomControls(true);
pdfViewerWeb.setWebViewClient(new WebViewClient() {
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
view.loadUrl(url);
return true;
}
});
pdfViewerWeb.setWebChromeClient(new WebChromeClient());
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {//api >= 19
pdfViewerWeb.loadUrl("file:///android_asset/pdfjs/web/viewer.html?file=" + docPath);
} else {
if (!TextUtils.isEmpty(docPath)) {
byte[] bytes = null;
try {// 获取以字符编码为utf-8的字符
bytes = docPath.getBytes("UTF-8");
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
if (bytes != null) {
docPath = new BASE64Encoder().encode(bytes);// BASE64转码
}
}
pdfViewerWeb.loadUrl("file:///android_asset/pdfjs_compatibility/web/viewer.html?file=" + docPath);
}
其中,pdfViewWeb是webview对象,docPath则是远程服务器上的pdf文档地址。
需要对上段代码说明的是,我在手机上试验了下,最新版本的pdf.js在android4.3以上显示都是正常的,在4.3的系统上(android4.3以下的系统我没测试)则无法正常显示,因此我做了兼容,android4.3及以下的系统都是用pdf.js v1.4.20的版本,添加过程也和最新版本(v1.9.426)一样,进一步说明的是,这样做以后,打出来的apk大小也增大了4MB多左右。