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

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

但是，华为AppGallery所提供的链接的种类、功能、使用场景越来越多，不熟悉的人看到这各种链接，肯定会非常头大。下面根据我的使用是理解，做了一些AppGallery常用链接与跳转场景的整理，仅供大家参考。

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

1、跳转到AG首页

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

使用方法：使用Intent的action方法，具体动作为：

1	`action：com.huawei.appmarket.intent.action.MainActivity`

相关代码示例：

public void launchAGHomePage() {Intent intent = new Intent("com.huawei.appmarket.intent.action.MainActivity");startActivity(intent);}

2、跳转到AG应用详情页

2.1 应用内通过Intent跳转

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

使用方法：使用Intent的action方法，具体可分为两类：

1、通过APPID：

action：com.huawei.appmarket.appmarket.intent.action.AppDetail. withid

setPackage("com.huawei.appmarket");

name: “appId”, value: “C100170981”

2、通过包名：

action：com.huawei.appmarket.intent.action.AppDetail

setPackage("com.huawei.appmarket");

name: “APP_PACKAGENAME”, value: “com.huawei.browser”

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

参数介绍

参数名	参数类型	备注与取值
appId	String	在AGC页面“我的应用 –> 应用信息”中的APP ID并加上字母C（例如华为浏览器的APPID：C100170981）
APP_PACKAGENAME	String	应用包名，例如华为浏览器的包名：com.huawei.browser

相关代码示例：

// 1、通过APPID：

public void launchAppDetilPage1() {Intent intent = new Intent("com.huawei.appmarket.appmarket.intent.action.AppDetail.withid");intent.setPackage("com.huawei.appmarket");intent.putExtra("appId", "C100170981");startActivity(intent);}

// 2、通过包名packageName”

public void launchAppDetilPage2() {Intent intent = new Intent("com.huawei.appmarket.intent.action.AppDetail");intent.setPackage("com.huawei.appmarket");intent.putExtra("APP_PACKAGENAME", "com.huawei.browser");startActivity(intent);}

2.2 通过URL跳转

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

具体方法：链接地址为：

1	`hiapplink://com.huawei.appmarket?appId=yourAppID&channelId=yourChannelId&referrer=yourReferrer`

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

参数介绍

参数名	参数类型	备注与取值
*yourAppID*	String	用于定位到具体的应用，其值为您的AGC上的AppID：例如，华为浏览器的Appid为C100170981
*yourChannelId*	String	（可选）表示不同的渠道，可用于统计渠道点击量，根据此渠道信息输出报表。例如：HwBrowserSearch
*yourReferrer*	String	（可选）表示不同的归因参数：例如 Keywords

相关代码示例：

1. 通过APPID

public void launchAppDetilWithURL1() {String text1 = "hiapplink://com.huawei.appmarket?appId=C100170981&channelId=HwBrowserSearch&referrer=Keywords";Uri uri = Uri.parse(text1);Intent intent = new Intent(Intent.ACTION_VIEW, uri);startActivity(intent);}

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

典型使用场景：传入包名或者APPID，拉起设备上所有的应用商店，让用户自行选择打开方式，即引导用户选择使用哪个应用市场拉起。选择好打开的应用商店后可以直接跳转到应用的详情页。

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

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

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

3、market://com.huawei.appmarket.applink?appId=APPID" // 仅支持华为应用商店。

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

参数介绍

参数名	参数类型	备注与取值
APPID	String	应用的APPID：例如华为浏览器：C100170981
pkgName	String	应用包名，例如华为浏览器：com.huawei.browser

相关代码示例：

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

public void launchAppDetilOnMarket1() {String text1 = "market://details?id=com.huawei.browser";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=com.huawei.browser";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://com.huawei.appmarket.applink?appId=C100170981";Uri uri = Uri.parse(text1);Intent intent = new Intent(Intent.ACTION_VIEW, uri);startActivity(intent);}

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

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

使用方法：

方法1：https://appgallery.huawei.com/#/app/YOUR_APPID
方法2：https://appgallery.cloud.huawei.com/appDetail?pkgName=pkgName
方法4：https://appgallery.huawei.com/#/app/YOUR_APPID?pkgName=pkgName
方法3：https://appgallery.cloud.huawei.com/marketshare/app/ YOUR_APPID?locale=LOCALE&shareTo=WAP&shareFrom=channeID

参数介绍

参数名	参数类型	备注与取值
YOUR_APPID	String	应用的APPID：例如华为浏览器：C100170981
pkgName	String	应用包名，例如华为浏览器：com.huawei.browser
LOCALE	String	（可选）设置国家和展示语言，例如：zh-CN
WAP	String	（可选）分享到何处，可以自行定义，例如：wap
channeID	String	（可选）分享来源，可以设置渠道统计标识，即渠道号码

示例：

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

https://appgallery.huawei.com/#/app/C100170981

// 2、通过包名

https://appgallery.cloud.huawei.com/appDetail?pkgName=com.huawei.browser

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

https://appgallery.huawei.com/#/app/C100170981?pkgName=com.huawei.browser

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

https://appgallery.cloud.huawei.com/marketshare/app/C100170981?locale=en_US&shareTo=wap&shareFrom=52656

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

图章链接，简单来说，就是有一个AppGallery的图，点击这个图，可以超链接到华为应用市场的应用详情页。应用的营销人员，可以直接将这个图用于投放（其链接的本质，与上述方法4的web链接相同）。

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

创建方法：在AGC首页 -> 点击“应用内分发”-> 即可在应用内分发的界面“制作图章”，即可为已上架的应用制作图章链接。

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

使用指南：

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

下载图章：下载的结果是一个png图片，可以挂在官网或者营销H5页面里。
新增链接：用于标识不同的渠道，例如：Facebook，baidu等
复制链接：可根据不同的渠道下载不同的链接

使用示例：

// 1、典型的链接

https://appgallery.huawei.com/#/app/C100170981?channelId=baidu&referrer=TestBaidu&id=fa09e0f0f3de489386a7180d7b4b3585&s=6E90164FC0CED39CD11D9BE25BE6D1B333FEDCCBCD90A86F29A8DA2400AA4163&detailType=0&v=

// 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界面创建：在AGC首页 -> 点击“我的项目”并选择相应的项目-> 在左侧菜单栏找到“增长”-“ App Linking”。在AppLinking界面先创建链接前缀，然后在创建AppLinking.

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

Android应用内创建：在Android应用内，集成AppLinking SDK，并且通过build.buildAppLinking()等相关代码进行链接的实时创建。

　　该方式主要提供给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、典型的链接前缀

https://photoplaza.drcn.agconnect.link // 其中photoplaza为应用唯一参数，drcn.agconnect.link为系统固定参数。

// 2、典型的AppLinking链接：

https://photoplaza.drcn.agconnect.link/vm3Y

// 3、典型的Android创建AppLinking

private static final String DOMAIN_URI_PREFIX = "https://photoplaza.drcn.agconnect.link";private static final String DEEP_LINK = "https://developer.huawei.com";public void createAppLinking() {

AppLinking.Builder builder = new AppLinking.Builder()

.setUriPrefix(DOMAIN_URI_PREFIX)

.setDeepLink(Uri.parse(DEEP_LINK))

.setAndroidLinkInfo(new AppLinking.AndroidLinkInfo.Builder().build());

String LongAppLinking = builder.buildAppLinking().getUri().toString();

}

// 4、典型的iOS创建AppLinking

- (IBAction)CreatLink:(id)sender {

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

component.uriPrefix = @"https://photoplaza.drcn.agconnect.link";

component.deepLink = @"https://www.developer.huawei.com";

component.iosBundleId = @"com.lucky.agc.demo";

component.iosDeepLink = @"agckit://ios/detail";

self.longlink.text = component.buildLongLink.absoluteString;

7、相关参考链接

图章链接官方文档：https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/appgallery-agd-introduction-stamped

App Linking官方文档：https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-applinking-introduction-0000001054143215

添加归因参数文档：https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/appgallery-referrer-createlink

获取归因信息：https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/appgallery-referrer-develop

原文链接：https://developer.huawei.com/consumer/cn/forum/topic/0201448086867860655?fid=0101271690375130218&pid=0301448086867860778

原作者：Mayism