前言

在我工作的日常中，經(jīng)常會用一些畫圖編輯器，簡單設(shè)計一些頁面原型。而在去年低代碼很火的時候，我在公司就開發(fā)了一款大屏可視化編輯器，可以通過拖拉拽生成網(wǎng)頁的一個工具。后面也想著自己也開發(fā)一個畫圖的編輯器，可以用來自己平時做圖或者設(shè)計海報之類的。而這次我將使用鴻蒙ArkTs來開發(fā)這款海報編輯器APP，順便分享一下我這次的開發(fā)經(jīng)驗。

項目架構(gòu)與開發(fā)流程

我這次項目功能架構(gòu)以及整體開發(fā)流程如下：

項目功能結(jié)構(gòu)

整體開發(fā)流程

這次開發(fā)我使用了鴻蒙的端云一體化的開發(fā)模式進行整個項目的構(gòu)建。說實話：之前我都是自己寫后端代碼，開發(fā)流程確實比較繁瑣。而云開發(fā)模式就很方便了，端側(cè)與云側(cè)同時開發(fā)，無需搭建服務(wù)器，工具成本低。這點我還是很喜歡的。

端云一體化工程講解

端云一體化的工程我也是第一次開發(fā)，相信很多伙伴也沒開發(fā)過。我這次用的是官方提供的云模板工程，我大概給大家講解一下：

整體結(jié)構(gòu)很簡單，使用起來也比較方便。所有的操作DevEco Studio開發(fā)工具都集成了。

而在講解之前，使用云模板創(chuàng)建項目之前需要在華為開發(fā)平臺創(chuàng)建項目，具體創(chuàng)建流程可以到官方文檔查看，地址我也放在下面：https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/agc-harmonyos-clouddev-agcapp-0000001439436876-V3#section397317130308

注意：記得是創(chuàng)建項目哦，不是應(yīng)用。我一開始就搞錯了

創(chuàng)建表與方法

1. 比如你要新建一張數(shù)據(jù)庫表，只需在clouddb云數(shù)據(jù)庫入口文件點擊右鍵，點擊new，然后你選擇需要創(chuàng)建什么。
   

而我比較喜歡在開發(fā)平臺創(chuàng)建，比較方便，傻瓜式操作。大家也可以看看官方文檔：https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-Guides/agc-clouddb-createfirstclouddb-0000001569588629

2.比如你要創(chuàng)建一個云函數(shù)方法，也是只需在cloudfuntion云函數(shù)入口文件點擊右鍵，點擊new，然后你直接創(chuàng)建一個對應(yīng)的云函數(shù)即可。

開發(fā)函數(shù)與數(shù)據(jù)庫的使用

由于第一次使用云函數(shù)與云數(shù)據(jù)庫，一路上磕磕碰碰。所以我打算將自己經(jīng)驗都分享給大家，希望能幫助大家。

開發(fā)云函數(shù)

在創(chuàng)建云函數(shù)之后，代碼結(jié)構(gòu)如下：

其中有一個ts文件，這個就是我們的函數(shù)入口了，其他的我們都暫時不用動。這里我默認的是nodejs開發(fā)模式以及http請求模式。如果你們需要修改配置可以看一下官方文檔：https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-Guides/agc-cloud-function-start-from-here-0000001512489692

ts文件里面默認有一個主入口方法：

let myHandler = async function (event, context, callback, logger) {
  // 獲取你的參數(shù)
  const body = event.body ? JSON.parse(event.body) : event

  // 寫你的業(yè)務(wù)代碼

  callback({
      code: 200,
      data: [],
      msg: '提示內(nèi)容'
  });
};

export { myHandler };

• myHandler：入口方法名稱。
• event：調(diào)用方傳遞的事件對象，JSON格式。具體內(nèi)容請參見event對象。
• context：函數(shù)運行時上下文對象，封裝了日志接口、回調(diào)接口、環(huán)境變量env對象等。
• callback：事件處理結(jié)果。
• logger：記錄日志。

這里需要注意的是：獲取參數(shù)的方式，我在本地調(diào)試的時候，event就是參數(shù)對象了，但是發(fā)布到云服務(wù)器之后，端側(cè)傳遞的參數(shù)需要通過event.body來判斷是否存在，然后將數(shù)據(jù)JSON化。也不知道是不是我用的不對，但是目前我是遇到這個問題了。

接下來我講解一下云函數(shù)調(diào)用云數(shù)據(jù)庫與云存儲的相關(guān)步驟。詳細步驟如下：

云函數(shù)使用云數(shù)據(jù)庫

1. 云數(shù)據(jù)庫注冊認證

在使用云數(shù)據(jù)庫的所有方法時，都需要先注冊認證哈

const path = require('path');
const clouddb = require('@hw-agconnect/database-server/dist/index.js')
const { AGCClient, CredentialParser } = require("@hw-agconnect/common-server");
const db_demo = require('./db/bd_demo') // 從開發(fā)者平臺下載對應(yīng)的js配置文件，放在對應(yīng)的函數(shù)目錄根目錄下

// 加載憑證文件，憑證文件也是在開發(fā)者平臺下載，具體看我的截圖
let client_name = "./db/agc-apiclient-chen.json";
let client_path = path.join(__dirname, client_name);
let credential = CredentialParser.toCredential(client_path);
AGCClient.initialize(credential, "clientCN", "CN");

let myHandler = async function (event, context, callback, logger) {
  // xxxx
};

export { myHandler };

1.1 下載加載對象類型文件

1.2 將上面下載的文件引入到云函數(shù)目錄中

1.3 下載憑證文件

2. 初始化云數(shù)據(jù)庫實例以及打開存儲區(qū)

// 接著加載憑證文件的相關(guān)代碼下
const agcClient = AGCClient.getInstance("clientCN");
clouddb.AGConnectCloudDB.initialize(agcClient);
const agconnectCloudDB = clouddb.AGConnectCloudDB.getInstance(agcClient);
//云數(shù)據(jù)庫區(qū)塊，獲取方法看以下截圖
const zoneName = '區(qū)塊名稱';
const cloudDBZoneConfig = new clouddb.CloudDBZoneConfig(zoneName);
const mCloudDBZone = agconnectCloudDB.openCloudDBZone(cloudDBZoneConfig);

2.1 獲取區(qū)塊名稱

3. 使用云數(shù)據(jù)庫的方法

3.1 云數(shù)據(jù)庫-新增數(shù)據(jù)

需要注意的是：表名稱，直接寫對應(yīng)的字符串名稱就好

// 上面是注冊、加載憑證、打開存儲區(qū)的代碼

let myHandler = async function (event, context, callback, logger) {
  // 獲取你的參數(shù)
  const body = event.body ? JSON.parse(event.body) : event

  //表名稱也是通過開發(fā)者平臺獲取即可，字符串模式
  const bookInfo = clouddb.CloudDBZoneGenericObject.build('表名稱')
  // 添加屬性對應(yīng)的數(shù)據(jù)，按照自己定義的字段格式去賦值
  bookInfo.addFieldValue('字段名稱1', '數(shù)據(jù)')
  bookInfo.addFieldValue('字段名稱2', '數(shù)據(jù)')
  // 同步插入表里
  const resp = await mCloudDBZone.executeUpsert(bookInfo)
  callback({
      code: 200,
      data: [],
      msg: '提示內(nèi)容'
  });
};

export { myHandler };

3.2 云數(shù)據(jù)庫-更新數(shù)據(jù)

需要注意的是：要先獲取表實例以及定位唯一鍵

const db_demo = require('./db/bd_demo')
// 上面是注冊、加載憑證、打開存儲區(qū)的代碼

let myHandler = async function (event, context, callback, logger) {
  // 獲取你的參數(shù)
  const body = event.body ? JSON.parse(event.body) : event
  
  // 引入表實例
  const bookInfo = new db_demo.db_demo();
  // 定位唯一鍵，目的找到對應(yīng)的數(shù)據(jù)
  bookInfo.setId('主鍵數(shù)據(jù)值') // 主鍵字段，自己在創(chuàng)建數(shù)據(jù)庫的時候需要自定義主鍵
  // 注冊
  const operator = clouddb.CloudDBZoneObjectOperator.build(bookInfo)
  operator.update('字段名稱1', 數(shù)據(jù)) // 更新對應(yīng)字段數(shù)據(jù)
  operator.update('字段名稱2', 數(shù)據(jù)) // 更新對應(yīng)字段數(shù)據(jù)
  operator.update('字段名稱3', 數(shù)據(jù)) // 更新對應(yīng)字段數(shù)據(jù)
  // ....
  // 更新表里數(shù)據(jù)
  const resp = await mCloudDBZone.executeUpdate(operator)
  callback({
      code: 200,
      data: [],
      msg: '提示內(nèi)容'
  });
};

export { myHandler };

3.2 云數(shù)據(jù)庫-查詢數(shù)據(jù)

這里需要注意的是：查詢方式有很多，我這邊只用到很基礎(chǔ)的。想要更多操作可以看一下官網(wǎng)：https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-Guides/agc-clouddb-otheroperations-servernodejs-0000001569466329#section171182910246

const db_demo = require('./db/bd_demo')
// 上面是注冊、加載憑證、打開存儲區(qū)的代碼

let myHandler = async function (event, context, callback, logger) {
  // 獲取你的參數(shù)
  const body = event.body ? JSON.parse(event.body) : event
  
  // 初始化表
  let cloudDBZoneQuery = clouddb.CloudDBZoneQuery.where(db_demo.db_demo)
  // 查詢字段名稱等于xxx的數(shù)據(jù)
  const userCloudDBZoneQuery = cloudDBZoneQuery.equalTo('字段名稱', 'xxx');
  const respUser = await mCloudDBZone.executeQuery(userCloudDBZoneQuery);
  const data = respUser.getSnapshotObjects()[0] // 獲取對應(yīng)數(shù)據(jù)
  callback({
      code: 200,
      data: [],
      msg: '提示內(nèi)容'
  });
};

export { myHandler };

3.3 云數(shù)據(jù)庫-刪除數(shù)據(jù)

刪除相關(guān)的操作我還沒使用過，等我使用之后再補充給大家

云函數(shù)使用云存儲

1. 云存儲注冊認證

在使用云存儲的所有方法時，也是都需要先注冊認證哈

import {AGCClient, CredentialParser} from "@agconnect/common-server"
import {StorageManagement, Bucket, File, AGCCloudStorage} from "@agconnect/cloudstorage-server"

// 加載憑證文件
let client_name = "./db/agc-apiclient-chen.json";
let client_path = path.join(__dirname, client_name);
let credential = CredentialParser.toCredential(client_path);
AGCClient.initialize(credential, "clientDW");

let storage = AGCCloudStorage.getInstance("clientDW");
// name: 存儲實例名稱，獲取方式從開發(fā)者平臺獲取
let bucket = storage.bucket('xxxx');

let myHandler = async function (event, context, callback, logger) {
  // xxxx
};

export { myHandler };

1.1 獲取存儲實例名稱

2. 使用云存儲的方法

2.1 上傳文件

需要注意的是：上傳文件需要注意destination的文件路徑規(guī)則。需要上傳的文件對應(yīng)的路徑則是本地路徑，文件在云函數(shù)的根目錄下，。后續(xù)我也會將怎么通過端側(cè)上傳圖片到云函數(shù)再上傳到云存儲的相關(guān)操作。

// 以上是認證的相關(guān)代碼

let myHandler = async function (event, context, callback, logger) {
    const options = {
      destination:  'demo/demo.png', // 對應(yīng)云存儲中的文件路徑，demo文件夾需要自己在開發(fā)者平臺創(chuàng)建，文件名稱自定義，存在則覆蓋不存在則新增
      onUploadProgress: (event) = > {}
    };
    bucket.upload('需要上傳的文件路徑，例如：./static/demo.png', options);
};

export { myHandler };

2.2 下載文件

// 以上是認證的相關(guān)代碼

let myHandler = async function (event, context, callback, logger) {
    const remoteFile = bucket.file(‘云存儲下的文件具體路徑’);
    const localFile = '需要上傳的文件路徑，例如：./static/demo.png'
    const directory = path.dirname(localFile);
    // 判斷本地是否有當(dāng)前文件，有則創(chuàng)建
    if (!fs.existsSync(directory)) {
      fs.mkdirSync(directory, { recursive: true });
    }
    
    // 下載云存儲的文件內(nèi)容到對應(yīng)的本地文件
    await remoteFile.createReadStream()
      .on('error', (err) = > {})
      .on('end', () = > {
        // 業(yè)務(wù)代碼
      })
      .pipe(fs.createWriteStream(localFile));
};

export { myHandler };

總結(jié)

這次的鴻蒙端云一體化的開發(fā)經(jīng)驗就講解到這里，可能我講的不是很細，因為也是第一次使用，希望可以幫助大家。如果上面描述的有問題，歡迎大家在評論區(qū)指出來，謝謝。后面我們也會分享端側(cè)的開發(fā)經(jīng)驗，以及會將對應(yīng)app上線，到時候有相關(guān)技術(shù)討論的都可以找我們

審核編輯 黃宇