【亲测免费】 poi-on-android 项目技术文档

poi-on-android 项目技术文档

1. 安装指南

1.1 系统要求

• 最低支持的Android版本为Android 8.0（API级别26）。
• 需要Java SDK，推荐使用Java 8。
• 需要Android SDK，可以通过Android Studio或单独下载安装。

1.2 获取代码

首先，通过Git克隆项目代码：

git clone https://github.com/centic9/poi-on-android.git
cd poi-on-android

1.3 配置Android SDK路径

在项目根目录下创建local.properties文件，并设置Android SDK的路径：

echo "sdk.dir=/opt/android-sdk-linux" > local.properties

1.4 配置Android Build Tools版本

编辑poitest/build.gradle文件，配置你已安装的Android Build Tools版本。

1.5 构建项目

执行以下命令构建项目：

./gradlew shadowJar
./gradlew build connectedCheck

如果只需要生成jar文件，可以只运行build命令。

2. 项目的使用说明

2.1 启动应用前的系统属性设置

为了解决XML解析器的问题，需要在应用启动时手动设置以下系统属性：

System.setProperty("org.apache.poi.javax.xml.stream.XMLInputFactory", "com.fasterxml.aalto.stax.InputFactoryImpl");
System.setProperty("org.apache.poi.javax.xml.stream.XMLOutputFactory", "com.fasterxml.aalto.stax.OutputFactoryImpl");
System.setProperty("org.apache.poi.javax.xml.stream.XMLEventFactory", "com.fasterxml.aalto.stax.EventFactoryImpl");

2.2 使用预构建的jar文件

如果希望快速开始，可以使用项目发布页面提供的预构建jar文件。请注意，这些文件可能不是最新的。

2.3 自定义构建jar文件

如果需要最新的jar文件或希望自定义构建过程，可以按照上述步骤自行构建。

3. 项目API使用文档

3.1 主要API

项目主要使用Apache POI库来处理XLSX、PPTX和DOCX文件。具体API的使用可以参考MainActivity中的代码示例。

3.2 依赖项

部分Apache POI的依赖项未包含在阴影jar中，如果使用到这些依赖项，需要在Android应用中额外添加。

3.3 缺少的java.awt类

由于Android不提供java.awt包中的类，因此相关代码无法运行。项目中已经重新实现了部分类，如果需要更多类，可以自行添加。

4. 项目安装方式

4.1 使用Android模拟器

列出可用的模拟器：

<android-sdk>/tools/emulator -list-avds

启动模拟器：

<android-sdk>/tools/emulator -avd <name>

安装APK：

<android-sdk>/platform-tools/adb install ./poitest/build/outputs/apk/poitest-debug.apk

4.2 使用真实设备

确保设备已连接，并执行相同的安装步骤。

5. 其他说明

• 项目包含两个子项目：poishadow用于生成阴影jar文件，poitest是一个示例Android应用。
• 项目仅在Android Studio和Android模拟器上进行了测试，但应该也适用于真实设备。
• 项目使用targetSdkVersion 26和minSdkVersion 26进行测试。

6. 待办事项

• 增加示例应用的实际功能。
• 解决Android上缺少的JDK部分，如AWT相关类。

欢迎提交PR以改进这些项目。