YottaMobilePlugin

更新记录

1.0.8（2021-12-30）下载此版本

更新使用说明

1.0.7（2021-12-23）下载此版本

更新readme文档

1.0.6（2021-12-22）下载此版本

修正说明文档格式显示错误问题

平台兼容性

Android	Android CPU类型	iOS
适用版本区间：5.1 - 11.0	armeabi-v7a：支持，arm64-v8a：未测试，x86：支持	×

原生插件通用使用流程：

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

付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择

1、 YottaChain是新一代区块链存储技术，提供比传统云存储更高的可靠性、更强的安全性和更低的成本，见《铸造IT核心技术的国之重器 YottaChain掀起存储行业时代变革》https://tech.hexun.com/2019-12-29/199818535.html.

2、本插件主要作用是提供给uni-app前端直接调用YottaChain安全存储服务，包含用户注册、文件加密上传、文件下载解密以及文件列表等功能。本插件仅支持安卓端调用，以接口调用的形式提供。

3、 YottaChain采用国家顶级涉密机构使用的TruPrivacy安全技术，超越银行安全级别，可保证加密后无人能破解；每一个文件都用LRC（一种比RAID和EC纠删码更强大的数学编码）编码后保存到328个存储节点，最多可容忍200个节点同时故障还不丢失数据；使用成本不到常规云存储服务打折后的一半价格。

4、本插件主要处理数据加解密等核心操作，需要与代理服务器配套使用。开发者可自建代理服务器，也可以用YottaChain提供的公用服务器，app-agent.yottachain.net:8088，接口中所有需要传递url的参数可以直接写以上地址。公共服务器并不能保证服务的稳定性，性能会受到同时接入的人数影响。自建代理服务器可以从https://www.yottachain.net/zh/download下载S3客户端，有linux和windows两个版本可选，安装使用方法官网都有对应的文档，加解密默认对应的服务端口为8080。

5、uni-app API接口调用方法如下案例：

var yottaModule = uni.requireNativePlugin("Yotta-Module");
    export default {
        data() {
            return {
                name:"",
                age:"",
                result:"",
        }
    },
    methods: {
            test(){
                yottaModule.testText({

                    'name':"this.name",

                    'age':this.age,
                },
                (ret) =>{

                    this.result="[提交反馈]"+ret.code;
                })
            }
        }
    }

6、以上yottaModule.testText()方法为程序自带测试接口方法，可以在uni-app中参照以上方式调用，以下五条为API列表及对应的示例代码：

①注册服务，初始化程序

    yottaModule.register({

        'userName':"你的YottaChain 用户名",

        'privateKey':"你的YottaChain存储私钥",

        'snlistDirectory':"你本地的snlist.properties 文件路径"
    }),

②获取存储桶下文件列表

    yottaModule.listBucket({

        'bucketName':"存储桶名称",

        'publicKey':"你的YottaChain存储公钥",
    }),

③文件上传

    yottaModule.upload({

        'url' : "上面第四条中的服务地址",

        "filePath" : "要上传的文件路径",

        'bucketName':"存储桶名称",

        'userName':"用户名",

        'privateKey':"存储私钥",

        'snlistDirectory':"你本地的snlist.properties 文件路径",
    }),

⑥文件下载

    yottaModule.download({

        'url' : "上面第四条中的服务地址",

        "directory" : "下载文件保存本地路径",

        'bucketName':"存储桶名称",

        'fileName':"文件名",
    }),

8、注册S3服务 s3存储服务安装之后需要将用户注册到内存中才能使用，比如YottaChain提供的对外公共服务注册方法如下：

描述
将用户名和私钥注册至系统内存中，服务重启需重新注册
URL结构
POST?http://117.161.159.32:8088/api/v1/insertuser
userName:required?用户名
privateKey:required?用户存储私钥
METHOD
POST
curl
curl http://localhost:8080/api/v1/insertUser \
-d 'userName=yingyingt&privateKey=5K6p4WfBKKBKXJxYGLwhxHmAgi1iFPh8EJ6ThVjF5Rqa157iGDm' \
-X POST \
-k 允许不使用证书到SSL站点