一、引言
在安卓開發中，讀取 Word 文檔（包括 .doc 和 .docx 格式）是一個常見需求。Apache POI 是一個強大的 Java 庫，專門用于處理 Microsoft Office 文件格式。本文將帶你了解如何在安卓端實現這一功能，輕松讀取你手中的 Word 文檔。
二、什么是 Apache POI？
Apache POI 是一個開源的 Java 庫，支持讀取和寫入多種 Microsoft Office 文件格式。它的名字“POI”寓意“Poor Obfuscation Implementation”（糟糕的混淆實現），暗示了其對 Microsoft 文件格式的逆向工程。適用于多種平臺，使得辦公文檔的處理變得簡單高效。
三、主要功能
-
支持多種文件格式：
-
Excel：
.xls（HSSF）和.xlsx（XSSF） -
Word：
.doc（HWPF）和.docx（XWPF） -
PowerPoint：
.ppt（HSLF）和.pptx（XSLF）
-
Excel：
跨平臺支持：作為 Java API，Apache POI 可以在任何支持 Java 的平臺上運行。
四、安卓端實現 Word 文檔的內容提取
4.1 讀取 .doc 文檔
對于 .doc 文件，我們需要使用 HWPF。首先，下載以下 jar 包：
將這些 jar 包放入 Android 項目的 libs 目錄，代碼示例如下：
try (InputStream is = new FileInputStream(file)) {
HWPFDocument doc = new HWPFDocument(is);
FileInfo fileInfo = FileInfo.fromFile(file);
fileInfo.content = doc.getDocumentText(); // 輸出文檔文本
listener.onComplete(null, fileInfo);
} catch (FileNotFoundException e) {
LogUtil.eError("poi", "文件不存在", e);
listener.onComplete(e, null);
} catch (IOException e) {
LogUtil.eError("poi", "文件讀取異常", e);
listener.onComplete(e, null);
}
4.2 讀取 .docx 文檔
對于 .docx 文件，我們需要使用 XWPF。下載以下 jar 包：
這樣引入會遇到錯誤：
POI : duplicate entry: org/apache/xmlbeans/xml/stream/BindingConfig.class
五、解決方案
因為 Java 的依賴包在 Android 環境下不太友好，我們需要尋找替代方案。推薦使用 poi-on-android，這是一個開源項目，提供了對 Apache POI 的 Android 適配。
移除之前的 POI 庫。
-
下載并引入 poishadow-all.jar（該包體積較大，包含了 POI 的大部分功能）。
引入后可能會遇到：
Cannot invoke "String.length()" because "<parameter1>" is null有關該問題的討論可參考 Stack Overflow。
5.1 解決方案 1
將 Android Gradle Plugin 升級到 8 以上，可以通過 Android Studio 自動升級：
- 路徑：
Tools -> AGP Upgrade Assistant
升級后可能需要處理的一些依賴庫的編譯錯誤，查看相關庫的 GitHub 頁面，根據提示進行適當的版本升級。
5.2 解決方案 2
如果不想折騰過多，可以直接下載較低版本的 poi-on-android，例如 0.7 版本，可以避免許多問題。
六、混淆設置
使用 poi-on-android 時，記得添加混淆規則，避免因混淆導致應用崩潰。更多規則可參考 混淆規則文檔。
七、總結
通過 Apache POI，我們可以在安卓應用中輕松實現讀取 Word 文檔的功能。雖然過程中可能會遇到一些問題，但只要耐心處理，就能將這些問題一一解決。趕緊試試吧，讓你的應用可以讀取文檔，不再局限于文本內容！
