更新记录

v1.0.2023.10.13（2023-10-17）

添加使用传统文件属性，android:requestLegacyExternalStorage="true"

v1.0.2023.10.10（2023-10-11）

增加权限相关功能

v1.0.2022.09.04（2022-09-05）

2022/09/04

1、全新改版，支持图片插入、公式、单元格富文本、字体样式等复用，打印设置。

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

前言（仅支持Android）

XM-XlsOutput是一款将JSON数据导出到Excel表格的插件，一开始主要用于表格类数据导出，随着客户需求的变化，现已支持1、读取表格。2、复杂表格生成，打印设置等。需要帮助，请联系作者，QQ：1804945430（备注来源）。

使用说明

第一次使用云插件请参考如下教程：https://blog.csdn.net/dashenid/article/details/129725810

生成Excel文件

1、数据规则说明 按照如下规则即可成功。

2、数据对象说明

ExcelBean，最外层数据结构

SheetBean

RowBean

CellBean

StyleBean

FontBean

CellRangeAddressBean

RichTextStyleBean

ImageObjBean

PrintSetupBean

FooterOrHeaderBean

范例数据一

{"directoryName":"测试插件","fileName":"测试文件","sheetList":[{"rowList":[{"cellList":[{"cellRangeAddress":{"firstCol":0,"firstRow":0,"lastCol":12,"lastRow":0},"style":{"align":2,"backgroundColor":0,"borderBottom":1,"borderBottomColor":8,"borderLeft":1,"borderLeftColor":8,"borderRight":1,"borderRightColor":8,"borderTop":1,"borderTopColor":8,"font":{"bold":false,"fontName":"黑体","fontSize":15,"italic":false},"verticalAlign":1,"wrapText":false},"text":"无锡航征站测探、测速记载及流量计算表","width":0}],"height":1500},{"cellList":[{"style":{"align":2,"backgroundColor":0,"borderBottom":1,"borderBottomColor":8,"borderLeft":1,"borderLeftColor":8,"borderRight":1,"borderRightColor":8,"borderTop":1,"borderTopColor":8,"font":{"bold":false,"fontName":"宋体","fontSize":8,"italic":false},"verticalAlign":1,"wrapText":false},"text":"施测时间","width":5000},{"text":"###############","width":8000},{"text":"至","width":5000},{"text":"###############","width":8000},{"text":"","width":5000},{"text":"风速方向","width":5000},{"text":"","width":5000},{"text":"巡测人员","width":5000},{"text":"","width":5000},{"text":"","width":5000},{"text":"","width":5000},{"text":"","width":5000},{"text":"","width":5000}],"height":1000},{"cellList":[{"text":"测深垂线","width":0},{"text":"测速垂线","width":0},{"text":"起点距","width":0},{"text":"水位","width":0},{"text":"河底高程","width":0},{"text":"应用水深","width":0},{"text":"平均水深(m)","width":0},{"text":"间隔(m)","width":0},{"text":"测深垂线(m2)","width":0},{"text":"部分(m2)","width":0},{"text":"测速垂线(m/s)","width":0},{"text":"部分平均(m/s)","width":0},{"text":"部分(虚)流量(m3/s)","width":0}],"height":0}],"sheetName":"测试sheet"}]}

范例数据二

{"directoryName":"测试插件","fileName":"测试文件","sheetList":[{"rowList":[{"cellList":[{"cellRangeAddress":{"firstCol":0,"firstRow":0,"lastCol":12,"lastRow":0},"style":{"align":2,"backgroundColor":0,"borderBottom":1,"borderBottomColor":8,"borderLeft":1,"borderLeftColor":8,"borderRight":1,"borderRightColor":8,"borderTop":1,"borderTopColor":8,"font":{"bold":false,"fontName":"黑体","fontSize":15,"italic":false},"verticalAlign":1,"wrapText":false},"text":"无锡航征站测探、测速记载及流量计算表","width":0}],"height":1500},{"cellList":[{"style":{"align":2,"backgroundColor":0,"borderBottom":1,"borderBottomColor":8,"borderLeft":1,"borderLeftColor":8,"borderRight":1,"borderRightColor":8,"borderTop":1,"borderTopColor":8,"font":{"bold":false,"fontName":"宋体","fontSize":8,"italic":false},"verticalAlign":1,"wrapText":false},"text":"施测时间","width":5000},{"text":"###############","width":8000},{"text":"至","width":5000},{"text":"###############","width":8000},{"text":"","width":5000},{"text":"风速方向","width":5000},{"text":"","width":5000},{"text":"巡测人员","width":5000},{"text":"","width":5000},{"text":"","width":5000},{"text":"","width":5000},{"text":"","width":5000},{"text":"","width":5000}],"height":1000},{"cellList":[{"text":"测深垂线","width":0},{"text":"测速垂线","width":0},{"text":"起点距","width":0},{"text":"水位","width":0},{"text":"河底高程","width":0},{"text":"应用水深","width":0},{"text":"平均水深(m)","width":0},{"text":"间隔(m)","width":0},{"text":"测深垂线(m2)","width":0},{"text":"部分(m2)","width":0},{"text":"测速垂线(m/s)","width":0},{"text":"部分平均(m/s)","width":0},{"text":"部分(虚)流量(m3/s)","width":0}],"height":0}],"sheetName":"测试sheet"}]}

读取Excel文件

            readExcel() {
                var ret = xlsModule.readExcel({
                    fileName: '/storage/emulated/0/测试文件.xlsx',
                    rowStart: 1 //从第一行开始
                })
                console.log(JSON.stringify(ret))
                modal.toast({
                    message: ret,
                    duration: 1.5
                });
            },
            readExcelExt() {
                //将uni路径转换成Android原生路径使用
                var filePath = plus.io.convertLocalFileSystemURL('/static/test.xlsx') //pdf文件所在路径
                var ret = xlsModule.readExcelExt({
                    fileName: filePath,
                    rowStart: 1, //从第一行开始
                    rowEnd: 5, //1-5行
                    colStart: 1, //从第一列开始
                    colEnd: 3, //1-3列
                    sheetName: '' //为空默认取第一个，不为空取不到正确的会报错
                })
                console.log(JSON.stringify(ret))
                modal.toast({
                    message: ret,
                    duration: 1.5
                });
            }

权限相关

            requestStoragePermission() {
                xlsModule.requestStoragePermission((ret) => {
                    console.log(ret);
                    uni.showToast({
                        title: '调用异步方法 ' + JSON.stringify(ret),
                        icon: "none"
                    })
                });
            },
            isExternalStorageManager() {
                xlsModule.isExternalStorageManager((ret) => {
                    console.log(ret);
                    uni.showToast({
                        title: '调用异步方法 ' + JSON.stringify(ret),
                        icon: "none"
                    })
                });
            },
            requestStorageManagerPermission() {
                xlsModule.requestStorageManagerPermission((ret) => {
                    console.log(ret);
                    uni.showToast({
                        title: '调用异步方法 ' + JSON.stringify(ret),
                        icon: "none"
                    })
                });
            }

特别说明

1、sheetList为数组，支持多个sheet表单。
2、单元格生成顺序为，第一行第一列->第一行第二列->第一行第三列->...->第二行第一列->...，因此rowList为某sheet中所有行数。cellList为某行中所有单元格列表。如果单元格之间有空内容单元格，请在单元格中用空内容表示。
3、使用样式规则为，某单元格使用样式后，后续单元格将保持使用该样式，无需重复添加。样式有变动后，请在该单元格中重新指定样式，同样后续单元格将保持该样式，知道有新的样式出现。
4、颜色short值。
    AUTOMATIC = 64
    BLACK = 8
    WHITE = 9
    YELLOW = 13
    RED = 10
    ORANGE = 53
    BROWN = 60

其他颜色对照表

支持定制，联系QQ：1804945430，微信：18980392735 请备注来源