HarmonyOS NEXT实战：接入微-信SDK

##HarmonyOS Next实战##HarmonyOS SDK应用服务##教育##

前提条件：已在微-信开放平台创建移动应用。参考资料： https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Access_Guide/ohos.html

申请你的 AppID 并配置鸿蒙应用信息以及提交审核 · 前往微-信开放平台，「管理中心 - 移动应用」创建移动应用账号，并且在「平台信息」板块中填入鸿蒙应用所需的 Bundle ID 和 identifier 信息，如下图。然后提交审核，待审核通过即可获得相应权限 · 如已有移动应用，则可在「管理中心 - 移动应用 - 详情 - 开发配置」中点击「编辑」进入修改开发信息的页面，继续在「平台信息」板块中填入鸿蒙应用所需的 Bundle ID 和 identifier 信息，然后提交审核，等待审核通过即可。

配置 sdk 依赖在 DevEco Studio NEXT中打开你的项目，以 demo 工程为示例：修改项目中的oh-package.json5文件，在dependencies中加入微-信 opensdk 的依赖项：

{
  "name": "demo",
  "version": "1.0.0",
  "description": "Please describe the basic information.",
  "main": "",
  "author": "",
  "license": "",
   "dependencies": {
    "@tencent/wechat_open_sdk": "1.0.7"
  }
}

修改模块配置修改entry的module.json5文件，增加actions（约定接收来自微-信的数据）

              "wxentity.action.open"

继续修改entry的module.json5文件，增加querySchemes

    "querySchemes": [
      "weixing",
      "wxopensdk"
    ]

修改构建配置从AppGallery下载“证书”和“Profile”，并配置“signingConfigs”。注意：如果不配置签名，则调用微-信SDK时，会在微-信APP提示“第三方应用信息校验失败”

增加SDK工具类添加WXApi

import * as wxopensdk from '@tencent/wechat_open_sdk';

//对应微-信开放平台的APPID
const APP_ID='APPID'

// WXApi 是第三方app和微-信通信的openApi接口，其实例通过WXAPIFactory获取，需要传入应用申请到的AppID（指的是移动应用Appid，不要填小程序Appid！！！）
export const WXApi = wxopensdk.WXAPIFactory.createWXAPI(APP_ID)

添加WXEventHandler

import * as wxopensdk from '@tencent/wechat_open_sdk';

export type OnWXReq = (req: wxopensdk.BaseReq) => void
export type OnWXResp = (resp: wxopensdk.BaseResp) => void

const kTag = "WXApiEventHandlerImpl"

// WXApiEventHandler为微-信数据的回调
class WXApiEventHandlerImpl implements wxopensdk.WXApiEventHandler {
  private onReqCallbacks: Map<OnWXReq, OnWXReq> = new Map
  private onRespCallbacks: Map<OnWXResp, OnWXResp> = new Map

  registerOnWXReqCallback(on: OnWXReq) {
    this.onReqCallbacks.set(on, on)
  }
  unregisterOnWXReqCallback(on: OnWXReq) {
    this.onReqCallbacks.delete(on)
  }

  registerOnWXRespCallback(on: OnWXResp) {
    this.onRespCallbacks.set(on, on)
  }
  unregisterOnWXRespCallback(on: OnWXResp) {
    this.onRespCallbacks.delete(on)
  }

  onReq(req: wxopensdk.BaseReq): void {
    wxopensdk.Log.i(kTag, "onReq:%s", JSON.stringify(req))
    this.onReqCallbacks.forEach((on) => {
      on(req)
    })
  }

  onResp(resp: wxopensdk.BaseResp): void {
    wxopensdk.Log.i(kTag, "onResp:%s", JSON.stringify(resp))
    this.onRespCallbacks.forEach((on) => {
      on(resp)
    })
  }
}
export const WXEventHandler = new WXApiEventHandlerImpl

常见问题 1、如何判断「微-信」是否已经安装开发者可通过 WXApi.isWXAppInstalled() 实现判断微-信是否已安装，但需在开发者的 App module的 module.json5 里加入下方声明，详情可查看使用canOpenLink判断应用是否可访问

2、微-信登录失败：由于应用 Bundle ID 信息校验不通过，无法使用微-信登录出现该报错提示原因是你的移动应用配置了鸿蒙的开发信息后，提交审核，尚未审核通过（即审核中或者审核驳回）了，重新提交待审核通过即可如果状态已经是审核通过，但是还是出现该报错，请检查 appid + identifier + bundleId 是否匹配（可在「微-信开放平台 - 管理中心 - 移动应用 - 详情 - 开发配置」查看）

3、微-信拉起App时，App如何接受来自微-信的数据开发者需要先配置和微-信约定的action wxentity.action.open 开发者还需要实现 wxopensdk.WXApiEventHandler的onReq函数