当前位置：首页 > article >正文

HarmonyOS之深入解析跳转支付宝小程序完成操作后如何自动返回App

article 2025/3/30 19:48:07

一、配置 backSCAppScheme

在跳转支付宝的链接中，添加 backSCAppScheme 参数，指定回调到当前 App 的 Scheme 。例如：

alipays://platformapi/startapp?appId=XXXXXXXXXXXX&backSCAppScheme=myAppScheme

这里的 myAppScheme 是 App 自定义的 Scheme，支付宝完成操作后会通过该 Scheme 回调到当前的 App。

二、注册 Scheme

为了让 App 能够接收支付宝的回调，需要在 HarmonyOS 应用的 module.json5 中注册对应的 Scheme。例如：

{
  "module": {
    "name": "entry",
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "phone"
    ],

    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:logo_launcher",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:logo_login",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "actions": [
              "ohos.want.action.view"
            ],
            "uris": [
              {
                "scheme": "myAppScheme"
              }
            ]
          }
        ]
      }
    ]
  }
}

这样，当支付宝通过 myAppScheme:// 回调时，系统会将回调路由到 App。

三、处理 Scheme 回调

在 HarmonyOS 中，可以通过 UIAbility 的 onCreate 方法监听 Scheme 回调，并执行跳转回 App 的逻辑。以下是一个示例代码：

import UIAbility from '@ohos.app.ability.UIAbility';
import Want from '@ohos.app.ability.Want';
import router from '@ohos.router';

export default class EntryAbility extends UIAbility {

  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
  }

  onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    // 获取支付宝返回的 Scheme URL
    const returnedUrl = want.uri;
    if (returnedUrl && returnedUrl.startsWith('myAppScheme://')) {
      
    }
  }
}

四、拉起支付宝功能

在 HarmonyOS 中，可以通过 UIAbilityContext 模块拉起支付宝功能。例如：

import { common, Want, Permissions } from '@kit.AbilityKit'

let url = 'alipays://platformapi/startapp?appId=XXXXXXXXXXXX&backSCAppScheme=myAppScheme'
let context = getContext(this) as common.UIAbilityContext
    let want: Want = {
      uri: url,
    };
    context.startAbility(want)
      .then(() => {
        Router.back()
        console.info('Open link succeeded.');
      })
      .catch((err:BusinessError) => {
        console.error(`Open link failed, code is ${err.code}, message is ${err.message}`);
      });