# AppGalleryKit-Codelab-Clientdemo-ArkTS

**Repository Path**: harmonyos_codelabs/appgallerykit-codelab-clientdemo-arkts

## Basic Information

- **Project Name**: AppGalleryKit-Codelab-Clientdemo-ArkTS
- **Description**: 此Codelab实现了展示应用详情页下载安装目标应用、查询广告验签版本、获取模块安装信息、添加按需加载模块、检查应用更新、应用归因服务和隐私管理服务等功能。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-25
- **Last Updated**: 2025-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 应用市场服务（ArkTS）

## 简介

基于Stage模型，实现了展示应用详情页下载安装目标应用、展示元服务详情页添加至桌面、查询广告验签标签版本、获取模块安装信息和添加按需加载模块、应用市场更新和应用归因服务、查询隐私链接等功能。

效果图如下：

![](screenshots/device/codelabs.jpg)
![](screenshots/device/loadproduct.jpg)
![](screenshots/device/loadinstall.jpg)
![](screenshots/device/getAdsVerificationVersion.jpg)
![](screenshots/device/updateSDK_cn.jpg)
![](screenshots/device/attribution.jpg)
![](screenshots/device/attributionTest.jpg)
![](screenshots/device/getAppPrivacyMgmtInfo.jpg)
![](screenshots/device/requestappprivacyconsent.jpg)
![](screenshots/device/addshortcuttodesktop.jpg)
![](screenshots/device/dynamiciconmanager_cn.jpg)



## 工程目录


```
    ├─ets
       ├─common
       │  ├─bean
       │     └── EntryItemInfo.ets   // 页面入口工具类
       │  └─utils
       │     └── SignUtil.ets
       ├─entryability
       │      └──EntryAbility.ets    // 本地启动ability
       └─pages
            └── AddShortcutToDesktop.ets    // 快捷方式加桌功能
            └── Attribution.ets    // 登记归因来源 登记归因转化事件
            └──AttributionTest.ets     // 验证归因来源信息 设置归因回传 触发归因结果回传 
            └──CheckUpdatePage.ets     // 升级功能入口
            └──GetAdsVerificationVersion.ets   // 查询广告验签功能
            └── GetAppPrivacyMgmtInfo.ets     // 查询隐私链接信息 
            └── IndexPage.ets    // 功能选择入口
            └── LoadInstallService.ets   // 获取模块安装信息 添加按需加载模块             
            └── LoadProduct.ets      // 应用详情页下载安装
            └── RequestAppPrivacyConsent.ets      // 拉起标准化隐私弹框
            └── DynamicIconManager.ets        // 应用动态图标管理
```
## 相关概念

不涉及

## 相关权限

不涉及

## 使用说明

1.应用包括Load Product、Load Install、Check update、attribution、attributionTest等模块

2.点击Load Product，展示应用详情页，下载安装目标应用

3.点击Load Install，进入产品特性按需分发页面

4.点击getAdsVerificationVersion,返回广告验签版本

5.点击Check update，进入应用更新相关页面

6.点击requestAppPrivacyConsent,拉起标准化隐私弹框

7.点击attribution，进入应用归因服务页面登记广告归因来源和登记转化事件

8.点击attributionTest，进入应用归因服务接入调试能力页面

9.点击getAppPrivacyMgmtInfo，查询隐私链接信息

10.点击addShortcutToDesktop，创建应用内快捷方式加桌

11.点击DynamicIconManager，进入应用图标管理页面

### Load Product接口调用说明
步骤一：填写bundlename，codelabs中为华为阅读包名

步骤二：编译安装demo，点击Load Product按钮,拉起华为阅读应用详情页

### 产品特性按需分发功能接口调用说明

一共有两个模块，包括1个hap包模块entry，以及1个hsp包模块AModulelib。

如果需要动态加载某个模块，需要将该demo应用，及demo应用下的各个HSP、HAP等上架到应用市场。

上架应用市场后，从应用市场下载该demo应用，然后才能动态加载模块。

包括查询模块已安装信息，请求加载模块接口：

* getInstalledModule()
* fetchModules()


步骤一：前置步骤：

     - 连接可用的网络。

     - 安装最新版本应用市场。

     - 刷最新版本rom。

步骤二：通过应用市场下载安装应用A，此时安装的应用A只是基础包，无法使用功能包模块B的功能。

步骤三：在应用A内，用户可选择下载功能包模块B。

步骤四：下载安装完成之后，用户可使用应用A的功能包模块B的功能。

### getAdsVerificationVersion接口调用说明

步骤一：点击getAdsVerificationVersion按钮

步骤二：返回广告验签版本, 当前返回值为1。 广告场景中开发者需要在want参数中携带以下参数：ohos.market.param.signature、
ohos.market.param.ad_networkid、ohos.market.param.timestamp、ohos.market.param.verify_version、
ohos.market.param.ad_nonce，验签时会根据want中这些字段值使用公钥进行验签。



### 应用归因功能及调试功能接口调用说明 （API version 12及以上支持）

共5个接口，其中validateSource()、setPostback()、flushPostbacks()是应用归因接入调试功能接口
* registerSource()
* registerTrigger()
* validateSource()
* setPostback()
* flushPostbacks()

#### 测试前准备：

    - adTechId获取

    - triggerdata获取

    - signature计算规则


##### adTechId获取

步骤一：登录华为开发者联盟网站

步骤二：点击“管理中心”进入生态服务中心

步骤三：点击“生态服务>应用服务>开发服务”下的“应用市场服务”卡片，进入应用归因云端管理平台

步骤四：注册广告生态伙伴角色：广告平台

步骤五：审核通过后，查看广告平台归因角色ID


##### triggerdata获取

步骤一：登录华为开发者联盟网站

步骤二：通过点击“管理中心”进入生态服务中心

步骤三：点击“生态服务>应用服务>开发服务”下的“应用市场服务”卡片，进入应用归因云端管理平台

步骤四：注册广告生态伙伴角色：广告主

步骤五：点击转化事件，查看转化事件编码

##### signature计算规则

步骤一：生成RSA3072非对称密钥

步骤二：将公钥注册到应用归因云端管理平台

步骤三：生成需要签名的内容，格式如下

mmpIdStr:string = mmpId1 + '\u2063' + mmpId2
signContent: string= adTechId+ '\u2063' + campaignId+ '\u2063' + destinationId+ '\u2063' + serviceTag+ '\u2063' + mmpIdStr + '\u2063' + nonce + '\u2063' + timestamp

步骤四：import {AegRsaSign} from "@hw-agconnect/petal-aegis" ， 使用AegRsaSign.ohAegSignRSAWithPSSTextBase64生成签名，使用方法如下

>[@hw-agconnect/petal-aegis](https://ohpm.openharmony.cn/#/cn/detail/@hw-agconnect%2Fpetal-aegis)

> [ohAegSignRSAWithPSSTextBase64使用方法](https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-References/ohaegsignrsawithpsstextbase64-0000001864508922)

#### 接口调用步骤 

步骤一：点击“Register Source”按钮，会调用registerSource接口，该接口会返回是否登记归因来源成功。

步骤二：点击“registerTrigger”按钮，会调用registerTrigger()接口，该接口会返回是否登记转化成功。

步骤三：点击“validateSource”按钮，会调用validateSource()接口，该接口会返回是否验证归因来源信息成功。

步骤四：点击“setPostback”按钮，会调用setPostback()接口，该接口返回是否设置归因结果成功。

步骤五：点击“flushPostbacks”按钮，会调用flushPostbacks()接口，该接口返回是否触发归因结果回传成功。



### 升级功能接口调用说明（API version 12及以上支持）

* checkAppUpdate()
* showUpdateDialog()


步骤一：点击“点我调用检查更新接口”，会调用checkAppUpdate接口，该接口会返回是否有版本更新

步骤二：当有版本更新时，点击“点我调用显示Dialog接口”，会显示出更新版本的对话框。

### getAppPrivacyMgmtInfo接口调用说明（API version 12及以上支持）

步骤一：应用需要接入[隐私声明托管服务](接入地址：https://developer.huawei.com/consumer/cn/doc/app/agc-help-harmonyos-privacystatementguide-0000001757041969)

步骤二：应用接入隐私托管之后，可以查询隐私链接信息及拉起标准化隐私弹框（备注：如果应用没有接入隐私托管，调用接口会返回错误码：1006700003）

### 快捷方式加桌接口调用说明（API version 12支持）

* checkPinShortcutPermitted()
* requestNewPinShortcut()

步骤一：点击“checkPinShortcutPermitted with resName”按钮，携带资源索引名称调用checkPinShortcutPermitted()接口，返回是否允许快捷方式加桌结果；

点击“checkPinShortcutPermitted with file”按钮，携带快捷方式名称以及icon文件调用checkPinShortcutPermitted()接口，返回是否允许快捷方式加桌结果；

（注：文件方式需要提前预置一张前景图和一张背景图（非必须）到沙箱中并按实际路径修改源代码，例	如：/data/storage/el2/base/haps/entry/files/boat.svg，两种检查方式选择一种即可）；

步骤二：点击“requestNewPinShortcut”按钮，该接口会携带步骤一的检查结果并弹出加桌确认框，点击“确认”会把快捷方式加到桌面。

### 动态图标接口调用说明（API version 15支持）
* queryDynamicIcons()
* selectDynamicIcon(iconId: string)
* disableDynamicIcon()

前提：需要在AGC页面动态管理应用上[提交个性化图标](参考指南：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/appgallery-appinfo-manage)，才能在应用侧实现应用图标动态切换。

步骤一：点击“queryDynamicIcons”按钮，查询已上架审核通过且成功下发的动态图标信息；

步骤二：点击“selectDynamicIcon: {iconId}”按钮，并传入步骤1中查询得到的动态图标ID，改变当前应用的图标；

步骤三：点击“disableDynamicIcon”按钮，禁用动态图标，禁用后会显示应用的默认图标。


### 约束与限制

1.本示例仅支持标准系统上运行，支持设备：华为手机、平板、2in1/PC。

2.HarmonyOS系统：HarmonyOS 6.0.0 Release及以上。

3.DevEco Studio版本：DevEco Studio 6.0.0 Release及以上。

4.HarmonyOS SDK版本： HarmonyOS 6.0.0 Release SDK及以上。

5.本示例需要安装14.0.1.300以上版本应用市场。