English README

SQLiteToExcel 库整合了 Apache POI 和一些基本的数据库操作，使得 SQLite 和 Excel 之间相互转换更加便捷。

从 v1.0.5 版本开始，不再支持 xlsx 格式，因为 poi ooxml 库和其他一些相关的依赖太大了，体积超过了 10MB，同时开发过程中也发现 poi 对于 Android 支持不够全面，放弃 xlsx 也是挺无奈的，个人觉得 xls 格式对于我们来说已经够用。

v1.0.8 版本开始支持自定义 SQL 查询导出了。

更新历史

Release Notes

如何使用

1. 添加 Gradle 依赖

implementation 'com.liyu.tools:sqlitetoexcel:1.0.10'

2. SQLite -> Excel demo

new SQLiteToExcel
                .Builder(this)
                .setDataBase(databasePath) //必须。 小提示：内部数据库可以通过 context.getDatabasePath("internal.db").getPath() 获取。
                .setTables(table1, table2) //可选, 如果不设置，则默认导出全部表。
                .setOutputPath(outoutPath) //可选, 如果不设置，默认输出路径为 app ExternalFilesDir。
                .setOutputFileName("test.xls") //可选, 如果不设置，输出的文件名为 xxx.db.xls。
                .setEncryptKey("1234567") //可选，可对导出的文件进行加密。
                .setProtectKey("9876543") //可选，可对导出的表格进行只读的保护。
                .start(ExportListener); // 或者使用 .start() 同步方法。

自定义 SQL 导出：

new SQLiteToExcel
                .Builder(this)
                .setDataBase(databasePath)
                .setSQL("select name as '名字', price as '价格' from user where name like '%小鱼%'")
                .start(ExportListener);

3. Excel -> SQLite demo

new ExcelToSQLite
                .Builder(this)
                .setDataBase(databasePath) // 可选，如果不设置，默认为 “*.xls.db”，位于内部 database 目录下。
                .setAssetFileName("user.xls") // 如果文件在 asset 目录。
                .setFilePath("/storage/doc/user.xls") // 如果文件在其他目录。
                .setDecryptKey("1234567") // 可选，如果需要解密文档
                .setDateFormat("yyyy-MM-dd HH:mm:ss") // 可选，如果需要统一格式化日期单元格
                .start(ImportListener); // 或者使用 .start() 同步方法。

4. 感谢（如何支持 xlsx 可以参考以下仓库）

• https://github.com/centic9/poi-on-android
• https://github.com/FasterXML/aalto-xml
• https://github.com/johnrengelman/shadow

5. 注意事项

• 读写外部文件时，Android 6.0 及以上版本需处理运行时权限。
• Excel 导入 SQLite 时，默认取 excel 中 sheet 的第一行作为数据库表的列名，样式请参考 demo。
• 目前仅支持 blob 字段导出为图片，因为我也不知道 byte[] 是文件还是图片。
• 数据库文件须位于/data/data/包名/databases/下，一般都是位于这个目录下。

联系我

• Email: me@liyuyu.cn
• Weibo: @呵呵小小鱼