Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rh-id/a-poi-spreadsheet
Unofficial Apache POI XSSF adaptation for Android
https://github.com/rh-id/a-poi-spreadsheet
Last synced: 8 days ago
JSON representation
Unofficial Apache POI XSSF adaptation for Android
- Host: GitHub
- URL: https://github.com/rh-id/a-poi-spreadsheet
- Owner: rh-id
- License: apache-2.0
- Created: 2024-02-23T05:34:24.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2024-03-10T11:09:41.000Z (9 months ago)
- Last Synced: 2024-03-10T12:26:57.595Z (8 months ago)
- Language: Java
- Size: 29.9 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# a-poi-spreadsheet
This is android library project that copied,import, and adapted from Apache POI.
The latest commit since: https://github.com/apache/poi/commit/6a8994ee0e6c59aa231570307a5dd213784993c3
From that point, XSSF module was cut off and adapted to this library
POI license notice is in `poi_legal`
NOTE: This is not official library or project from Apache POI team.
## Changes Adapted
1. XSSF Module (`.xlsx` spreadsheet file) and its dependency are copied and moved to poi modules here with new workspaces
2. Apache Log4J will be replaced by android Log classes
3. Add extra classes at base module for compatibility
4. Quiet a number of files modified and adapted for Android including Test files for Android Instrumented Test
5. Some portion of the functionalities are not really migrated yet (see `FIXME` comments)
## Using this library
`minSdk` is 26 (due to required Java 8 Compatibility).
This project support jitpack, in order to use this, you need to add jitpack to your project root build.gradle:
```
allprojects {
repositories {
google()
mavenCentral()
maven { url "https://jitpack.io" }
}
}
```
Include this to your module dependency (module build.gradle)
```
dependencies {
implementation 'com.github.rh-id.a-poi-spreadsheet:a-poi-spreadsheet:v0.0.1'
implementation "com.github.rh-id.a-poi-spreadsheet:a-poi-spreadsheet-base:v0.0.1"
implementation "com.github.rh-id.a-poi-spreadsheet:a-poi-spreadsheet-ooxml:v0.0.1"
}
```
Set application context during `Application.onCreate` or before using it to poi spreadsheet context: `POISpreadsheetContext.getInstance().setAppContext(Context)`
`POISpreadsheetContext` is not from original Apache POI, it was used to bridge Android context and Apache POI execution.
`POISpreadsheetContext` implements `ExecutorService` in hope that you will use this context to execute any of the Apache POI operation.
## Proguard Configuration
```
-dontwarn org.apache.**
-dontwarn org.openxmlformats.schemas.**
-dontwarn org.etsi.**
-dontwarn org.w3.**
-dontwarn com.microsoft.schemas.**
-dontwarn com.graphbuilder.**
-dontwarn aQute.bnd.annotation.spi.ServiceProvider
-dontnote org.apache.**
-dontnote org.openxmlformats.schemas.**
-dontnote org.etsi.**
-dontnote org.w3.**
-dontnote com.microsoft.schemas.**
-dontnote com.graphbuilder.**
-keeppackagenames org.apache.poi.ss.formula.function
-keep class org.apache.logging.** { *; }
-keep class org.apache.commons.** { *; }
-keep class org.apache.xmlbeans.** { *; }
-keep class org.openxmlformats.schemas.** { *; }
-keep class com.microsoft.schemas.** { *; }
-keep class javax.xml.** { *; }
-keep class schemaorg_apache_xmlbeans.system.sF1327CCA741569E70F9CA8C9AF9B44B2.TypeSystemHolder { public final static *** typeSystem; }
```
## Licenses
Copyright 2024 Ruby Hartono
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.