应用市场更新功能

场景介绍

当应用启动完成或用户在应用中主动检查应用新版本时，开发者可以通过本服务，来查询应用是否有可更新的版本。如果存在可更新版本，您可以通过本服务为用户显示更新提醒。

业务流程

1. 应用调用检查更新接口。

2. 升级服务API返回是否有新版本。

3. 调用显示升级对话框接口。

4. 升级服务API向应用返回显示结果。

约束与限制

• 应用市场更新功能支持Phone、Tablet、PC/2in1设备。并且从5.1.1(19)版本开始，新增支持TV设备；从6.0.0(20)版本开始，新增支持Wearable设备。

• 应用市场更新功能不支持模拟器，请使用真机调试。在模拟器中使用该服务将会提示：无法获取内容，请点击屏幕重试。

• 应用已在应用市场上架。

接口说明

应用市场更新服务提供以下接口，具体API说明详见接口文档。

开发步骤

检测应用新版本

1. 导入updateManager模块及相关公共模块。

   import { updateManager } from '@kit.AppGalleryKit';
   import { hilog } from '@kit.PerformanceAnalysisKit';
   import type { common } from '@kit.AbilityKit';
   import { BusinessError } from '@kit.BasicServicesKit';

2. 构造参数，其中入参为common.UIAbilityContext类型的Context。

   let context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext;

3. 调用checkAppUpdate方法检查应用版本是否有更新。

   try {
     updateManager.checkAppUpdate(context)
       .then((checkResult: updateManager.CheckUpdateResult) => {
         hilog.info(0, 'TAG', 'Succeeded in checking Result updateAvailable:' + checkResult.updateAvailable);
       }).catch((error: BusinessError) => {
       hilog.error(0, 'TAG', `checkAppUpdate onError.code is ${error.code}, message is ${error.message}`);
     });
   } catch (error) {
     hilog.error(0, 'TAG', `checkAppUpdate onError.code is ${error.code}, message is ${error.message}`);
   }

显示升级对话框

1. 导入updateManager 模块及相关公共模块。

   import { updateManager } from '@kit.AppGalleryKit';
   import { hilog } from '@kit.PerformanceAnalysisKit';
   import type { common } from '@kit.AbilityKit';
   import { BusinessError } from '@kit.BasicServicesKit';

2. 构造参数，其中入参为common.UIAbilityContext类型的Context。

   let context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext;

3. 调用showUpdateDialog方法显示升级对话框。

   try {
     updateManager.showUpdateDialog(context)
       .then((resultCode: updateManager.ShowUpdateResultCode) => {
         hilog.info(0, 'TAG', 'Succeeded in showing UpdateDialog resultCode:' + resultCode);
       })
       .catch((error: BusinessError) => {
         hilog.error(0, 'TAG', `showUpdateDialog onError.code is ${error.code}, message is ${error.message}`);
       });
   } catch (error) {
     hilog.error(0, 'TAG', `showUpdateDialog onError.code is ${error.code}, message is ${error.message}`);
   }