Android 實現 PDF 文件閱讀功能調研

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

  • 微信公眾號:asce1885
  • 小密圈:Android高級進階,詳情見這篇文章
  • Github簡書微博CSDN 知乎
    本文由于潛在的商業目的,不開放全文轉載許可,謝謝!
honey_bear.png-585.4kB
honey_bear.png-585.4kB

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-v7ax86,還是會增加將近 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.jspdf.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]


  1. http://www.foxitsoftware.cn/products/sdk/PDFsdk/android/ ?

  2. https://plugpdf.com ?

  3. https://android.googlesource.com/platform/external/pdfium/ ?

  4. https://github.com/barteksc/PdfiumAndroid ?

  5. https://github.com/barteksc/AndroidPdfViewer ?

  6. http://mozilla.github.io/pdf.js/ ?

  7. http://coolwanglu.github.io/pdf2htmlEX/ ?

  8. http://www.csdn.net/article/2014-06-23/2820351-Why-Foxit-Open-Sourced-Core-PDF-technologies ?

  9. https://www.sitepoint.com/custom-pdf-rendering/ ?

  10. https://developer.tizen.org/community/tip-tech/displaying-pdf-files-pdf.js-library?langredirect=1 ?

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容

  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 173,460評論 25 708
  • afinalAfinal是一個android的ioc,orm框架 https://github.com/yangf...
    passiontim閱讀 15,568評論 2 45
  • 發現 關注 消息 iOS 第三方庫、插件、知名博客總結 作者大灰狼的小綿羊哥哥關注 2017.06.26 09:4...
    肇東周閱讀 12,251評論 4 61
  • 微風吹過樹林 抬頭看月,月蒼涼 為燥熱的夏天帶來涼爽 云隨風走,星子越發閃亮 瞧,那是家的方向 我走在路上, 愿晚...
    微笑的七閱讀 174評論 0 0
  • 那天晚上,X哥失戀了,我和狐貍陪他去吃烤串,喝啤酒。其實我心里也不舒坦,一場戀愛分分合合,還不如坦坦蕩蕩分了來得痛...
    空杯L閱讀 315評論 0 2