Apache POI for Android 项目常见问题解决方案

Apache POI for Android 项目常见问题解决方案

poi-android 📈 Apache POI for Android 项目地址: https://gitcode.com/gh_mirrors/po/poi-android

项目基础介绍

Apache POI for Android 是一个用于在 Android 平台上使用 Apache POI 的简单库。Apache POI 是一个用于处理 Microsoft Office 文档（如 Excel、Word 和 PowerPoint）的 Java 库。该项目的主要目的是让开发者能够在 Android 应用中使用 Apache POI 的功能，从而处理 Excel 文件等任务。

该项目的主要编程语言是 Kotlin，但也支持 Java。

新手使用注意事项及解决方案

1. XSSFWorkbook 在 API < 21 设备上不工作

问题描述：XSSFWorkbook（用于处理 .xlsx 文件）在 Android API 级别低于 21（即 Android 5.0 Lollipop 之前）的设备上无法正常工作。

解决方案：

1. 检测设备 API 级别：在代码中检测设备的 API 级别。
2. 降级处理：如果设备 API 级别低于 21，则使用 HSSFWorkbook（用于处理 .xls 文件）。
3. 提示用户：在降级处理时，向用户显示一条错误消息，告知他们当前设备不支持 .xlsx 文件的处理。

val workbook = if (Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) {
    showToast("当前设备不支持 .xlsx 文件处理，已降级为 .xls 文件处理。")
    HSSFWorkbook()
} else {
    XSSFWorkbook()
}

2. 使用 ProGuard 时的配置问题

问题描述：在使用 ProGuard 进行代码混淆时，可能会遇到类或方法被移除或混淆的问题，导致运行时错误。

解决方案：

1. 添加 ProGuard 规则：在 proguard-rules.pro 文件中添加必要的规则，以确保 Apache POI 相关的类和方法不会被移除或混淆。
2. 依赖 ProGuard 模块：在项目的 build.gradle 文件中添加 ProGuard 模块的依赖。

implementation "com.github.SUPERCILEX:poi-android:proguard:$poiVersion"

3. 配置 ProGuard 规则：在 proguard-rules.pro 文件中添加以下规则：

-keep class org.apache.poi.** { *; }
-keepclassmembers class org.apache.poi.** { *; }

3. 更新 Apache POI 版本

问题描述：项目中使用的 Apache POI 版本可能不是最新的，需要更新到最新版本以获得新功能或修复已知问题。

解决方案：

1. Fork 项目：首先 Fork 该项目到自己的 GitHub 账户。
2. 修改依赖版本：在 build.gradle 文件中更新 Apache POI 的版本号。
3. 测试和提交：在本地测试更新后的项目，确保没有引入新的问题，然后提交更改并创建 Pull Request。

implementation "org.apache.poi:poi-ooxml:$newPoiVersion"

4. 更新依赖：将 SUPERCILEX 替换为你自己的 GitHub 用户名，以确保使用你 Fork 后的版本。

implementation "com.github.YourUsername:poi-android:poi:$newPoiVersion"

通过以上步骤，新手可以更好地理解和使用 Apache POI for Android 项目，并解决常见的问题。

poi-android 📈 Apache POI for Android 项目地址: https://gitcode.com/gh_mirrors/po/poi-android