一、准备工作
1. 注册并配置微信开放平台
- 登录 微信开放平台。
- 在「管理中心 - 移动应用」中创建或编辑你的应用。
- 填写 Bundle ID (即鸿蒙应用的
bundleName
)和 identifier (可与 Bundle ID 相同)。 - 提交审核后获取 AppID 和 AppSecret 。
- 配置签名信息(SHA256),确保与鸿蒙应用签名一致。
2. 下载并引入 SDK
- 微信官方已发布适用于鸿蒙的 OpenSDK(当前版本为 1.0+)。
- 在项目
oh-package.json5
中添加依赖:
"dependencies": {
"@tencent/wechat_open_sdk": "1.2.0"
}
二、代码实现示例
1. 初始化 SDK(建议放在 Ability 的 onCreate()
中)
import wxopensdk from '@tencent/wechat_open_sdk';
export default class MainAbility extends UIAbility {
private wxApi: any;
onCreate(want, launchParam) {
this.wxApi = wxopensdk.WXApi;
// 替换为你的 AppID
this.wxApi.registerApp(this.context as common.UIAbilityContext, "YOUR_APPID");
}
}
2. 调起微信支付(用户点击“支付”按钮时触发)
// 示例:在某个页面组件中定义方法
payWithWeChat() {
// 构造支付参数(需从服务器获取)
let payReq = new wxopensdk.PayReq();
payReq.appId = "YOUR_APPID"; // 你的 AppID
payReq.partnerId = "MCH_ID"; // 商户号
payReq.prepayId = "wx28160913994732bfa9d6c3e8a1f58800"; // 预支付交易会话标识
payReq.nonceStr = "5K8264ILTKCH16CQ2502SI8ZNMTM67VS"; // 随机字符串
payReq.timeStamp = "1635678901"; // 时间戳(单位秒)
payReq.package = "Sign=WXPay"; // 固定值
payReq.signType = "MD5"; // 签名类型
payReq.paySign = "F8E8B8D8A8C8E8D8F8A8C8E8D8F8A8C8"; // 支付签名
// 发起支付请求
this.wxApi.sendReq(this.context as common.UIAbilityContext, payReq);
}
3. 处理支付结果回调(重写 onNewWant
方法)
onNewWant(want) {
super.onNewWant(want);
if (want && want.parameters && want.parameters.errCode !== undefined) {
const errCode = want.parameters.errCode;
switch (errCode) {
case 0:
console.info("支付成功");
break;
case -1:
console.error("支付失败(网络问题或其他错误)");
break;
case -2:
console.warn("用户取消支付");
break;
default:
console.warn("未知错误:", errCode);
}
}
}
三、权限声明(config.json
)
确保在项目的 config.json
文件中添加如下权限:
"reqPermissions": [
{ "name": "ohos.permission.INTERNET" },
{ "name": "ohos.permission.GET_NETWORK_INFO", "reason": "检测网络状态" }
]