HarmonyOS开发者社区

HarmonyOS开发者社区 鸿蒙开发：应用内如何做更新

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

本文基于Api13应用更新是开发中一个比较常见的功能，便于我们把新的功能及时的推送出去，进而提醒用户有新的版本，便于用户及时的去体验下载，可以说，关系着我们APP功能的未来走向，是一个不能缺失而且非常重要的功能。鸿蒙开发：应用内如何做更新鸿蒙中的更新和Android有着非常大的区别，在Android中，apk可以自由下载安装，也就意味着，我们可以把apk托管到一个服务器中，在应用中就能让用户做到更

chjunlinux

1056人浏览 · 2025-06-05 16:12:31
chjunlinux  ·  2025-06-05 16:12:31 发布

前言

本文基于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>;
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.

需要注意的是，两者必须结合使用，先去检查，再去显示更新弹窗，我们可以按照下面的代码逻辑去执行，在调用的时候，直接调用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) {
    }
  }
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.

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

/**
   * 检查是否有更新，使用Promise方式异步返回结果
   */
  async checkAppUpdate() {
    let context = getContext() as common.UIAbilityContext
    let checkResult = await updateManager.checkAppUpdate(context)
    //检查结果
    if (checkResult.updateAvailable == updateManager.UpdateAvailableCode.LATER_VERSION_EXIST) {
      //存在新的版本
      updateManager.showUpdateDialog(context)
    }
  }
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.

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

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

点击立即更新之后：

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

自定义弹窗样式

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

检查更新

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

    }
  }
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.

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

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

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

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

跳转市场详情页面

方式一：loadProduct接口调用

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

/**
   * productViewManager拉齐应用详情页
   */
  loadProduct() {
    const uiContext = getContext(this) as common.UIAbilityContext
    const 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);
  }
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.

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

方式二：DeepLink方式

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

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

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

// 拉起应用市场对应的应用详情页面
function startAppGalleryDetailAbility(context: common.UIAbilityContext, bundleName: string): void {
  let want: Want = {
    action: 'ohos.want.action.appdetail', //隐式指定action为ohos.want.action.appdetail
    uri: '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}`);
  });
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.

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

startAppGalleryDetailAbility(getContext() as common.UIAbilityContext,"com.xx.xx")
  • 1.
方式三：App Linking方式

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

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

跳转代码如下：

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}`);
      });
  }
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.

相关总结

使用系统的，直接调用检查和显示更新弹窗即可，可以说就两个方法，我们就实现了应用更新的功能，可以说是非常的简单，如果系统的弹窗无法满足您的需求，您可以自定义弹窗，然后实现跳转应用详情页面即可。

本文标签：鸿蒙开发工具/应用更新

# harmonyos # 华为
Logo
HarmonyOS开发者社区

讨论HarmonyOS开发技术，专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐

cover

【鸿蒙实战】ToolMaster：基于 HarmonyOS NEXT 的纯离线隐私优先开发者工具箱

avatar HarmonyOS开发者社区

鸿蒙隔空传送：一抓一放，内容就到了对面的设备上

鸿蒙系统推出的隔空传送功能通过"抓取-释放"手势实现跨设备文件传输，开发者需在应用页面注册监听并处理分享数据。该功能与隔空截屏共用触发手势，系统根据开关组合决定具体行为。开发接入需注意三点：及时响应手势回调（3秒内完成）、严格管理生命周期监听、正确处理设备间信任机制。同账号设备传输无需确认，不同账号需双向验证并1小时内有效。该功能结合App Linking可实现"传送

avatar HarmonyOS开发者社区
cover

鸿蒙6.0应用开发——自定义键盘的实现

avatar HarmonyOS开发者社区
  • 浏览量 1056
  • 收藏 0
  • 0

所有评论(0)

查看更多评论 

chjunlinux

@weixin_44066506
已为社区贡献13条内容