鸿蒙 next 元服务实现 app linking 功能

作者：flfljh

2024-12-19
湖南
本文字数：1373 字
阅读完需：约 5 分钟

1.前置信息

关于鸿蒙 next 元服务的 app linking 官方文档为: https://developer.huawei.com/consumer/cn/doc/atomic-guides-V5/atomic-applinking-V5

通过阅读上方的官方文档，那么需要实现两个功能，一个是如果需要跳转指定页面的元服务，那么则需要解析传来的pagePath参数，链接与参数是通过 AppGrallery Connect → App Liking 中去生成。第二个功能是可以在使用代码根据链接跳转元服务。
AppGrallery Connect → App Liking 生成的链接既可以在程序中使用，也可以在短信链接中使用。

有了上面这些信息就可以实现逻辑，这里封装了一个 AppLinkingUtils工具类。

2.实现`AppLinkingUtils`工具类

import { common, Want, wantAgent } from '@kit.AbilityKit';import { GlobalContext } from './GlobalContext';import { router } from '@kit.ArkUI';import { AppUtil } from './AppUtil';import { BusinessError } from '@kit.BasicServicesKit';import { LogUtil } from './LogUtil';
interface MessageReceivedParams {  want?: Want  method: "onCreate" | "enterDnTabBarPage"}
/** * 官方文档: https://developer.huawei.com/consumer/cn/doc/atomic-guides-V5/atomic-applinking-V5 */export class AppLinkingUtils {  static messageReceived(params: MessageReceivedParams) {    if (params.want) {      const want = params.want;      const url = want?.uri;      const pagePath = want.parameters?.['pagePath'] as string;
      if (pagePath) {        GlobalContext.getContext().setObject("appLinkingPagePath", pagePath);      }    }
    if (params.method == "enterDnTabBarPage") {      const appLinkingPagePath = GlobalContext.getContext().getObject("appLinkingPagePath") as string;      if (appLinkingPagePath) {        GlobalContext.getContext().deleteObject("appLinkingPagePath");        router.pushUrl({          url: appLinkingPagePath        })      }    }  }
  static openLink(url: string) {    let context: common.UIAbilityContext = AppUtil.getContext();    // link 可替换成开发者自行配置的元服务链接    let link = url || "https://hoas.drcn.agconnect.link/9P7g";    context.openLink(link)      .then(() => {        LogUtil.info('openlink success.');      })      .catch((error: BusinessError) => {        LogUtil.error(`openlink failed. error:${JSON.stringify(error)}`);      });  }}

复制代码

messageReceived 的需要在两个地方去调用

1.在 EntryAbility 的 onCreate 方法中调用

export default class EntryAbility extends UIAbility  {  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');    AppUtil.init(this.context)
    AppLinkingUtils.messageReceived({      want: want,      method: "onCreate"    })
  }
}

复制代码

2.在完成数据加载进入 tab 首页时调用

@Preview@Entry@Componentstruct DnTabBarPage {  aboutToAppear() {        AppLinkingUtils.messageReceived({      method: "enterDnTabBarPage"    })  }}

复制代码

发布于: 刚刚阅读数: 4

flfljh

关注

还未添加个人签名 2024-10-29 加入

还未添加个人简介

发布

暂无评论

创作场景

鸿蒙 next 元服务实现 app linking 功能

1.前置信息

2.实现AppLinkingUtils工具类

messageReceived 的需要在两个地方去调用

1.在 EntryAbility 的 onCreate 方法中调用

2.在完成数据加载进入 tab 首页时调用

flfljh

评论

2.实现`AppLinkingUtils`工具类