当前位置：首页 > article >正文

鸿蒙Next-应用检测、安装以及企业内部商店的实现

article 2025/3/10 2:13:06

一、企业内部应用检测和更新升级

A应用检测是否安装B应用

canOpenApp():boolean{    try {      let link = 'schB://com.example.test/open'; // 替换成你目标应用的link串儿      let canOpen = bundleManager.canOpenLink(link);      console.log("canOpen:"+canOpen)      this.openDeepLink(link)      return canOpen;    } catch (err) {      let message = (err as BusinessError).message;      console.log('testTag', 'canOpenLink failed: %{public}s', message);    }    return false;  }

link的构成

为了便于应用A判断设备上是否有安装应用B，从而决定是否引导用户去下载应用B，需要应用A、B做如下配置：

应用B配置，在entry模块的 module.json5文件中添加配置具体标签路径如下：module-> abilities -> skills-> 添加 uris

{   "abilities": [     {       "skills": [         {           "actions": [             "ohos.want.action.home",             "ohos.want.action.viewData"           ],           "entities": [             "entity.system.home"           ],           "uris": [             {               "scheme":"schB",               "host":"com.example.test",               "path":"open",             }           ],         }       ]     }   ] }

应用A配置，在entry模块的module.json5文件中添加配置具体标签路径如下：module-> querySchemes

"querySchemes": [ "schB"]

打开某个应用

this.openDeeplink("schB://com.example.test/open")   /**   * 打开或者下载安装应用   * @param deeplink   */  private openDeepLink(deeplink: string): void {   let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;    context.openLink(deeplink).then(() => {      console.info('openlink success.')    }).catch((error: BusinessError) => {      console.error('openlink failed.')    });  }

应用升级

deeplink的构成结构（具体解释见第二章节《二、企业内部商店如何实现》）：

let deeplink: string = "store://enterprise/manifest?url=https://xxx/xxx.json5";

/**   * 打开或者下载安装应用   * @param deeplink   */  private openDeepLink(deeplink: string): void {   let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;    context.openLink(deeplink).then(() => {      console.info('openlink success.')    }).catch((error: BusinessError) => {      console.error('openlink failed.')    });  }

二、企业内部商店如何实现

对于不适合或不希望在华为应用市场上公开发布的、面向企业内部或特定人群的HarmonyOS应用的分发，必须使用专用的组织内部发布证书和组织内部发布Profile来编译打包HarmonyOS应用，然后将应用包及应用描述文件上传到您的服务器或第三方云上，用户按指定方式直接下载安装即可。

上传应用包至服务器

将编译得到的各个HAP/HSP包上传至您的服务器或第三方云上，获取HAP/HSP包下载URL，下载URL必须以“https”开头。

生成应用描述文件并上传至服务器

基于应用信息生成应用描述文件（如“manifest.json5”，文件名可自定义），代码如下：

{  "app": {    "bundleName": "com.example.demo.a",    "bundleType": "app",    "versionCode": 1000000,    "versionName": "1.0.0",    "label": "DemoA",    "deployDomain": "应用、图标以及描述文件部署域名",    "icons": {      "normal": "标准图标下载链接",      "large": "大图标下载链接"    },    "minAPIVersion": "4.1.0(11)",    "targetAPIVersion": "4.1.0(11)",    "modules": [      {        "name": "module1",        "type": "entry",        "deviceTypes": [          "tablet",          "phone"        ],        "packageUrl": "hap包下载链接",        "packageHash": "hap包sha256值"      },      {        "name": "module2",        "type": "feature",        "deviceTypes": [          "tablet",          "phone"        ],        "packageUrl": "hap包下载链接",        "packageHash": "hap包sha256值"      }    ]  }}

需传入的应用信息如下表所示。

属性	数据类型	必选(M)/可选(O)	说明
bundleName	字符串	M	应用的Bundle名称。
bundleType	字符串	M	应用的Bundle类型，用于区分HarmonyOS应用或元服务。当前仅支持配置为“app”，表示HarmonyOS应用。
versionCode	数值	M	应用的版本号。
versionName	字符串	M	应用版本号的文字描述。
label	字符串	M	应用的名称，建议与实际应用名称一致，否则会出现下载与安装过程中应用名不一致的问题。
deployDomain	字符串	M	应用、图标及描述文件的部署域名，需要与icons、packageUrl以及描述文件自身下载URL中的域名一致，否则会导致下载失败。
icons	字符串	M	应用的图标，提供企业内部部署的图片下载地址，必须以“https”开头。
minAPIVersion	字符串	M	应用运行所需SDK的API最小版本，用于判断是否与当前设备兼容。
targetAPIVersion	字符串	M	应用运行所需的API目标版本，用于判断是否与当前设备兼容。
modules	列表	M	应用分包module信息列表，以数组形态组织，其中至少包括一个entry module信息。
name	字符串	M	module的名称，该名称在整个应用须唯一。
type	字符串	M	应用module的类型，取值范围：
deviceTypes	字符串	M	当前module可以运行在哪类设备上，目前仅支持phone（手机）和tablet（平板）。
packageUrl	字符串	M	当前module上传至服务器后生成的下载URL，必须以“https”开头。
packageHash	字符串	M	当前module的SHA256值。例如，可通过*certutil -hashfile 包路径* SHA256**命令获取。说明 “包路径”指应用HAP/HSP包在本地的存储路径。

entry：应用的主模块
feature：应用的动态特性模块
shared：动态共享包模块（仅支持应用内共享包）

将应用描述文件上传至您的服务器或第三方云上，获取该描述文件的下载URL。

构造DeepLink拉起应用下载安装

获取应用描述文件的下载URL后，您便可使用该URL构造DeepLink来拉起应用下载安装。DeepLink需满足如下条件：

仅支持页面点击行为触发拉起，不支持地址栏输入DeepLink拉起或HTML头文件自动拉起。
仅支持华为浏览器拉起，且从华为浏览器拉起的所有行为，均需判断是否有用户点击行为，确认用户点击才允许拉起。

DeepLink格式：store://enterprise/manifest?url=https://xxx.xxx/xxx.json5

Schema	store://
Host	enterprise
Path	manifest
参数	描述文件上传至服务器后生成的下载URL，必须以“https”开头。示例：url=https://xxx.xxx/xxx.json5 说明如描述文件下载URL内包含特殊字符，还需进行特殊字符编码：declare function encodeURIComponent(uriComponent: string \| number \| boolean): string;

同时，服务器配置需满足如下条件，请特别关注：

您需要配置服务器支持分片下载能力。建议您在配置后进行验证：构造下载请求头包含range字段，返回码为206（如下方示例图），表示服务器支持分片下载；反之则不支持。
您需要配置服务器返回的响应头（如下方示例图），使得应用描述文件和应用包可正确传输下载。

例如，用户在应用分发页面点击“下载”按钮后，华为浏览器将解析您构造的DeepLink，触发应用的下载安装流程。

<html lang="en">  <head>    <meta charset="UTF-8">    <title>Button Open DeepLink Example</title>    <script>      function openDeepLink() {        let url ='store://enterprise/manifest?url=https://xxx.xxx/xxx.json5'        window.open(url, '_parent')      }    </script>  </head>  <body>    <button onclick="openDeepLink()">下载</button>  </body></html>

更新场景下，可以使用openlink方式直接拉起下载安装：

private openDeepLink(deeplink: string): void {// deeplink格式具体见开发者文档let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;context.openLink(deeplink).then(() => {console.info('openlink success.')}).catch((error: BusinessError) => {console.error('openlink failed.')});}