作者簡介:ASCE1885菇民, 《Android 高級進階》作者。
- 微信公眾號:asce1885
- 小密圈:Android高級進階换薄,詳情見這篇文章玉雾。
-
Github翔试,簡書轻要,微博,CSDN 知乎
本文由于潛在的商業(yè)目的垦缅,不開放全文轉(zhuǎn)載許可冲泥,謝謝!

Android 系統(tǒng)天然不支持 PDF 文件的閱讀壁涎,因此凡恍,Android 應用中要實現(xiàn) PDF 閱讀功能一般有以下方案:
- WebView 中調(diào)用 GoogleDocs
- 調(diào)起第三方支持 PDF 閱讀的應用
- 集成第三方 PDF SDK,在 Native 頁面中閱讀
- 集成第三方 JS PDF SDK怔球,在 WebView 頁面中閱讀
- 將 PDF 文件轉(zhuǎn)換成 HTML 或者圖片等格式文件
WebView 中調(diào)用 GoogleDocs
這是最簡單的一種方式嚼酝,利用 GoogleDocs 提供的能力,通過 Android 的 WebView 即可實現(xiàn)打開在線 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");
}
這種方案存在的問題是國內(nèi)通常情況下訪問不了 Google 提供 的服務(wù)闽巩,因此這種方案可以不考慮。
調(diào)起第三方支持 PDF 閱讀的應用
可行方案中最簡單的一種方式担汤,缺點是會跳出自己的應用轉(zhuǎn)到第三方應用中涎跨,而且需要具備以下兩個條件:
- PDF 文件需要下載到本地,不支持在線閱讀
- 用戶手機中安裝了支持 PDF 閱讀的應用
實現(xiàn)這個方案的代碼示例如下:
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隅很,但在功能和性能等指標可能存在較大的區(qū)別,付費 SDK 的各項指標肯定是最優(yōu)的率碾。集成 Native SDK 的優(yōu)點是體驗好叔营,缺點是會顯著的增加包大小。目前可用的 SDK 主要有:
- Foxit 福昕 SDK[1]:國內(nèi)老牌的付費 PDF SDK所宰,功能強大审编,如果 PDF 閱讀功能在你的應用中比較常用但又不是核心功能,可以考慮接入它歧匈。
- PlugPDF[2]:國外的一款付費 PDF SDK垒酬,類似 Foxit SDK,具體區(qū)別可以下載 Demo 試用下。
- PDFium[3]:Google 和 Foxit 合作開源的 Foxit 的 PDF 源碼勘究,作為 Chrome 瀏覽器的 PDF 渲染引擎組件矮湘,當然這是 C/C++ 實現(xiàn)的。
- PdfiumAndroid[4]:mshockwave 基于 PDFium 基礎(chǔ)上適配 Android 平臺的函數(shù)庫口糕,barteksc 在這個基礎(chǔ)上再做了一些修改缅阳。
- AndroidPdfViewer[5]:barteksc 基于 PdfiumAndroid 基礎(chǔ)上實現(xiàn)的一個 PDF 閱讀 Demo,支持常見的手勢景描,縮放十办,雙擊等效果。
Native 方式的 PDF SDK 當然還有很多超棺,但都存在一個共同的缺點向族,前面也說過,就是會顯著增加包大小棠绘,例如 AndroidPdfViewer 的引入件相,剔除不常用的處理器架構(gòu),只保留 armeabi-v7a
和 x86
氧苍,還是會增加將近 10M 的大小夜矗。
集成第三方 JS PDF SDK,在 WebView 頁面中閱讀
目前 Android 平臺上可用的第三方 JS PDF SDK 只有 mozilla 開源的 PDF.js
让虐,有服務(wù)端和客戶端集成兩種方式可以實現(xiàn)在 WebView 中打開 PDF 文件紊撕。
服務(wù)端方式
PDF.js
[6] 提供了一套較完善的在 H5 頁面中閱讀 PDF 的方案,同時支持 Web 前端赡突,Android 和 iOS WebView 加載对扶。服務(wù)部署起來應該也比較簡單,大致的方案如下:
- 客戶端獲取到在線 PDF 的鏈接
- 將該鏈接作為參數(shù)麸俘,通過 WebView 向服務(wù)端的 PDF 服務(wù)發(fā)起請求
- PDF 服務(wù)將該鏈接的 PDF 文件下載到服務(wù)端緩存目錄辩稽,并調(diào)用
PDF.js
提供的能力將 PDF 渲染出來。
更具體的方案需要找服務(wù)端同學討論確定从媚。官方提供的 Demo 如下逞泄,可以通過手機的瀏覽器訪問看效果:http://mozilla.github.io/pdf.js/web/viewer.html, 當然在國內(nèi)訪問會有點慢拜效。
客戶端方式
PDF.js
也支持客戶端集成方式喷众,當然需要做的工作比服務(wù)端集成方式多,也會給客戶端起碼增加 1~2M 的體積紧憾〉角В客戶端需要把官方提供的 pdf.js
和 pdf.worker.js
拷貝到工程的 assets
目錄,同時在客戶端本地實現(xiàn)一個離線 H5 頁面赴穗,該頁面通過上述兩個 js 文件實現(xiàn) PDF 的閱讀憔四。H5 頁面的交互和設(shè)計需要設(shè)計師給出來膀息,同時可能需要前端同學實現(xiàn)。
將 PDF 文件轉(zhuǎn)換成 HTML 或者圖片等格式文件
這個方案是一位同事給出來的了赵,一種可行的方案是將 PDF 文件通過 pdf2htmlEX
[7] 轉(zhuǎn)換成 HTML 格式文件潜支,這樣就可以很方便的使用 WebView 進行加載。而且這種格式轉(zhuǎn)換很完美柿汛,幾乎和原來的 PDF 文件排版一致冗酿。這種方案當然也是通過服務(wù)端實現(xiàn),在服務(wù)端將對應的 PDF 文件或者鏈接轉(zhuǎn)換成 HTML 格式的鏈接络断,然后客戶端 WebView 進行加載顯示即可裁替。
總結(jié)
在上面給出的方案中,如果允許 PDF 閱讀跳出我們自己的應用貌笨,那么 調(diào)起第三方支持 PDF 閱讀的應用 這種方案是首選弱判;如果需要自己實現(xiàn) PDF 閱讀功能,那么需要根據(jù)具體業(yè)務(wù)需求來選擇躁绸,如果要求在線閱讀簡單的 PDF 文件裕循,那么可選上述兩種服務(wù)端實現(xiàn)方案臣嚣,如果要閱讀本地 PDF 文件净刮,那么可優(yōu)先選擇 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]