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

HarmonyOS 应用内拉起评论页，DeepLink 方案只要 10 行代码

news 2026/6/7 7:28:01

文章目录

- - 什么是 DeepLink，跟普通跳转有什么区别
  - 核心实现：就这几行
  - 接入到 UI 里
  - 错误处理别省
  - 跟方式2（App Linking）对比
  - 版本要求
  - 写在最后

做 HarmonyOS 应用的时候，经常有这样一个需求：用户在设置页点击"给我们评分"，然后直接跳到华为应用市场的评论页。

这需求听起来简单，但你翻文档可能翻半天。其实用 DeepLink 实现是最直接的一种方式，核心代码不超过 10 行，而且不依赖任何额外权限配置。

什么是 DeepLink，跟普通跳转有什么区别

DeepLink（深度链接）本质上就是一个 URI，系统根据 URI 的格式找到能处理它的应用并打开。

跟普通的startAbility指定包名跳转不同，DeepLink 用的是隐式跳转——你不指定目标的包名和组件名，只告诉系统"我要打开一个能处理这个 URI 的 Ability"。具体跳到哪，系统说了算。

对于拉起应用市场评论页，华为定义了这样的 URI 格式：

store://appgallery.huawei.com/app/detail?id=<包名>&action=write-review

id是你要评论的应用包名，action=write-review告诉应用市场进入详情页后立刻弹出写评论的入口。

核心实现：就这几行

先看完整代码：

import{BusinessError}from'@kit.BasicServicesKit';import{hilog}from'@kit.PerformanceAnalysisKit';importtype{common,Want}from'@kit.AbilityKit';constTAG='StartAppGalleryDetailAbilityView';// 在你的 @Component 中privatecontext:common.UIAbilityContext=this.getUIContext().getHostContext()ascommon.UIAbilityContext;startDetailWithDeepLink(bundleName:string):void{letwant:Want={// 隐式指定 action，让系统找到能处理 appdetail 的应用（即应用市场）action:'ohos.want.action.appdetail',// uri 中携带目标包名和 write-review 动作uri:`store://appgallery.huawei.com/app/detail?id=${bundleName}&action=write-review`};this.context.startAbility(want).then(()=>{hilog.info(0x0001,TAG,`Succeeded in starting Ability successfully.`);}).catch((error:BusinessError)=>{hilog.error(0x0001,TAG,`Failed to startAbility. Code:${error.code}, message is${error.message}`);});}

几个关键点说一下：

action: 'ohos.want.action.appdetail'
这是华为定义的隐式 action，只有华为应用市场（AppGallery）注册了对这个 action 的响应。系统会找到它并拉起。

uri中的store://协议
这是应用市场专属的 URI 协议头，配合action=write-review参数，打开后会直接引导用户写评论，而不是只停在应用详情页。

context 的获取方式
this.getUIContext().getHostContext()是在 ArkUI 组件里获取 UIAbilityContext 的标准方式，别用老的getContext(this)了，API 22 之后推荐这种写法。

接入到 UI 里

实际项目中通常是在设置页的某一行点击触发，绑定onClick事件就好：

Row(){Text('五星好评').fontSize(14).fontWeight(FontWeight.Medium)Image($r('app.media.advanceIcon')).width(6.74).height(12.81)}.width('85%').height(48).justifyContent(FlexAlign.SpaceBetween).onClick(()=>{// 替换成你自己的应用包名this.startDetailWithDeepLink('com.example.myapp');});