HarmonyOS 应用拉起系列(一):应用与元服务互通方式

HarmonyOS 5 应用拉起系列(一):应用与元服务互通方式

随着 HarmonyOS 生态的发展,应用之间、应用与元服务之间的互相拉起成为常见的交互方式。结合我平时开发所遇到的场景,将系统总结 HarmonyOS 中几种主流的拉起方式,包括 openLinkstartAbilityopenAtomicServiceFullScreenLaunchComponent,并通过实际代码进行说明,帮助开发者灵活选择、快速集成。

一、HarmonyOS 常见拉起方式对比

下表概览了各类拉起方式的特性、适用场景与限制,方便快速查阅与选型:

拉起方式 描述 典型用途 适用场景 参数要求 特点与限制
openLink 使用 URL Scheme 唤起目标应用 三方跳转、H5 打开 App 适用于已注册 URI 的目标服务 需注册 scheme,例如 myapp://page?param=x 通用性强,依赖目标注册 URI,不能确保一定成功
startAbility 显式或隐式 Want 启动指定 UIAbility 跨应用模块调用、能力联动 应用内跳转、已知 bundleName 的组件跳转 需指定 bundleNameabilityNameaction 功能强大,多用于深度集成,适合系统内交互
openAtomicService 拉起免安装元服务(原子服务) 快速使用外部工具/服务 一键唤起如扫码、识图、剪辑等元服务 设置 actionserviceIdentityappId 支持免安装,需注册为原子服务,调用链受限
FullScreenLaunchComponent 以全屏方式嵌入式启动目标元服务 沉浸式嵌入服务 元服务间联动,如地图内嵌房产展示 需配置 FullScreenLaunchComponent 权限 仅元服务可用,适配复杂、须授权,鸿蒙6前存在兼容性问题

二、各拉起方式使用说明与示例

适用于:已注册 URI scheme 的应用,常见于推广唤端、H5 页面跳转

使用说明:

  • 支持通过 link 字段传入标准 URL,系统基于隐式 want 匹配规则唤起目标应用。
  • 目标应用需声明特定的 actionentities

文档参考:
UIExtensionContext.openLink

代码示例:

ts 复制代码
openLink(link: string, context?: common.UIAbilityContext) {
  let contextP = context ?? getContext() as common.UIAbilityContext;
  let scheme = link.replace('scheme://', '');
  let options: OpenLinkOptions = {
    appLinkingOnly: false,
    parameters: { demo_key: 'demo_value' }
  };
  try {
    contextP.openLink(scheme, options, (err, result) => {
      if (err) {
        LogUtil.e(Tag, `openLink failed: ${JSON.stringify(err)}`);
      } else {
        LogUtil.i(Tag, `openLink result: ${JSON.stringify(result?.resultCode)}`);
      }
    });
  } catch (err) {
    let { code, message } = err as BusinessError;
    LogUtil.e(Tag, `Exception`, 'code', code, 'message', message);
  }
}

// 示例调用
Button('拉起支付宝').onClick(() => {
  new OpenMethod().openLink('alipays://platformapi/startapp');
});

2. 使用 startAbility 显式拉起鸿蒙应用或元服务

适用于:已知目标包名的应用或元服务,适合系统内联动、插件调用等场景

文档参考:
UIAbilityContext.startAbility

代码示例:

ts 复制代码
async startAbility(bundleName: string, abilityName = 'EntryAbility', context?: common.UIAbilityContext) {
  const contextP = context ?? getContext() as common.UIAbilityContext;
  const want: Want = {
    deviceId: '',
    bundleName,
    abilityName
  };

  try {
    await contextP.startAbility(want);
  } catch (err) {
    if (err['code'] === 16000001) {
      // 应用未安装,拉起应用市场
      const fallbackWant: Want = {
        action: 'ohos.want.action.appdetail',
        uri: `store://appgallery.huawei.com/app/detail?id=${bundleName}`,
      };
      contextP.startAbility(fallbackWant).catch((err: BusinessError) => {
        LogUtil.e(Tag, `Fallback failed. Code: ${err.code}, Message: ${err.message}`);
      });
    }
  }
}

// 示例调用
Button('拉起支付宝 (startAbility)').onClick(() => {
  new OpenMethod().startAbility('com.alipay.mobile.client');
});

Button('拉起学习通元服务').onClick(() => {
  new OpenMethod().startAbility('com.atomicservice.5765880207855627899');
});

3. 使用 openAtomicService 快速拉起原子服务(免安装)

适用于:快速使用元服务,如Grab打车、学习通学习、笔记整理等

文档参考:
UIExtensionContext.openAtomicService

代码示例:

ts 复制代码
openAtomicService(appId: string, parameters?: Record<string, Object>, context?: common.UIAbilityContext) {
  const contextP = context ?? getContext() as common.UIAbilityContext;
  const options: AtomicServiceOptions = {
    displayId: 0,
    parameters
  };
  contextP.openAtomicService(appId, options)
    .then(() => {
      LogUtil.d(Tag, 'openAtomicService success');
    })
    .catch((err: BusinessError) => {
      LogUtil.e(Tag, `openAtomicService failed: ${err.code}, ${err.message}`);
    });
}

// 示例调用
Button('拉起学习通 (openAtomicService)').onClick(() => {
  new OpenMethod().openAtomicService('5765880207855627899');
});

4. 使用 FullScreenLaunchComponent 实现嵌入式拉起(沉浸式)

适用于:被拉起方授权后,在调用方中嵌入式运行元服务(如花瓣地图打开安居客)

注意事项:

  • 调试阶段需要开启开发者模式下的元服务豁免设置。
  • 需目标服务支持 ArkTS FullScreenLaunchComponent 接入,主动的进行一定的适配。
  • HarmonyOS 6 之前兼容性较差。

文档参考:
FullScreenLaunchComponent

代码示例:

tsx 复制代码
@Builder
export function AtomicService() {
  Column() {
    Image($r("app.media.startIcon"))
      .width('36vp')
      .height('36vp')
    Text('嵌入式打开元服务').fontSize(10)
  }
}

FullScreenLaunchComponent({
  content: AtomicService,
  appId: '5765880207855627899',
  options: {
    parameters: { jumpAction: 'someAction' }
  }
});

三、使用建议与总结

目标 建议使用方式
打开三方 App(如微信、支付宝) openLink
拉起应用或元服务(本地已安装) startAbility
快速使用免安装元服务 openAtomicService
沉浸式嵌入元服务(需授权) FullScreenLaunchComponent

HarmonyOS 提供了丰富的拉起能力,应根据目标组件的安装状态、是否为元服务、是否授权、是否需沉浸式交互等因素,合理选择最合适的拉起方式。希望这篇文章对你在实际开发中的接入与排查有所帮助!

后面也将继续为大家分享这几种拉起方式在实际中的应用场景,如果需要后续支持「参数传递方式」、「拉起失败兜底策略」、「应用市场跳转兼容性」等更深入的内容,欢迎留言交流!

相关推荐
嵌入之梦4 小时前
鸿蒙智能居家养老系统构思(续二)—— 适老化烹饪中心详细构思
智能家居·harmonyos·居家养老
用户59514332217711 小时前
HarmonyOS开发:ArkUI相对布局RelativeContainer解决层级嵌套较多问题
harmonyos
用户59514332217711 小时前
HarmonyOS开发:ArkUI视觉效果之透明度、渐变、模糊、阴影、高亮一网打尽
harmonyos
用户59514332217711 小时前
HarmonyOS开发:ArkUI线性布局(Column/Row)完全解析
harmonyos
城中的雾11 小时前
HarmonyOS 5 应用拉起系列(一):应用与元服务互通方式
harmonyos
半夜偷删你代码18 小时前
鸿蒙中相册权限弹窗
数码相机·华为·harmonyos
zhanshuo1 天前
鸿蒙系统下的动态负载均衡实战:让分布式任务调度更智能
harmonyos
zhanshuo1 天前
玩转鸿蒙分布式文件共享:让你的设备像一个人一样协作
harmonyos
俺不理解1 天前
纯血鸿蒙 AudioRenderer+AudioCapturer+RingBuffer 实现麦克风采集+发声
音频·鸿蒙·录音·播放·纯血鸿蒙