HarmonyOS NEXT实战：通过QQ分享内容

Question

##HarmonyOS Next实战##三方SDK##教育##

前提条件：已接入QQ SDK

参考资料：
https://wiki.connect.qq.com/harmonyos_sdk%e6%8e%a5%e5%8f%a3%e8%af%b4%e6%98%8e

以下为通过QQ分享内容的鸿蒙项目代码实战：
前置条件：
修改oh-package.json5文件，接入CryptoJS的依赖

  "dependencies": {
    "@tencent/wechat_open_sdk": "1.0.11",
    "@ohos/crypto-js": "^2.0.4"
  }

作用：通过HMAC-SHA1算法生成签名

分享业务开发流程说明：
为保证业务分享数据的可信，需要对分享数据进行签名，以分享图文ark消息为例，我们推荐业务采用以下流程：
业务客户端：用户分享时，将分享的UGC内容传到业务后台。
业务后台：使用用户UGC数据完成ark业务JSON数据的组装（ShareData.shareJson），生成ShareData中的时间戳（ShareData.timestamp）、随机自然数（ShareData.nonce），并对这三部分数据进行签名计算后，将以上数据回调业务客户端，由业务客户端调用互联分享接口发起分享。

参数说明：
type: 分享类型，目前支持图文ark类型 2
shareData: 分享数据，包含分享业务数据+签名部分数据

签名步骤如下:
拼接签名原文。签名原文串的拼接规则为：

请求方法 + 请求域名 + 请求路径 + ? + 请求字符串 + 分享内容 json 字符串

请求方法：固定为 POST，注意为全大写
接口域名：固定为 connect.qq.com
请求路径：固定为 /share
请求字符串：把签名参数和值按字典序拼接为字符串，如：
appid=222222&nonce=1234&ts=1618924373
请求body：即为分享内容组成的 json 字符串

假设分享参数如下：

appid：222222
nonce：1234
ts：1618924373
分享内容：
{"msg_style": 0, "title":"标题", "summary":"内容", "brief":"互联分享","url":"https://www.qq.com","picture_url":"https://www.qq.com/picture.png"}

按照规则拼出来的签名原文如下：

POSTconnect.qq.com/share?appid=222222&nonce=1234&ts=1618924373&{"msg_style": 0, "title":"标题", "summary":"内容", "brief":"互联分享", "url":"https://www.qq.com", "picture_url":"https://www.qq.com/picture.png"}

计算签名
此步骤生成签名串。首先使用 HMAC-SHA1 算法对上一步中获得的签名原文字符串进行签名，然后将生成的签名串使用 Base64 进行编码，即可获得最终的签名串。假设 appkey 为: fakeAppKey 最终得到的签名结果为：

Ngyk0JS5pQR8ffygeeMHFUNFQQA=

添加QQUtil.ets

import { CryptoJS } from '@ohos/crypto-js'

export class QQUtil {
  /**
   * 分享
   * @param title 标题
   * @param summary 内容
   * @param brief QQ信息列表显示的内容
   * @param imageUrl 图片链接
   * @param url 跳转链接
   */
  static share(title: string, summary: string, brief: string, imageUrl: string, url: string) {
    let content = new Object({
      msg_style: 0,
      title: title,
      summary: summary,
      brief: brief,
      url: url,
      picture_url: imageUrl
    })
    let shareData: ShareData = new ShareData()
    shareData.timestamp = Date.parse(new Date().toString()) / 1000
    shareData.nonce = Math.floor(Math.random() * 100000000 + 100)
    shareData.shareJson = JSON.stringify(content)
    let signContent = 'POSTconnect.qq.com/share?appid=' + AppConfigs.qqsdkAppId.toString()
      + '&nonce=' + shareData.nonce.toString()
      + '&ts=' + shareData.timestamp.toString()
      + '&' + shareData.shareJson
    const hmac = CryptoJS.HmacSHA1(signContent, AppConfigs.qqsdkAppKey);
    let sign = hmac.toString(CryptoJS.enc.Base64);

    shareData.shareJsonSign = sign
    const qqOpenApi = QQUtil.getQQOpenApi()
    qqOpenApi.share(2, shareData).then((result: ShareResult) => {
      Logger.info(`qqOpenApi.share, result=${JSON.stringify(result)}`)
      switch (result.resultType) {
        case ShareResultType.Success: {
          promptAction.showToast({ message: "分享成功" })
        }
          break
        case ShareResultType.Cancel: {
          let msg: string = result.message ?? "用户取消分享"
          promptAction.showToast({ message: msg })
        }
          break
        case ShareResultType.Error: {
          let msg: string = result.message ?? "分享失败"
          promptAction.showToast({ message: msg })
        }
          break
      }
    })
      .catch((err: BusinessError) => {
        Logger.error(`error, code=${JSON.stringify(err.code)}, message=${JSON.stringify(err.message)}`)
      })
  }
}