【FAQ】HarmonyOS SDK 闭源开放能力 — AppGallery Kit

1.问题描述：

生产分阶段发布时，为什么只能设置百分比，能否支持指定账号发布？

解决方案：

目前在 HarmonyOS 的分阶段发布中，只支持通过设置百分比来控制发布的流量比例，而不直接支持指定账号的发布方式。如果有特定的需求，如基于账号的发布控制，可能需要考虑在应用内部实现相应的控制逻辑，例如在应用后端添加对特定账号的版本控制策略。

2.问题描述：

分阶段发布百分比设置后，无人收到通知是什么原因？

解决方案：

确认生效时间是否到期，且分阶段发布的应用/元服务必须存在全网在架的版本，参考：前提条件。

3.问题描述：

分阶段发布是只发布给已经安装该应用的用户；还是只要有设备的用户都可以能看到？未安装的用户是否可以下载分阶段发布的版本？未安装的用户下载的版本是什么？

解决方案：

分阶段发布是按照使用 HarmonyOS 设备的用户百分比覆盖自动更新新版本。

未安装的用户可通过搜索应用直接安装分阶段发布版本；未安装的用户下载的版本是分阶段发布版本。

4.问题描述：

点击 H5 网页中的 Applinking 链接，未拉起应用是什么原因？

解决方案：

ArkWeb 深度集成了 App Linking 的能力，当用户在系统浏览器或者集成 ArkWeb 的应用的网页上点击某个链接时，若有链接匹配的应用，系统则会通过 App Linking 能力优先拉起目标应用，并在应用内展示相应的内容。此机制有如下限制：

如果用户当前浏览的网页的域名与点击的 App Linking 链接的域名是相同的，则系统会继续在系统浏览器或 ArkWeb 中打开该链接，以维持连贯的用户浏览体验。

如果域名不相同，则系统会通过 App Linking 能力优先拉起目标应用，并在应用内展示相应的内容。

5.问题描述：

App 包、HAP 包和应用市场下载的包之间的体积差异原因是什么？

解决方案：

App 包、HAP 包和应用市场下载的包之间的体积差异主要由以下几个因素造成：

1. App 包的组成：APP 包通常包含多个 HAP（HarmonyOS Application Package）和 HSP（HarmonyOS Shared Package），其中 HAP 是应用的基本运行单元，而 HSP 用于在多个 HAP 之间共享代码和资源。这种结构意味着应用包的体积会根据包含的 HAP 和 HSP 的数量和大小而变化。

2. HAP 包的特点：HAP 包可以分为 entry 和 feature 类型，entry 类型的 HAP 是应用的入口点，而 feature 类型的 HAP 包含应用的特定功能。每个 HAP 都可能包含自己的代码、资源和依赖，导致整体应用包体积的增加。

3. 应用市场的下载包：应用市场的下载包就是下载的 HAP 包，开发者上架一个应用可以上传多个 HAP 包，上架之后，原始的 HAP 包在云端进行压缩保存，分发到用户客户端时传送压缩后的 HAP 包，减少流量消耗。我们这边会根据设备类型、分发策略等，选出适合当前设备的 HAP 包下发，这些 HAP 包就是下载包。

因此，App 包、HAP 包和应用市场下载的包之间的体积差异是由于它们的组成和优化策略的不同造成的。开发者可以通过合理使用 HSP 共享包和优化 HAP 的结构来控制应用的体积，提升用户体验。查看优化之后的 HAP 包是具体优化了哪些文件，可以直接点开 HAP 文件查看。优化 HAP 包之后，上架应用，从应用市场下载的包不会在原来的基础上变大。