更新记录

1.0（2024-07-11）

SDK上传

平台兼容性

原生插件通用使用流程：

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原生插件配置”->”云端插件“列表中删除该插件重新选择

zlpy-aliOssUpload

一、基本使用

使用前须知：

• ~~重要：此插件依赖阿里云音OSS客户端插件，仅可以用于阿里云OSS存储的文件操作

1.OSS初始化方法，必须先初始化才可以调用其他方法（阿里sts服务搭建）

                var testModule = uni.requireNativePlugin('zlpy-aliOssUpload');
                testModule.initOss({
                    stsUrl: "https://xxxx/sts/",
                    endPoint: "https://xxxx.com",
                }, (res) => {
                    console.log("阿里云上传:" + JSON.stringify(res))
                })

可配置参数说明

2.文件上传方法，支持断点上传(建议在initOss回调中调用)

                testModule.startUpload({
                    bucket: "xxxx",
                    name: "test/test.mp4",
                    path: plus.io.convertLocalFileSystemURL(filePath)
                }, (res) => {
                    console.log("阿里云上传:" + JSON.stringify(res))
                })

可配置参数说明

3.文件下载方法，支持断点下载(建议在initOss回调中调用，安卓端需要开启存储权限，请自行判断)

                testModule.startDownload({
                    bucket: "xxxx",
                    name: "test/test.mp4"
                }, (res) => {
                    console.log("阿里云上传:" + JSON.stringify(res))
                })

可配置参数说明

4.取消正在上传/下载的任务

                testModule.cancelTask({
                    name: "test/test.mp4",
                    isDownload: true
                }, (res) => {
                    console.log("阿里云上传:" + JSON.stringify(res))
                })

可配置参数说明

5.删除空间的文件（必须在initOss回调中调用）

                testModule.deleteFile({
                    bucket: "xxxx",
                    name: "test/test.mp4"
                }, (res) => {
                    console.log("阿里云上传:" + JSON.stringify(res))
                })

可配置参数说明

6.批量删除空间的文件（必须在initOss回调中调用）

                testModule.deleteFileMultiple({
                    bucket: "xxxx",
                    nameList: ["test/test.mp4","test/test.mp4","test/test.mp4"]
                }, (res) => {
                    console.log("阿里云上传:" + JSON.stringify(res))
                })

可配置参数说明

7.判断文件是否存在（必须在initOss回调中调用）

                testModule.doesObjectExist({
                    bucket: "xxxx",
                    name: "test/test.mp4"
                }, (res) => {
                    console.log("阿里云上传:" + JSON.stringify(res))
                })

可配置参数说明

8.获取文件列表（必须在initOss回调中调用）

                testModule.getObjectList({
                    bucket: "xxxx"
                }, (res) => {
                    console.log("阿里云上传:" + JSON.stringify(res))
                })

可配置参数说明

回调中的参数

可配置参数说明

状态码

可配置参数说明