从5.0.3(15)版本开始,新增支持直达应用市场能力。
当成功配置App Linking应用链接后,可以构建App Linking直达应用市场下载详情页链接。当应用已安装时,点击链接直接跳转应用;当应用未安装时,点击链接跳转应用市场下载详情页,引导用户下载应用。
| 华为分享打开场景 | 其他社交APP打开场景 |
|---|---|
![]() | ![]() |
只能获取通过App Linking域名校验的应用链接,请参见在HarmonyOS 开发者中心为应用创建关联的网址域名。
支持接入直达应用市场能力的服务:华为分享、碰一碰分享、短信、畅联以及其他支持openLink API的场景。
暂不支持接入的服务:浏览器、扫码(规划中,上线后自动生效,无需适配)。
配置直达应用市场能力。
登录HarmonyOS 开发者中心,进入“应用管理”页面。
选择目标应用后,左侧导航栏选择“推广运营 > 增长运营 > App Linking > 应用链接”,点击“操作”列的“直达应用市场”。

在配置页面,下拉选择与该域名关联的在架应用,为应用配置直达应用市场链接。

可以点击“添加应用”为多个应用配置直达链接,当该域名下关联的在架应用全部配置后,无法再添加应用。
可以根据以下规则配置直达链接。
| 路径 | 匹配规则 |
|---|---|
| path | 精确匹配 |
| pathStartWith | 前缀匹配 |
| pathRegex | 正则表达式匹配 |
如果在module.json5中配置关联的网址域名时,未配置path、pathStartWith或pathRegex,必须是如下匹配规则之一:
pathRegex,匹配路径:.*
path,手动输入精确匹配的路径(不允许以“/”开头,不允许出现双斜杠“//”和“..”,允许包含字母(a-z、A-Z)、数字(0-9)、正斜杠“/”、点“.”、下划线“_”和连字符“-”)
(不推荐)如果在module.json5中配置关联的网址域名时,path匹配规则中配置了pathRegex,且值为.*,可以包含如下匹配规则:
pathRegex,匹配路径:.*
path,手动输入精确匹配的路径(不允许以“/”开头,不允许出现双斜杠“//”和“..”,允许包含字母(a-z、A-Z)、数字(0-9)、正斜杠“/”、点“.”、下划线“_”和连字符“-”)
其他场景需要根据在module.json5中配置关联的网址域名时配置的path匹配规则进行选择。
可以点击“删除链接”删除当前关联应用的直达应用市场链接。
配置完成后,点击页面顶部的“发布”,会跳转到“应用链接”列表页面。
如下图,“是否配置直达应用市场”显示“是”,表示链接配置成功。
链接配置成功后,一般需要24~48小时才能生效,请耐心等待。

验证应用被拉起效果。
方式一:将直达应用市场链接地址存入备忘录中,并点击验证该链接是否可以拉起应用。
方式二:通过openLink接口拉起应用。
拉起方应用需调用UIAbilityContext.openLink()接口,并将appLinkingOnly参数设为false或者不传,以App Linking优先的方式打开应用。
在“entry/src/main/ets/common”目录下添加GlobalContext.ets文件,开发初始化和获取应用上下文的接口。
import { common } from '@kit.AbilityKit';
export class GlobalContext {
private static context: common.UIAbilityContext;
public static initContext(context: common.UIAbilityContext): void {
GlobalContext.context = context;
}
public static getContext(): common.UIAbilityContext {
return GlobalContext.context;
}
} 在“entry/src/main/ets/entryability/EntryAbility.ets”文件中导入GlobalContext,在onCreate方法中使用GlobalContext.initContext(this.context)初始化全局应用上下文。
在“entry/src/main/ets/pages/Index.ets”文件中,使用UIAbilityContext.openLink()接口配置跳转链接。
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { GlobalContext } from '../common/GlobalContext';
// ...
@Entry
@Component
struct Index {
// ...
build() {
// ...
Button('start link market', { type: ButtonType.Capsule, stateEffect: true })
.width('100%')
.height(40)
.margin({ top: '20vp' })
.onClick(() => {
let context = GlobalContext.getContext();
let link: string = 'https://www.example.com/product?pageName=productDetail';
context.openLink(link, { appLinkingOnly: false })
.then(() => {
hilog.info(0x0000, 'testTag', `Succeeded in opening link.`);
})
.catch((error: BusinessError) => {
hilog.error(0x0000, 'testTag', `Failed to open link, code: ${error.code}, message: ${error.message}`);
})
})
// ...
}
// ...
} 安装拉起方应用,点击拉起方应用中的跳转按钮。
此时目标应用未安装,若有App Linking相匹配的应用,点击链接会跳转应用市场下载详情页,引导用户安装应用;若无App Linking相匹配的应用,则继续尝试以浏览器打开链接的方式打开应用。
安装目标方应用后,点击拉起方应用的跳转按钮,会直接打开应用。
当开发者通过系统浏览器或ArkWeb拉起目标应用时,如果目标应用未安装,不会直接跳转应用市场,需要开发者根据自身业务自行实现跳转应用市场的能力。详细可参见“Web和应用的跳转与拉起”开发实践中的“ArkWeb页面指定应用跳转”章节。