作者簡介:ASCE1885, 《Android 高級進階》作者。

Android 系統天然不支持 PDF 文件的閱讀,因此,Android 應用中要實現 PDF 閱讀功能一般有以下方案:
- WebView 中調用 GoogleDocs
- 調起第三方支持 PDF 閱讀的應用
- 集成第三方 PDF SDK,在 Native 頁面中閱讀
- 集成第三方 JS PDF SDK,在 WebView 頁面中閱讀
- 將 PDF 文件轉換成 HTML 或者圖片等格式文件
WebView 中調用 GoogleDocs
這是最簡單的一種方式,利用 GoogleDocs 提供的能力,通過 Android 的 WebView 即可實現打開在線 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");
}
這種方案存在的問題是國內通常情況下訪問不了 Google 提供 的服務,因此這種方案可以不考慮。
調起第三方支持 PDF 閱讀的應用
可行方案中最簡單的一種方式,缺點是會跳出自己的應用轉到第三方應用中,而且需要具備以下兩個條件:
- PDF 文件需要下載到本地,不支持在線閱讀
- 用戶手機中安裝了支持 PDF 閱讀的應用
實現這個方案的代碼示例如下:
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 頁面中閱讀
第三方提供了很多免費或者付費的 PDF SDK,但在功能和性能等指標可能存在較大的區別,付費 SDK 的各項指標肯定是最優的。集成 Native SDK 的優點是體驗好,缺點是會顯著的增加包大小。目前可用的 SDK 主要有:
- Foxit 福昕 SDK[1]:國內老牌的付費 PDF SDK,功能強大,如果 PDF 閱讀功能在你的應用中比較常用但又不是核心功能,可以考慮接入它。
- PlugPDF[2]:國外的一款付費 PDF SDK,類似 Foxit SDK,具體區別可以下載 Demo 試用下。
- PDFium[3]:Google 和 Foxit 合作開源的 Foxit 的 PDF 源碼,作為 Chrome 瀏覽器的 PDF 渲染引擎組件,當然這是 C/C++ 實現的。
- PdfiumAndroid[4]:mshockwave 基于 PDFium 基礎上適配 Android 平臺的函數庫,barteksc 在這個基礎上再做了一些修改。
- AndroidPdfViewer[5]:barteksc 基于 PdfiumAndroid 基礎上實現的一個 PDF 閱讀 Demo,支持常見的手勢,縮放,雙擊等效果。
Native 方式的 PDF SDK 當然還有很多,但都存在一個共同的缺點,前面也說過,就是會顯著增加包大小,例如 AndroidPdfViewer 的引入,剔除不常用的處理器架構,只保留 armeabi-v7a
和 x86
,還是會增加將近 10M 的大小。
集成第三方 JS PDF SDK,在 WebView 頁面中閱讀
目前 Android 平臺上可用的第三方 JS PDF SDK 只有 mozilla 開源的 PDF.js
,有服務端和客戶端集成兩種方式可以實現在 WebView 中打開 PDF 文件。
服務端方式
PDF.js
[6] 提供了一套較完善的在 H5 頁面中閱讀 PDF 的方案,同時支持 Web 前端,Android 和 iOS WebView 加載。服務部署起來應該也比較簡單,大致的方案如下:
- 客戶端獲取到在線 PDF 的鏈接
- 將該鏈接作為參數,通過 WebView 向服務端的 PDF 服務發起請求
- PDF 服務將該鏈接的 PDF 文件下載到服務端緩存目錄,并調用
PDF.js
提供的能力將 PDF 渲染出來。
更具體的方案需要找服務端同學討論確定。官方提供的 Demo 如下,可以通過手機的瀏覽器訪問看效果:http://mozilla.github.io/pdf.js/web/viewer.html, 當然在國內訪問會有點慢。
客戶端方式
PDF.js
也支持客戶端集成方式,當然需要做的工作比服務端集成方式多,也會給客戶端起碼增加 1~2M 的體積。客戶端需要把官方提供的 pdf.js
和 pdf.worker.js
拷貝到工程的 assets
目錄,同時在客戶端本地實現一個離線 H5 頁面,該頁面通過上述兩個 js 文件實現 PDF 的閱讀。H5 頁面的交互和設計需要設計師給出來,同時可能需要前端同學實現。
將 PDF 文件轉換成 HTML 或者圖片等格式文件
這個方案是一位同事給出來的,一種可行的方案是將 PDF 文件通過 pdf2htmlEX
[7] 轉換成 HTML 格式文件,這樣就可以很方便的使用 WebView 進行加載。而且這種格式轉換很完美,幾乎和原來的 PDF 文件排版一致。這種方案當然也是通過服務端實現,在服務端將對應的 PDF 文件或者鏈接轉換成 HTML 格式的鏈接,然后客戶端 WebView 進行加載顯示即可。
總結
在上面給出的方案中,如果允許 PDF 閱讀跳出我們自己的應用,那么 調起第三方支持 PDF 閱讀的應用 這種方案是首選;如果需要自己實現 PDF 閱讀功能,那么需要根據具體業務需求來選擇,如果要求在線閱讀簡單的 PDF 文件,那么可選上述兩種服務端實現方案,如果要閱讀本地 PDF 文件,那么可優先選擇 PDF.js
的客戶端方式,畢竟增加的包大小在可接受的范圍,當然如果你的應用的主要功能就是閱讀功能,那么可能需要選擇用 Native 方式進行 PDF 的閱讀。
如果你有更好的方案,請留言讓大家知道噢!
拓展閱讀
《福昕熊雨前:PDFium開源項目的背后》[8]
《Custom PDF Rendering in JavaScript with Mozilla’s PDF.Js》[9]
《Displaying PDF files with PDF.js library》[10]