作者簡(jiǎn)介：ASCE1885， 《Android 高級(jí)進(jìn)階》作者。
- 微信公眾號(hào)：asce1885
- 小密圈：Android高級(jí)進(jìn)階，詳情見(jiàn)這篇文章。
-
Github，簡(jiǎn)書，微博，CSDN 知乎
本文由于潛在的商業(yè)目的，不開(kāi)放全文轉(zhuǎn)載許可，謝謝！
Android 系統(tǒng)天然不支持 PDF 文件的閱讀，因此，Android 應(yīng)用中要實(shí)現(xiàn) PDF 閱讀功能一般有以下方案：
- WebView 中調(diào)用 GoogleDocs
- 調(diào)起第三方支持 PDF 閱讀的應(yīng)用
- 集成第三方 PDF SDK，在 Native 頁(yè)面中閱讀
- 集成第三方 JS PDF SDK，在 WebView 頁(yè)面中閱讀
- 將 PDF 文件轉(zhuǎn)換成 HTML 或者圖片等格式文件
WebView 中調(diào)用 GoogleDocs
這是最簡(jiǎn)單的一種方式，利用 GoogleDocs 提供的能力，通過(guò) Android 的 WebView 即可實(shí)現(xiàn)打開(kāi)在線 PDF 文檔，代碼如下所示：
public void setDocumentPath(final String path) {
WebView webView = (WebView) findViewById(R.id.webview);
webView.getSettings().setJavaScriptEnabled(true);
webView.getSettings().setPluginsEnabled(true);
webView.loadUrl("https://docs.google.com/viewer?url=http://www.asce1885.com/cms/wwwroot/ng/downLoad/011615200732.pdf");
}
這種方案存在的問(wèn)題是國(guó)內(nèi)通常情況下訪問(wèn)不了 Google 提供 的服務(wù)，因此這種方案可以不考慮。
調(diào)起第三方支持 PDF 閱讀的應(yīng)用
可行方案中最簡(jiǎn)單的一種方式，缺點(diǎn)是會(huì)跳出自己的應(yīng)用轉(zhuǎn)到第三方應(yīng)用中，而且需要具備以下兩個(gè)條件：
- PDF 文件需要下載到本地，不支持在線閱讀
- 用戶手機(jī)中安裝了支持 PDF 閱讀的應(yīng)用
實(shí)現(xiàn)這個(gè)方案的代碼示例如下：
public Intent getPdfFileIntent(File file) {
Intent intent = new Intent("android.intent.action.VIEW");
intent.addCategory("android.intent.category.DEFAULT");
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
Uri uri = Uri.fromFile(file);
intent.setDataAndType(uri, "application/pdf");
return Intent.createChooser(intent, "Open File");
}
集成第三方 PDF SDK，在 Native 頁(yè)面中閱讀
第三方提供了很多免費(fèi)或者付費(fèi)的 PDF SDK，但在功能和性能等指標(biāo)可能存在較大的區(qū)別，付費(fèi) SDK 的各項(xiàng)指標(biāo)肯定是最優(yōu)的。集成 Native SDK 的優(yōu)點(diǎn)是體驗(yàn)好，缺點(diǎn)是會(huì)顯著的增加包大小。目前可用的 SDK 主要有：
- Foxit 福昕 SDK[1]：國(guó)內(nèi)老牌的付費(fèi) PDF SDK，功能強(qiáng)大，如果 PDF 閱讀功能在你的應(yīng)用中比較常用但又不是核心功能，可以考慮接入它。
- PlugPDF[2]：國(guó)外的一款付費(fèi) PDF SDK，類似 Foxit SDK，具體區(qū)別可以下載 Demo 試用下。
- PDFium[3]：Google 和 Foxit 合作開(kāi)源的 Foxit 的 PDF 源碼，作為 Chrome 瀏覽器的 PDF 渲染引擎組件，當(dāng)然這是 C/C++ 實(shí)現(xiàn)的。
- PdfiumAndroid[4]：mshockwave 基于 PDFium 基礎(chǔ)上適配 Android 平臺(tái)的函數(shù)庫(kù)，barteksc 在這個(gè)基礎(chǔ)上再做了一些修改。
- AndroidPdfViewer[5]：barteksc 基于 PdfiumAndroid 基礎(chǔ)上實(shí)現(xiàn)的一個(gè) PDF 閱讀 Demo，支持常見(jiàn)的手勢(shì)，縮放，雙擊等效果。
Native 方式的 PDF SDK 當(dāng)然還有很多，但都存在一個(gè)共同的缺點(diǎn)，前面也說(shuō)過(guò)，就是會(huì)顯著增加包大小，例如 AndroidPdfViewer 的引入，剔除不常用的處理器架構(gòu)，只保留 armeabi-v7a 和 x86，還是會(huì)增加將近 10M 的大小。
集成第三方 JS PDF SDK，在 WebView 頁(yè)面中閱讀
目前 Android 平臺(tái)上可用的第三方 JS PDF SDK 只有 mozilla 開(kāi)源的 PDF.js，有服務(wù)端和客戶端集成兩種方式可以實(shí)現(xiàn)在 WebView 中打開(kāi) PDF 文件。
服務(wù)端方式
PDF.js[6] 提供了一套較完善的在 H5 頁(yè)面中閱讀 PDF 的方案，同時(shí)支持 Web 前端，Android 和 iOS WebView 加載。服務(wù)部署起來(lái)應(yīng)該也比較簡(jiǎn)單，大致的方案如下：
- 客戶端獲取到在線 PDF 的鏈接
- 將該鏈接作為參數(shù)，通過(guò) WebView 向服務(wù)端的 PDF 服務(wù)發(fā)起請(qǐng)求
- PDF 服務(wù)將該鏈接的 PDF 文件下載到服務(wù)端緩存目錄，并調(diào)用
PDF.js提供的能力將 PDF 渲染出來(lái)。
更具體的方案需要找服務(wù)端同學(xué)討論確定。官方提供的 Demo 如下，可以通過(guò)手機(jī)的瀏覽器訪問(wèn)看效果：http://mozilla.github.io/pdf.js/web/viewer.html， 當(dāng)然在國(guó)內(nèi)訪問(wèn)會(huì)有點(diǎn)慢。
客戶端方式
PDF.js 也支持客戶端集成方式，當(dāng)然需要做的工作比服務(wù)端集成方式多，也會(huì)給客戶端起碼增加 1～2M 的體積。客戶端需要把官方提供的 pdf.js 和 pdf.worker.js 拷貝到工程的 assets 目錄，同時(shí)在客戶端本地實(shí)現(xiàn)一個(gè)離線 H5 頁(yè)面，該頁(yè)面通過(guò)上述兩個(gè) js 文件實(shí)現(xiàn) PDF 的閱讀。H5 頁(yè)面的交互和設(shè)計(jì)需要設(shè)計(jì)師給出來(lái)，同時(shí)可能需要前端同學(xué)實(shí)現(xiàn)。
將 PDF 文件轉(zhuǎn)換成 HTML 或者圖片等格式文件
這個(gè)方案是一位同事給出來(lái)的，一種可行的方案是將 PDF 文件通過(guò) pdf2htmlEX[7] 轉(zhuǎn)換成 HTML 格式文件，這樣就可以很方便的使用 WebView 進(jìn)行加載。而且這種格式轉(zhuǎn)換很完美，幾乎和原來(lái)的 PDF 文件排版一致。這種方案當(dāng)然也是通過(guò)服務(wù)端實(shí)現(xiàn)，在服務(wù)端將對(duì)應(yīng)的 PDF 文件或者鏈接轉(zhuǎn)換成 HTML 格式的鏈接，然后客戶端 WebView 進(jìn)行加載顯示即可。
總結(jié)
在上面給出的方案中，如果允許 PDF 閱讀跳出我們自己的應(yīng)用，那么 調(diào)起第三方支持 PDF 閱讀的應(yīng)用 這種方案是首選；如果需要自己實(shí)現(xiàn) PDF 閱讀功能，那么需要根據(jù)具體業(yè)務(wù)需求來(lái)選擇，如果要求在線閱讀簡(jiǎn)單的 PDF 文件，那么可選上述兩種服務(wù)端實(shí)現(xiàn)方案，如果要閱讀本地 PDF 文件，那么可優(yōu)先選擇 PDF.js 的客戶端方式，畢竟增加的包大小在可接受的范圍，當(dāng)然如果你的應(yīng)用的主要功能就是閱讀功能，那么可能需要選擇用 Native 方式進(jìn)行 PDF 的閱讀。
如果你有更好的方案，請(qǐng)留言讓大家知道噢！
拓展閱讀
《福昕熊雨前：PDFium開(kāi)源項(xiàng)目的背后》[8]
《Custom PDF Rendering in JavaScript with Mozilla’s PDF.Js》[9]
《Displaying PDF files with PDF.js library》[10]
