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

前言

本文基于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
   */
  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
   */
  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.UIAbilityContext
   let checkResult = await updateManager.checkAppUpdate(context)
   //检查结果
   if (checkResult.updateAvailable == updateManager.UpdateAvailableCode.LATER_VERSION_EXIST) {
     //存在新的版本
     updateManager.showUpdateDialog(context)
   }
 }

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

image.png

点击立即更新之后:

image.png

自定义弹窗样式

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

检查更新

 /**
   * 检查是否有更新,使用Promise方式异步返回结果
   */
  async checkAppUpdate() {
    let context = getContext() as common.UIAbilityContext
    let 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.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);
  }

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

方式二: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.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}`);
  });
}

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

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

相关总结

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

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

#鸿蒙开发#
鸿蒙点石成金 文章被收录于专栏

简单的也好,复杂的也罢,关于HarmonyOS,总要深入浅出,总要步步为赢。

全部评论

相关推荐

06-30 09:08
算法工程师
2025年6月30日,全球行业报告出版商Global&nbsp;info&nbsp;Research(环洋市场咨询)发布了《2025年全球市场IoT物联网通信模组总体规模、主要企业、主要地区、产品和应用细分研究报告》。报告主要研究全球IoT物联网通信模组总体规模、主要地区规模、主要企业/生产商排名、份额和市场占有率、主要产品类型、下游主要应用分布等。全面分析IoT物联网通信模组全球范围内主要企业/厂商(品牌)竞争情况分析,包括企业分布区域、主要特征、产品规格、收入、毛利率等。数据包含2020-2031,其中2020至2024年为历史数据,2025至2031年为行业预测数据。出版商:广州环洋市场信息咨询有限公司据GIR&nbsp;(Global&nbsp;Info&nbsp;Research)调研,2024年全球IoT物联网通信模组收入大约6632百万美元,预计2031年达到13970百万美元,2025至2031期间,年复合增长率CAGR为11.4%。报告中涵盖IoT物联网通信模组的产品类型分析:蜂窝通信模块、&nbsp;非蜂窝通信模块IoT物联网通信模组的下游应用包括以下领域:城市服务物联网、&nbsp;消费物联网、&nbsp;工业物联网、&nbsp;其他应用同时,重点关注全球范围内IoT物联网通信模组主要企业,例如:移远通信、&nbsp;日海智能科技、&nbsp;司亚乐、&nbsp;泰利特通信、&nbsp;金雅拓、&nbsp;广和通、&nbsp;U-Blox、&nbsp;有方科技、&nbsp;高新兴、&nbsp;华为技术有限公司、&nbsp;LG&nbsp;Innotek、&nbsp;中兴物联内容概要:第1章:研究IoT物联网通信模组产品的定义、统计范围、市场规模、产品类型、应用等全球总体规模及预测(2020-2031)第2章:重点分析主要生产商,包括企业基本情况、主营业务及主要产品IoT物联网通信模组相关的介绍、收入、毛利率及企业最新发展动态等(2020-2025)第3章:重点分析全球竞争态势,主要包括全球IoT物联网通信模组的Top3和Top5企业的市场地位、收入、份额、相关业务/产品布局情况;同时包含下游市场及应用、行业并购、新进入者及扩产情况(2020-2025)第4章:全球主要地区的规模分析,包括主要地区(北美、欧洲、亚太、南美、中东及非洲)市场销量、收入等(2020-2031)第5章:分析全球市场IoT物联网通信模组产品类型的市场规模、收入、预测(2020-2031)第6章:分析全球市场IoT物联网通信模组应用领域的市场规模、收入、预测及份额(2020-2031)第7章:北美地区IoT物联网通信模组按国家、产品类型和应用的市场规模、收入、预测及份额(2020-2031)第8章:欧洲地区IoT物联网通信模组按国家、产品类型和应用的市场规模、收入、预测及份额(2020-2031)第9章:亚太地区IoT物联网通信模组按国家、产品类型和应用的市场规模、收入、预测及份额(2020-2031)第10章:南美地区IoT物联网通信模组按国家、产品类型和应用的市场规模、收入、预测及份额(2020-2031)第11章:中东及非洲IoT物联网通信模组按国家、产品类型和应用的市场规模、收入、预测及份额(2020-2031)第12章:研究IoT物联网通信模组的市场动态、驱动/阻碍因素、行业内竞争者/潜在竞争者的能力、供应商/购买者的议价等第13章:IoT物联网通信模组的产业链分析、原料及供应商分析、结构及占比、生产流程等第14章:IoT物联网通信模组的销售渠道分析、典型经销商、典型下游客户等第15-16章:研究结论、研究方法Global&nbsp;Info&nbsp;Research(环洋市场咨询)是一家深挖全球行业信息、分析竞争对手、为企业提供市场战略支持而服务的企业。以“定位全球,慧聚价值”为理念,为企业提供深度市场发展分析报告。出版商:广州环洋市场信息咨询有限公司
点赞 评论 收藏
分享
评论
点赞
收藏
分享

创作者周榜

更多
牛客网
牛客网在线编程
牛客网题解
牛客企业服务