2023年11月28日发(作者：三星s20u参数)

华为AppGallery常⽤跳转与链接详解

当前华为应⽤市场（AppGallery，以下简称AG）的功能越来越全，页⾯也越来越多，随着⽽来的，是对于个各种页⾯跳转的需求越来越旺盛。

但是，华为AppGallery所提供的链接的种类、功能、使⽤场景越来越多，不熟悉的⼈看到这各种链接，肯定会⾮常头⼤。下⾯根据我的使⽤是理解，做了⼀些

AppGallery常⽤链接与跳转场景的整理，仅供⼤家参考。

下⾯各种链接的介绍，主要按照使⽤场景来划分，如有错误，还请⼤家指正。

1、跳转到AG⾸页

典型使⽤场景：需要从开发者应⽤内，拉起跳转到应⽤市场⾸页，让⽤户⾃⾏搜索相关的应⽤或者活动。

使⽤⽅法：使⽤Intent的action⽅法，具体动作为：

1

action：tivity

相关代码⽰例：

public void launchAGHomePage() {

Intent intent = new Intent("tivity");

startActivity(intent);

}

2、跳转到AG应⽤详情页

2.1 应⽤内通过Intent跳转

典型使⽤场景：应⽤内拉起跳转到应⽤详情页，应⽤⽤户进⾏评分评论等操作。

使⽤⽅法：使⽤Intent的action⽅法，具体可分为两类：

1、 通过APPID：

1

action：ail. withid

2

setPackage("ket");

3

name: “appId”, value: “C100170981”

2、通过包名：

1

action：ail

2

setPackage("ket");

3

name: “APP_PACKAGENAME”, value: “r”

注意点：如果使⽤⽅式1即APPID的⽅式，⽐使⽤包名的⽅式，action中多了appmarket以及withid参数。

参数介绍

参数名参数类型备注与取值

appIdString

APP_PACKAGENAMEString

相关代码⽰例：

// 1、通过APPID：

public void launchAppDetilPage1() {

Intent intent = new Intent("");

kage("ket");

ra("appId", "C100170981");

在AGC页⾯“我的应⽤ –> 应⽤信息”中的APP ID并加上字母C（例如华为浏览器的APPID：

C100170981）

应⽤包名，例如华为浏览器的包名：r

startActivity(intent);

}

// 2、通过包名packageName”

public void launchAppDetilPage2() {

Intent intent = new Intent("ail");

kage("ket");

ra("APP_PACKAGENAME", "r");

startActivity(intent);

}

2.2 通过URL跳转

典型使⽤场景：⽤户通过分享的URL链接等场景，直接点击URL跳转到应⽤详情页。

具体⽅法：链接地址为：

1

hiapplink://ket?appId=yourAppID&channelId=yourChannelId&referrer=yourReferrer

注意点：斜体加粗部分为⼿动修改的变量，其余为固定值。

参数介绍

参数名参数类型备注与取值

yourAppID

yourChannelId

yourReferrer

相关代码⽰例：

1. 通过APPID

public void launchAppDetilWithURL1() {

String text1 = "hiapplink://ket?appId=C100170981&channelId=HwBrowserSearch&referrer=Keywords";

Uri uri = Uri.parse(text1);

Intent intent = new Intent(Intent.ACTION_VIEW, uri);

startActivity(intent);

}

String

String

String

⽤于定位到具体的应⽤，其值为您的AGC上的AppID：例如，华为浏览器的Appid为

C100170981

（可选）表⽰不同的渠道，可⽤于统计渠道点击量，根据此渠道信息输出报表。例如：

HwBrowserSearch

（可选）表⽰不同的归因参数：例如 Keywords

3、market拉起所有本地商店并跳转详情页

典型使⽤场景：传⼊包名或者APPID，拉起设备上所有的应⽤商店，让⽤户⾃⾏选择打开⽅式，即引导⽤户选择使⽤哪个应⽤市场拉起。选择好打开的应⽤商店后

可以直接跳转到应⽤的详情页。

使⽤⽅法：通过传⼊scheme 为market:// 的链接，Android⽀持的标准的market协议，可拉起Android设备上的所有应⽤商店。有如下两种⽅式：

1、market://details?id=pkgName // ⽀持所有商店

2、appmarket://details?id=pkgName // 仅⽀持华为应⽤商店。

3、market://k?appId=APPID" // 仅⽀持华为应⽤商店。

注意点：⽅法1通过market://传⼊包名的⽅式，为Android标准⽅法，在所有应⽤商店中均可使⽤，例如GP，应⽤包等；。

参数介绍

参数名参数类型备注与取值

APPIDString

pkgNameString

相关代码⽰例：

应⽤的APPID：例如华为浏览器：C100170981

应⽤包名，例如华为浏览器：r

// 1、⽅式1：market:// + 包名

public void launchAppDetilOnMarket1() {

String text1 = "market://details?id=r";

Uri uri = Uri.parse(text1);

Intent intent = new Intent(Intent.ACTION_VIEW, uri);

startActivity(intent);

}

// 2、⽅式2：appmarket:// + 包名

public void launchAppDetilOnMarket2() {

String text1 = "appmarket://details?id=r";

Uri uri = Uri.parse(text1);

Intent intent = new Intent(Intent.ACTION_VIEW, uri);

startActivity(intent);

}

3、⽅式3：market:// + 华为商店 + APPID

public void launchAppDetilOnMarket3() {

String text1 = "market://k?appId=C100170981";

Uri uri = Uri.parse(text1);

Intent intent = new Intent(Intent.ACTION_VIEW, uri);

startActivity(intent);

}

4、链接到web AG的应⽤详情页

典型使⽤场景：应⽤的官⽹或者web投放等场景，⽤户点击web链接，直接拉起AppGallery中应⽤的详情页⾯，引导⽤户安装。

使⽤⽅法：

参数介绍

参数名参数类型备注与取值

⽰例：

// 1、最短链接：通过APPID

// 2、通过包名

// 3、APPID与包名组合使⽤

// 4、详细链接并且加上可选参数(不常⽤，⼀般在图章中使⽤)

5、图章链接到AG的应⽤详情页

图章链接，简单来说，就是有⼀个AppGallery的图，点击这个图，可以超链接到华为应⽤市场的应⽤详情页。应⽤的营销⼈员，可以直接将这个图⽤于投放（其链

接的本质，与上述⽅法4的web链接相同）。

典型使⽤场景：对于与上架的应⽤，营销⼈员希望通过图章链接，在官⽹上导流到应⽤商店，或者直接⽤于投放。

创建⽅法：在 -> 点击“应⽤内分发”-> 即可在应⽤内分发的界⾯“制作图章”， 即可为已上架的应⽤制作图章链接。

注意点：仅已上架的应⽤才能制作图章，并且每个应⽤只能创建⼀个图章；如果应⽤已创建图章，则只能在 “图章查询”中查看。

使⽤指南：

图章创建以后，即可在“图章查询”页签中，查看当前已经创建的图章， 你可以在该界⾯，下载图章或者复制链接：

下载图章：下载的结果是⼀个png图⽚，可以挂在官⽹或者营销H5页⾯⾥。

新增链接：⽤于标识不同的渠道，例如：Facebook，baidu等

复制链接：可根据不同的渠道下载不同的链接

使⽤⽰例：

// 1、典型的链接

// 2、使⽤典型的图章，在⽹站中嵌⼊该图章，点击即可跳转到应⽤详情下载页，使⽤实例如下：

6、跨平台的App Linking链接

App Linking 是华为AppGallery Connect推出的⼀项新的服务，⼤家知道和接触的⽐较少，因此下⾯的介绍会更加详细并且更加通俗，帮助⼤家更好的理解这个

AppLinking是什么：App Linking就是⼀个可以跨平台(Android，iOS，PC-Browser)使⽤的链接，对标于Firebase的Dynamic Link功能，帮助应⽤开发者快速构建

跨平台的分享链接。

AppLinking⽤在哪：⽐如说⼀个应⽤在Android和iOS都有发布，此时有个促销活动需要各个平台的⽤户参与；该活动的邀请链接，在Android和iOS上都要能够⽣

效，并且对于在PC浏览器打开的⽤户，也能够浏览相应的活动H5页⾯。

使⽤AppLinking后有什么效果：

⼿机上已安装该应⽤：AppLinking链接将⾃动拉起应⽤，并且跳转到指定页⾯，

⼿机上未安装该应⽤：链接将提⽰你通过应⽤市场打开，可配置为华为AppGallery或者本地应⽤商店，下载并安装好应⽤以后，仍可打开指定页⾯。

AppLinking怎么⽤：AppLinking有三种创建⽅式：适⽤于不同的场景：

AGC界⾯创建：在 -> 点击“我的项⽬”并选择相应的项⽬-> 在左侧菜单栏找到“增长”-“ App Linking”。在AppLinking界⾯先创建链接前缀，然后在创建

AppLinking.

该⽅式主要给不懂代码的营销同事使⽤，但⾥⾯使⽤到的深度链接地址，还是需要跟开发同事获取。

Android应⽤内创建：在Android应⽤内，集成AppLinking SDK，并且通过ppLinking()等相关代码进⾏链接的实时创建。

该⽅式主要提供给Android⽤户的实时创建，⽐如应⽤内的活动页⾯，添加⼀个分享按钮，点击分享按钮，就创建⼀个AppLinking链接。

iOS应⽤内创建：和Android应⽤⼀样，这个就是在iOS应⽤内，使⽤代码进⾏链接创建。

该⽅式主要提供给iOS⽤户，让iOS⽤户在应⽤通过代码实时创建并且分享。

⾮华为⼿机上怎么⽤：

AppLinking是跨平台的，也即适⽤于所有Android和iOS，那肯定很多同学关⼼“在⾮华为的Android⼿机上怎么使⽤AppLinking？”这个问题，下⾯这⽅⾯问题做相

应的解答：

1、 ⾮华为⼿机能否使⽤AppLinking？—— App Linking不依赖HMS Core，可以在所有Android设备上使⽤，GMS和HMS设备通⽤。

2、 应⽤未安装且⼿机上未安装华为应⽤市场，AppLinking怎么⽤？ —— 对于没有安装AppGallery的Android⼿机，可以将AppLinking配置为 本地应⽤市场打开，

这样Android系统就会引导让你选择通过哪个商店商店打开，只要你的包名⼀致，可以任何商店的应⽤详情页。

使⽤⽰例

// 1、典型的链接前缀

// 2、典型的AppLinking链接：

// 3、 典型的Android创建AppLinking

1

privatestaticfinalString DOMAIN_URI_PREFIX = "";privatestaticfinalString DEEP_LINK = "";publicvoidcreateAppLinking() {

2

r builder = newr()

3

.setUriPrefix(DOMAIN_URI_PREFIX)

4

.setDeepLink((DEEP_LINK))

5

.setAndroidLinkInfo(newr().build());

6

String LongAppLinking = ppLinking().getUri().toString();

7

}

// 4、典型的iOS创建AppLinking

1

2

- (IBAction)CreatLink:(id)sender {

AGCAppLinkingComponents *component = [[AGCAppLinkingComponents alloc] init];

3

fix = @"";

4

nk = @"";

5

dleId = @"";

6

pLink = @"agckit://ios/detail";

7

= teString;

7、相关参考链接

原作者：Mayism