openharmony 鸿蒙 install-and-update-consistency-verification

2026-08-25 浏览 (1)

应用安装与更新一致性校验

随着应用发展越来越复杂,应用也被拆成多个模块进行开发维护,不同的团队负责单个或者多个模块,应用在安装更新过程中会针对不同的字段进行一致性校验和验证,保证应用的安全合法性。本文介绍多模块安装或更新时,签名证书、配置文件的一致性校验规则。

说明

app.json5配置文件中versionCode字段一致,表示安装或更新包同版本,否则为不同版本。

使用打包工具进行打包时,会进行合法性校验。详情请参考打包工具

签名证书一致性校验

字段名称说明安装一致性校验规则更新一致性校验规则
appId应用的appId,表示应用的唯一标识,详情信息可参考什么是appIdappId和appIdentifier任一相同即可。
appIdentifier应用的唯一标识。详情信息可参考什么是appIdentifierappId和appIdentifier任一相同即可。
appDistributionType应用Profile签名文件中的app-distribution-type,标识应用的分发类型。更新不同版本时无校验,同版本有校验。
appProvisionType应用签名证书类型。来源于应用Profile签名文件中的type。分为debug和release。debug用于本地调试使用,release用于应用发布场景。更新不同版本时无校验,同版本有校验。
apl表示应用程序的APL等级,系统定义的apl包括:normal、system_basic和system_core。更新不同版本时无校验,同版本有校验。

配置文件一致性校验

字段名称说明安装一致性校验规则更新一致性校验规则
bundleName标识应用名称。该字段来源于app.json5配置文件中的bundleName字段。
versionCode标识应用版本号。该字段来源于app.json5配置文件中的versionCode字段。
apiReleaseType标识应用运行需要的API目标版本的类型。设备中未安装该应用,该应用包含多个模块包,模块一个一个安装时,不检验一致性。该字段来源于app.json5配置文件中的apiReleaseType字段。
singleton标识应用是否安装在0用户下。
appType标识应用是三方应用或系统应用。
isStage标识应用是否为Stage模型。是,FA模型和Stage模型在同版本中不允许变更。
targetBundleName标识当前包所指定的目标应用,配置该字段的应用为具有overlay特征的应用。该字段来源app.json5配置文件中targetBundleName字段。
targetPriority标识当前应用的优先级。该字段来源于app.json5配置文件中的targetPriority字段。
bundleType标识应用的类型。该字段来源于app.json5配置文件中的bundleType字段。
installationFree标识是否支持免安装。该字段来源于module.json5配置文件中的installationFree字段。
debug标识应用是否可调试。该字段来源于app.json5配置文件中的debug字段。
moduleType标识模块的类型。该字段来源于module.json5配置文件中的type字段。是,同版本entry类型的moduleName不能修改

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 app-clone

openharmony 鸿蒙 har-package

openharmony 鸿蒙 application-package-install-uninstall

openharmony 鸿蒙 getting-started-with-arkts-for-java-programmers

openharmony 鸿蒙 arkts-migration-background

openharmony 鸿蒙 getting-started-with-arkts-for-swift-programmers

openharmony 鸿蒙 typescript-to-arkts-migration-guide

openharmony 鸿蒙 application-package-glossary

openharmony 鸿蒙 application-package-structure-stage

openharmony 鸿蒙 app-configuration-file

  • 所属分类: 后端技术
  • 本文标签: 鸿蒙 软件
  • 版权声明: 本文链接 https://seaxiang.com/blog/HWsBQnx5