【HarmonyOS 5】应用更新功能详解

关键词：#HarmonyOS SDK应用服务、#Appgallery connect、#应用更新

在应用开发场景中，功能迭代与调整是常态。为确保用户使用体验不受影响，应用内更新弹窗提示是兼顾稳定性与迭代需求的优选方案。这类弹窗主要用于向用户推送新版本更新通知，而在引导用户完成更新操作的实现层面，HarmonyOS 提供了完善的应用市场能力支撑，例如本文所介绍的 updateManager（更新功能） ，当存在新版后会展示应用更新弹窗，点击立即更新则直接跳转至应用市场详情页面，可高效实现版本更新的全流程引导。

效果演示：

其他：

1. updateManager 不支持应用强制更新，当应用出现重大安全隐患后请及时进行应用下架或后端整改工作。

2. 应用内不得自行开发拦截用户正常使用应用功能相关的更新弹窗，上架审核将被拒审，具体可参考应用审核指南：文档中心-应用功能

检测新版本

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

import { updateManager } from **********';
import { hilog } from **********';
import type { common } from **********';
import { BusinessError } from **********';

2.调用 updateManager.checkAppUpdate 接口，传入上下文。

/**
 * 检查应用是否存在新版本
 */
export function checkAppUpdate() {
  try {
    let context: common.UIAbilityContext = getContext() as common.UIAbilityContext;
    updateManager.checkAppUpdate(context)
      .then((checkResult: updateManager.CheckUpdateResult) => {
        // 应用存在新版本
        if (checkResult.updateAvailable == updateManager.UpdateAvailableCode.LATER_VERSION_EXIST) {
          // TODO：展示更新弹窗
        }
        // 应用不存在新版本 checkResult.updateAvailable == updateManager.UpdateAvailableCode.LATER_VERSION_NOT_EXIST
        SSLogger.info("Succeeded in checking Result updateAvailable:" + checkResult.updateAvailable);
      }).catch((error: BusinessError) => {
      SSLogger.info(`checkAppUpdate onError.code is ${error.code}, message is ${error.message}`);
    });
  } catch (error) {
    SSLogger.info(`checkAppUpdate onError.code is ${error.code}, message is ${error.message}`);
  }
}

checkResult.updateAvailable 返回值解释：

展示更新弹窗

需要注意的是：在未调用 checkAppUpdate 接口的情况下，调用 showUpdateDialog 接口将会返回为 1 的状态码，更新弹窗将无法展示，s所以需要确保在 checkAppUpdate 接口调用后，且返回存在新版本状态后再调用 showUpdateDialog 接口。

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

import { updateManager } from **********';
import { hilog } from **********';
import type { common } from **********';
import { BusinessError } from **********';

2.调用 updateManager.showUpdateDialog 接口，传入上下文。 

/**
 * 展示应用更新弹窗
 */
export function showUpdateDialog() {
  let context: common.UIAbilityContext = getContext() as common.UIAbilityContext;
  try {
    updateManager.showUpdateDialog(context)
      .then((resultCode: updateManager.ShowUpdateResultCode) => {
        // 应用更新弹窗展示成功 resultCode == updateManager.ShowUpdateResultCode.SHOW_DIALOG_SUCCESS
        // 应用更新弹窗展示失败 resultCode == updateManager.ShowUpdateResultCode.SHOW_DIALOG_FAILURE
        SSLogger.info("Succeeded in showing UpdateDialog resultCode:" + resultCode);
      })
      .catch((error: BusinessError) => {
        SSLogger.info(`showUpdateDialog onError.code is ${error.code}, message is ${error.message}`);
      });
  } catch (error) {
    SSLogger.info(`showUpdateDialog onError.code is ${error.code}, message is ${error.message}`);
  }
}

 resultCode 返回值解释：

弹窗更新描述配置

其中弹窗内更新详情文案由应用上架时所填写的内容。

在 AGC “可本地化基础信息”区域，配置应用介绍、一句话简介、新版本特性，其中新版本特性将在更新弹窗中展示。

​