【安卓】Cocos|快速集成华为AGC云存储服务

Z时代
2024-01-10
分类：技术分享

华为AppGallery Connect提供了一个云存储（CloudStorage）的服务，号称提供了一个便捷的云端存储服务，应用开发者使用的时候，可以不用关注服务器的部署，直接使用就行。

目前这个功能还在beta阶段，我先抢先体验了一下。

1、环境与应用信息

AGC地址：https://developer.huawei.com/consumer/cn/service/josp/agc/index.html

SDK集成方式：在Cocos Creator中开通集成

2、在AGC上开通云存储:

PS：云存储服务目前还处于beta状态，使用前应该发邮件去申请开通：

https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-cloudstorage-apply

在我的项目下选择你的开发项目，在构建下面，找到云存储服务，点击开通：

没有Android项目的话，可以先自己创建一个。

【安卓】Cocos|快速集成华为AGC云存储服务

开通服务的时候，需要先配置存储实例，这里按需配置就可以，我就随便配置一个。

【安卓】Cocos|快速集成华为AGC云存储服务

下一步，还需要配置安全策略，这里使用默认的安全策略就好:

PS：默认的情况是，只有经过身份认证的用户才能进行读写。

【安卓】Cocos|快速集成华为AGC云存储服务

3、在Cocos Creator项目集成SDK

3.1 集成SDK

官方文档：https://docs.cocos.com/creator/manual/zh/cocos-service/agc-applinking.html

（1）在 Cocos 服务面板接入所需的云存储服务。目前 SDK 仅支持 Android 平台

【安卓】Cocos|快速集成华为AGC云存储服务

（2）接入相关的服务前，需要先关联APP，在服务界面点击启用后，再点击关联按钮，点击创建后，会跳转到Cocos的管理台，

【安卓】Cocos|快速集成华为AGC云存储服务

（3）可以根据个人需要创建一个新游戏

（4）创建完成后，就可以回到Cocos Creator界面新建，刷新和选择进行应用的关联，
【安卓】Cocos|快速集成华为AGC云存储服务

（5）然后就可以回到云存储界面，可以正式进行服务的开通了
【安卓】Cocos|快速集成华为AGC云存储服务

（6）服务开通以后，需要配置默认的存储实例，此处需要填写AGC界面上的已经开通云存储的项目的默认桶。

【安卓】Cocos|快速集成华为AGC云存储服务

3.2 下载json文件

（1）服务开通以后，回到项目设置界面，下载最新的json文件。
【安卓】Cocos|快速集成华为AGC云存储服务

（2）将刚下载好json文件，放到Cocos项目的settings目录下

【安卓】Cocos|快速集成华为AGC云存储服务

4、前置步骤

4.1 修改安全规则

默认的安全规则下，需要经过华为认证的用户，才能进行云存储文件操作。

为了集成方便，特地修改云存储的安全规则，将安全规则修改为全部允许，此时无需经过华为认证，就可以对云存储中的文件进行操作。

// 全部允许
agc.cloud.storage[
match: /{bucket}/{path=**} {
allow read, write:  if true;
}]

【安卓】Cocos|快速集成华为AGC云存储服务

4.2 界面布局

在Cocos Creator上设置几个按钮，通过点击按钮来实现功能：包括例举文件，上传，下载文件，和删除文件的按钮。

【安卓】Cocos|快速集成华为AGC云存储服务

5、功能开发：

5.1 初始化，并且在Start中创建监听

start () {
this._storage = huawei.agc.storage;
this._storage.storageService.on("error", data => console.log("Cloud Storage", `error : ${data.errCode}:${data.errMsg}`), this);
this._storage.storageService.on("get-file-metadata", data => console.log("Cloud Storage", JSON.stringify(data)), this);
this._storage.storageService.on("update-file-metadata", data => console.log("Cloud Storage", JSON.stringify(data)), this);
this._storage.storageService.on("delete-file", data => console.log("Cloud Storage", JSON.stringify(data)), this);
this._storage.storageService.on("list-file", data => console.log("Cloud Storage", JSON.stringify(data)), this);
this._storage.storageService.on("get-download-url", data => console.log("Cloud Storage", JSON.stringify(data)), this);
this._storage.storageService.on("task", data => {
console.log("Cloud Storage", JSON.stringify(data));
if (data.task instanceof this._storage.AGCDownloadTask && data.status === 'successful') {
jsb.fileUtils.renameFile(jsb.fileUtils.getWritablePath() + "/output.json", jsb.fileUtils.getWritablePath() + "/output1.json");
}
}, this);
// 创建根目录的引用
this.rootReference = huawei.agc.storage.storageService.getInstance().getStorageReference();},

5.2 例举文件

使用ListALL方法，例举所有文件：

listAll:function () {
this.rootReference.listAll();
console.log('Cloud Storage', 'ListAll file');}

5.3 下载文件

下载一个云端的，名为test.jpg的文件，并且重新命名为test1.jpg。

download:function () {
// 先 delete 文件，避免文件已存在导致下载失败
jsb.fileUtils.removeFile(jsb.fileUtils.getWritablePath() + "/test.jpg");
this.rootReference.child("test.jpg").getFile(jsb.fileUtils.getWritablePath() + "/test1.jpg");
console.log('Cloud Storage', 'download test.jpg, and reNamed test1.jpg');},

5.4 上传文件

上传刚刚下载的test1.jpg文件

 upload:function () {
if (!jsb.fileUtils.isFileExist(jsb.fileUtils.getWritablePath() + "/test1.jpg")) {
return console.log('Cloud Storage', 'local file test1.jpg not exist, please click Download!')
}
this.rootReference.child("test1.jpg").putFile(jsb.fileUtils.getWritablePath() + "/test1.jpg");
console.log('Cloud Storage', 'upload test1.jpg');},

5.5 删除文件

删除本地的，以及云端的test1.jpg文件。

 delete:function () {
this.rootReference.child("test1.jpg").delete();
console.log('Cloud Storage', 'delete test1.jpg success!')
jsb.fileUtils.removeFile(jsb.fileUtils.getWritablePath() + "/test1.jpg");},