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

2025-06-22
湖南
本文字数：1756 字
阅读完需：约 6 分钟

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

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

效果演示：

其他：

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

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

检测新版本

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

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

复制代码

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 '@kit.StoreKit';import { hilog } from '@kit.PerformanceAnalysisKit';import type { common } from '@kit.AbilityKit';import { BusinessError } from '@kit.BasicServicesKit';

复制代码

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}`);  }}