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

鸿蒙开发：应用内如何做更新

news 2025/6/8 5:54:06

前言

本文基于Api13

应用更新是开发中一个比较常见的功能，便于我们把新的功能及时的推送出去，进而提醒用户有新的版本，便于用户及时的去体验下载，可以说，关系着我们APP功能的未来走向，是一个不能缺失而且非常重要的功能。

鸿蒙开发：应用内如何做更新鸿蒙中的更新和Android有着非常大的区别，在Android中，apk可以自由下载安装，也就意味着，我们可以把apk托管到一个服务器中，在应用中就能让用户做到更新下载，而且非常的及时；然而鸿蒙中却做不到，鸿蒙中打出的包，由于纯净模式默认开启，只能上传到华为应用市场，在其他的渠道是无法进行更新下载的，目的也很明确，为了软件的安全，防止恶意软件入侵。

总结就是，在鸿蒙中更新应用，是无法做到直接下载更新的，而是必须到应用市场进行更新。

从另一个角度来看，对于开发者的我们确实简单了很多，不用在去考虑下载安装的逻辑，也不用考虑后台更新的逻辑，只需要调用系统给我们提供的更新方法就可以了。

更新呢，也有两种方式，一种是直接使用系统提供的更新样式，另一种就是自定义更新弹窗样式，无论哪种样式，最后都是需要跳转到应用市场。

调用系统更新样式

调用系统样式，非常的简单，无须我们再额外的处理弹窗样式，所有的功能从检查更新到弹窗，都有系统来提供，也就是通过updateManager里的两个方法，一个是checkAppUpdate检查更新，一个showUpdateDialog显示更新弹窗，源码如下：

  /*** Check for Update.** @param { common.UIAbilityContext } context - the context of an ability* @returns { Promise<CheckUpdateResult> } The promise of CheckUpdateResult returned by the function.* @throws { BusinessError } 401 - Parameter error.* @throws { BusinessError } 1009400001 - SA connect error* @throws { BusinessError } 1009400002 - Request to service error.* @throws { BusinessError } 1009400003 - Network error.* @throws { BusinessError } 1009400004 - The application is not in the foreground.* @throws { BusinessError } 1009400005 - Not agreeing to the privacy agreement.* @throws { BusinessError } 1009400006 - Time limited.* @throws { BusinessError } 1009400007 - Other error.* @syscap SystemCapability.AppGalleryService.Distribution.Update* @stagemodelonly* @since 5.0.0(12)*/function checkAppUpdate(context: common.UIAbilityContext): Promise<CheckUpdateResult>;/*** Displaying the update dialog.** @param { common.UIAbilityContext} context - the context of an ability* @returns { Promise<ShowUpdateResultCode> } The promise of ShowUpdateResultCode returned by the function.* @throws { BusinessError } 401 - Parameter error.* @throws { BusinessError } 1009400001 - SA connection error.* @throws { BusinessError } 1009400002 - Request to service error.* @throws { BusinessError } 1009400004 - The application is not in the foreground.* @throws { BusinessError } 1009400005 - Not agreeing to the privacy agreement.* @throws { BusinessError } 1009400007 - Other error.* @syscap SystemCapability.AppGalleryService.Distribution.Update* @stagemodelonly* @since 5.0.0(12)*/function showUpdateDialog(context: common.UIAbilityContext): Promise<ShowUpdateResultCode>;

需要注意的是，两者必须结合使用，先去检查，再去显示更新弹窗，我们可以按照下面的代码逻辑去执行，在调用的时候，直接调用checkAppUpdate方法即可。

/*** 检查是否有更新，使用Promise方式异步返回结果*/checkAppUpdate() {try {updateManager.checkAppUpdate(getContext() as common.UIAbilityContext).then((checkResult: updateManager.CheckUpdateResult) => {//检查结果if (checkResult.updateAvailable == updateManager.UpdateAvailableCode.LATER_VERSION_EXIST) {//存在新的版本this.showUpdateDialog()}})} catch (error) {}}/*** 弹出更新弹窗*/showUpdateDialog() {try {updateManager.showUpdateDialog(getContext() as common.UIAbilityContext)} catch (error) {}}

由于是返回的Promise，我们可以更加简单的使用await方法，代码更加的简单。

 /*** 检查是否有更新，使用Promise方式异步返回结果*/async checkAppUpdate() {let context = getContext() as common.UIAbilityContextlet checkResult = await updateManager.checkAppUpdate(context)//检查结果if (checkResult.updateAvailable == updateManager.UpdateAvailableCode.LATER_VERSION_EXIST) {//存在新的版本updateManager.showUpdateDialog(context)}}

执行之后，就会显示如下的更新的弹窗，点击立即更新后，就会直接跳转到应用市场此应用的详情页面。

点击立即更新之后：

自定义弹窗样式

虽然说，鸿蒙不支持应用内更新下载，但是支持你自定义弹窗样式，只不过最后的更新，还是要去应用市场进行，实现步骤，第一步还是要调用系统的检查更新的方法，有更新时弹出自己的弹窗，然后实现跳转到应用市场详情页面。

检查更新

 /*** 检查是否有更新，使用Promise方式异步返回结果*/async checkAppUpdate() {let context = getContext() as common.UIAbilityContextlet checkResult = await updateManager.checkAppUpdate(context)//检查结果if (checkResult.updateAvailable == updateManager.UpdateAvailableCode.LATER_VERSION_EXIST) {//存在新的版本，弹出自己的视图，自己去定义}}

自定义弹窗这里就不写了，大家自行实现即可，当然，这里也推荐一下我的一个弹窗组件，有喜欢的朋友，可以进行体验，中心仓库地址是：

https://ohpm.openharmony.cn/#/cn/detail/@abner%2Fdialog

我这个弹窗，支持八大功能模块，几乎涵盖各个业务需求，【自定义形式】、【时间弹窗】、【城市选择】、【确认&信息】、【底部列表&网格】、【toast】、【popup形式】、【loading形式】，如果还不能满足，还支持便捷式自定义，可以说，让你的弹窗实现更加的便捷。

更新弹窗实现后，无非就是怎么跳转应用详情页面了，目前总结了三种方式，大家可以选择自己喜欢的方式。

跳转市场详情页面

方式一：loadProduct接口调用

主要是通过productViewManager中的loadProduct来拉起应用的详情页面，需要把bundleName替换为你自己的应用包名。

/*** productViewManager拉齐应用详情页*/loadProduct() {const uiContext = getContext(this) as common.UIAbilityContextconst wantParam: Want = {parameters: {// 必填，此处填入要加载的应用包名，例如： bundleName: 'com.huawei.hmsapp.books'bundleName: 'com.xx.xx',}}const callback: productViewManager.ProductViewCallback = {onError: (error: BusinessError) => {hilog.error(0, 'TAG', `loadService onError.code is ${error.code}, message is ${error.message}`)},onAppear: () => {hilog.info(0, 'TAG', `loadProduct onAppear.`);},onDisappear: () => {hilog.info(0, 'TAG', `loadProduct onDisappear.`);}}// 调用接口，拉起应用详情页productViewManager.loadProduct(uiContext, wantParam, callback);}

调用以上的方法后，就会跳转到应用的详情页面。

方式二：DeepLink方式

DeepLink方式是通过startAbility的方式进行跳转应用详情页面，也是需要应用的包名，其格式为：

store://appgallery.huawei.com/app/detail?id= + bundleName

实现跳转代码如下，定义外部的function函数。

// 拉起应用市场对应的应用详情页面
function startAppGalleryDetailAbility(context: common.UIAbilityContext, bundleName: string): void {let want: Want = {action: 'ohos.want.action.appdetail', //隐式指定action为ohos.want.action.appdetailuri: 'store://appgallery.huawei.com/app/detail?id=' + bundleName, //  bundleName为需要打开应用详情的应用包名};context.startAbility(want).then(() => {hilog.info(0x0001, 'TAG', "Succeeded in starting Ability successfully.")}).catch((error: BusinessError) => {hilog.error(0x0001, 'TAG', `Failed to startAbility.Code: ${error.code}, message is ${error.message}`);});
}

在需要跳转的时候，直接调佣，传入上下文和包名即可：

  startAppGalleryDetailAbility(getContext() as common.UIAbilityContext,"com.xx.xx")

方式三：App Linking方式

App Linking的方式是通过openLink的方式跳转到应用市场详情页面，同样也是需要包名。其格式为：

https://appgallery.huawei.com/app/detail?id= + bundleName

跳转代码如下：

openLink(){let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;// 需要拼接不同的应用包名，用以打开不同的应用详情页,例如：bundleName: 'com.huawei.hmsapp.books'let bundleName: string = 'com.xx.xx';let link: string = 'https://appgallery.huawei.com/app/detail?id=' + bundleName;// 以App Linking优先的方式在应用市场打开指定包名的应用详情页context.openLink(link, { appLinkingOnly: false }).then(() => {hilog.info(0x0001, 'TAG', 'openlink success.');}).catch((error: BusinessError) => {hilog.error(0x0001, 'TAG', `openlink failed. Code: ${error.code}, message is ${error.message}`);});}