HarmonyOS鸿蒙Next中快速集成华为AGC云存储服务-NodeJS

HarmonyOS鸿蒙Next中快速集成华为AGC云存储服务-NodeJS 华为AppGallery Connect提供了一个云存储（CloudStorage）的服务，号称提供了一个便捷的云端存储服务，应用开发者使用的时候，可以不用关注服务器的部署，直接使用就行。

这个服务近期上线了服务端NodeJS的SDK，我抢先体验试用了一下。有兴趣的也可以下载codelab研究一下。

环境与应用信息

环境： https://developer.huawei.com/consumer/cn/service/josp/agc/index.html

SDK版本：agconnect/cloudstorage-server": “1.0.0”

集成SDK命令：npm install --save @agconnect/cloudstorage-server

在AGC上开通云存储:

PS：云存储服务目前还处于beta状态，使用前应该发邮件去申请开通： https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-cloudstorage-apply

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

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

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

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

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

安装Node.js环境：

NodeJs的安装是通用步骤，我这边就不详细描述，具体的安装步骤，大家可以去网上自行搜索，我这就说几个重点步骤

1. 下载并且安装Window环境的Node.js安装包： https://nodejs.org/en/download/

2. 安装NodeJS的时候，会自动安装对应的npm，安装完成后，可以通过如下命令查看对应的版本号

3. 对于NodeJS代码的开发，我习惯用的是VSCode，大家也可以为了根据我这习惯，也安装一个VScode。 http://code.visualstudio.com/

4. 安装好以后，再打我们的项目路径，testNodeJSDemo，随便创建创建一个js文件，写几个常规的输出：

5. 在VSCode里面运行这个js文件：在VScode左侧的控制台，选择Run，然后点击Run and Debug，运行的时候，选择Node.js，然后就可以下方看到输出

SDK集成

1. 打开命令行窗口，进入到项目目录下，在该目录下执行npm init命令创建package.json文件，参数使用默认的，一路回车即可，无需关注

2. 执行如下命令，安装CloudStorage的Server SDK的依赖

   npm install --save [@agconnect](/user/agconnect)/cloudstorage-server
   

3. 从AGC界面上下载下载Server SDK的认证凭据，并且把下载好的认证凭据放到刚才创建的项目路径下：，如果没有认证凭据，可以直接创建一个

功能开发

a) 初始化：

包含两块，一个是初始化Server SDk，一个是初始化Storage实例。

var { AGCClient, CredentialParser } = require("[@agconnect](/user/agconnect)/common-server");
var credential = CredentialParser.toCredential("./agc-apiclient-testnodejs.json");
AGCClient.initialize(credential);

const { StorageManagement } = require('[@agconnect](/user/agconnect)/cloudstorage-server');

b) 配置存储实例

复制AGC界面上的项目桶名，然后执行如下代码初始化

let bucketName = '9105385871708601205-ffeon'; // 配置AGC云端的存储实例

c) 上传文件：

此处我默认上传项目路径下的test123.txt文件，你们使用的时候，也可以按需配置。

// uploadFile();
function uploadFile() {
    const storage = new StorageManagement();
    const bucket = storage.bucket(bucketName);
  
    bucket.upload('./test123.txt')
        .then(res => console.log(res))
        .catch(err => console.log(err));
}

d) 下载文件

此处我默认下载云端根目录下的test123.txt文件，并且将下载好的本地文件，命名成test_download.txt你们使用的时候，也可以按需配置。

const fs = require('fs');
// downloadFile();
function downloadFile() {
    const storage = new StorageManagement();
    const bucket = storage.bucket(bucketName);
    const remoteFile = bucket.file('test123.txt');
    const localFile = './test_download.txt';

    remoteFile.createReadStream()
        .on('error', err => {
        })
        .on('end', () => {
        })
        .pipe(fs.createWriteStream(localFile))
}

f) 删除文件

此处我默认删除云端根目录下的test123.txt文件，你们使用的时候，也可以按需配置。

// deleteFile();
function deleteFile() {
    const storage = new StorageManagement();
    const bucket = storage.bucket(bucketName);
    const file = bucket.file('test123.txt');
    file.delete().then(res => {
    }).catch(err => {
    })
}

g) 例举全部文件

此处我默认删除云端根目录下的所有文件。

// getFileList();
function getFileList() {
    const storage = new StorageManagement();
    const bucket = storage.bucket(bucketName);

    bucket.getFiles({delimiter: '/'}).then(res => {
        console.log(res)
    }).catch(err => {
        console.log(err);
    })
}

功能点验证

1. 验证上传功能：

取消uploadFile();方法前的注释，然后在命令行窗口，执行node CloudStorage.js命令，进行文件的上传。

上传成功后，也可以AGC控制台上看到上传的test123.txt文件。

2. 验证下载

删除downloadFile();方法前的注释，然后在命令行窗口，执行node CloudStorage.js命令，进行文件的下载：反馈如下，没有任何提示

下载好以后，可以看到路径下，已经有刚刚下载的test_download.txt文件

3. 获取文件列表

删除getFileList();方法前的注释，然后在命令行窗口，执行node CloudStorage.js命令，查看根目录下的所有文件。命令行窗口显示如下：

显示的文件，和AGC界面显示的文件一致：

4. 删除文件：没有提示

删除deleteFile();方法前的注释，然后在命令行窗口，执行node CloudStorage.js命令，进行文件的删除：反馈如下，没有任何提示

此时AGC界面上，test123.txt也同样被删除了。

总结

仅关注NodeJS的开发，就可以在服务端操作项目中的文件。再也不用为了服务器的搭建和运维担心，省时省力。而且还提供了类似于管理员模式的web控制台，可以简单直观的对服务器上的文件进行管理。

这个云存储服务，除了最普通的上传下载和删除功能，还包括有列举文件，设置元数据等功能，具体可以看官方文档：

云存储服务开发指南： https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-cloudstorage-introduction

云存储服务codelab： https://developer.huawei.com/consumer/cn/codelab/CloudStorage-nodejs/index.html#0