HarmonyOS—HAP唯一性校验逻辑

最新推荐文章于 2024-08-15 11:57:09 发布
最新推荐文章于 2024-08-15 11:57:09 发布
阅读量1k 收藏 13
点赞数 11
分类专栏： HarmonyOS 鸿蒙工程师 鸿蒙 文章标签： harmonyos 华为 OpenHarmony 鸿蒙 鸿蒙开发 鸿蒙应用开发 鸿蒙工程师
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_82546228/article/details/136462676
版权
鸿蒙工程师 同时被 3 个专栏收录
567 篇文章 7 订阅
订阅专栏
鸿蒙
567 篇文章 2 订阅
订阅专栏
HarmonyOS
555 篇文章 0 订阅
订阅专栏

HAP是应用安装的基本单位，在DevEco Studio工程目录中，一个HAP对应一个Module。应用打包时，每个Module生成一个.hap文件。

应用如果包含多个Module，在应用市场上架时，会将多个.hap文件打包成一个.app文件（称为Bundle），但在云端分发和端侧安装时，仍然是以HAP为基本单位。

为了能够正常分发和安装应用，需要保证一个应用安装到设备时，Module的名称、Ability的名称不重复，并且只有一个Entry类型的Module与目标设备相对应。

DevEco Studio会在编译构建时，对HAP进行上述唯一性校验，如果校验不通过，将会编译失败或给出告警。

说明
当前仅在API 8的工程中，针对distrofilter进行打包校验。

Module校验逻辑

校验目的：同一目标设备上Module唯一。

1.校验Module的Name。如果多个Module的Name不同，则校验通过。如果Name相同，继续校验deviceType。

2.校验设备类型deviceType。如果deviceType不相交，则校验通过。如果deviceType相交，继续校验distroFilter。

deviceType不相交是指两个Module的deviceType中配置了完全不同的设备，例如：

//Module1和Module2配置了完全不同的设备，deviceType不相交。
//Module1
{
    "deviceType": ["TV", "tablet"]
}
//Module2
{
    "deviceType": ["car", "router"]
}

deviceType相交是指两个Module的deviceType中包含了相同的设备，例如：

//Module1和Module2因为都包含“tablet”设备，导致deviceType相交。
//Module1
{
    "deviceType": ["TV", "tablet"]
}
//Module2
{
    "deviceType": ["car", "tablet"]
}

3.校验分发规则distroFilter。如果distroFilter不相交，则校验通过。如果distroFilter相交，则无法保证Module唯一性，校验失败，打包失败。

distroFilter中包含属性apiVersion、screenShape、screenWindow、screenDensity和countryCode。相交的相关含义如下：

  • distroFilter不相交：如果两个distroFilter中任意一个属性不相交，则两个distroFilter不相交。
  • distroFilter相交：如果两个distroFilter中所有属性都相交，则两个distroFilter相交。

例如，两个Module中的apiVersion、screenShape、screenWindow、screenDensity都相交，但countryCode不相交，则可以区分两个Module，校验通过。

//Module1和Module2的两个distroFilter中，countryCode不相交，则两个distroFilter不相交。
//Module1
{
  "distroFilter": {
    "apiVersion" : {
      "policy": "include",
      "value": [8,9]
    },
    "screenShape": {
      "policy": "include",
      "value": ["rect"]
    },
    "screenWindow": {
      "policy": "include",
      "value": ["454*454", "466*466"]
    },
    "screenDensity": {
      "policy": "include",
      "value": ["ldpi", "xldpi"]
    },
    "countryCode": {
      "policy": "include",
      "value": ["CN", "HK"]
    }
  }
}
//Module2
{
  "distroFilter": {
    "apiVersion" : {
      "policy": "include",
      "value": [8,9]
    },
    "screenShape": {
      "policy": "include",
      "value": ["rect"]
    },
    "screenWindow": {
      "policy": "include",
      "value": ["454*454", "466*466"]
    },
    "screenDensity": {
      "policy": "include",
      "value": ["ldpi", "xldpi"]
    },
    "countryCode": {
      "policy": "include",
      "value": ["USA", "UK"]
    }
  }
}

Ability校验逻辑

校验目的：同一目标设备上Ability唯一。

1.校验Ability的Name。如果多个Ability的Name不同，则校验通过。如果Name相同，继续校验Ability所属Module的deviceType。

2.校验Ability所属Module的deviceType。如果deviceType不相交，校验通过。如果deviceType相交，继续校验Ability所属Module的distroFilter。

例如，两个Ability的Name相同，但其所属Module的deviceType不相交，校验通过。

//Ability1和Ability2虽然名称相同，但由于其所属Module的deviceType不相交，所以可以区分两个Ability，校验通过。
//Ability1
{
    "module": {
        "name": "module_sample1",
        "deviceType": ["TV", "tablet"],
        "abilities": [
    {
        "name": "ability_sample"
    }
        ]
    }
}
//Ability2
{
     "module": {
        "name": "module_sample2",
        "deviceType": ["car", "router"],
        "abilities": [
    {
        "name": "ability_sample"
    }
        ]
    }
}

3.校验Ability所属Module的distroFilter。如果distroFilter不相交，校验通过。如果distroFilter相交，校验失败，抛出告警。

例如，两个Ability的Name相同，其所属Module的deviceType也相交，但其所属Module的distroFilter不相交，校验通过。

//Ability1和Ability2的Name相同，而且其所属Module的deviceType相交，但其所属Module的DistroFilter不相交，所以可以区分两个Ability，校验通过。
//Ability1
{
    "module": {
        "name": "module_sample",
        "deviceType": ["TV", "tablet"],
        "metadata": [
            {
                "name": "distroFilter_config"
                "resource": "$profile:distroFilter_config_sample1"
            }
        ],
        "abilities": [
            {
                "name": "ability_sample"
            }
        ]
    }
}
//Ability1所属Module的distroFilter
{
  "distroFilter": {
    "apiVersion" : {
      "policy": "include",
      "value": [8,9]
    },
    "screenShape": {
      "policy": "include",
      "value": ["rect"]
    },
    "screenWindow": {
      "policy": "include",
      "value": ["454*454", "466*466"]
    },
    "screenDensity": {
      "policy": "include",
      "value": ["ldpi", "xldpi"]
    },
    "countryCode": {
      "policy": "include",
      "value": ["CN", "HK"]
    }
  }
}

//Ability2
{
    "module": {
        "name": "module_sample2",
        "deviceType":  ["TV", "tablet"],
        "metadata": [
            {
                "name": "distroFilter_config"
                "resource": "$profile:distroFilter_config_sample2"
            }
        ],
        "abilities": [
            {
                "name": "ability_sample"
            }
        ]
    }
}
//Ability2所属Module的distroFilter
{
  "distroFilter": {
    "apiVersion" : {
      "policy": "include",
      "value": [8,9]
    },
    "screenShape": {
      "policy": "include",
      "value": ["rect"]
    },
    "screenWindow": {
      "policy": "include",
      "value": ["454*454", "466*466"]
    },
    "screenDensity": {
      "policy": "include",
      "value": ["ldpi", "xldpi"]
    },
    "countryCode": {
      "policy": "include",
      "value": ["USA", "UK"]
    }
  }
}

Entry校验逻辑

校验目的：目标设备只有一个Entry类型的Module与之对应，Feature类型的Module经过deviceType及distroFilter指明的目标设备都需要存在Entry类型的Module。

1.校验Feature类型的Module经过deviceType及distroFilter指明的目标设备都存在Entry类型的Module。

例如，Bundle中存在一个Entry类型Module1，其支持设备为tablet和wearable，其分发规则为circle和rect形状的屏幕，同时存在一个Feature类型的Module2，通过分发规则可知，其可以分发到rect形状的tablet和wearable设备上，而rect形状的tablet和wearable设备上存在Entry类型的Module1，校验通过。

//Entry类型Module1
{
    "module": {
        "name": "module_sample1",
        "type": "entry",
        "deviceType": ["tablet", "wearable"],
        "metadata": [
            {
                "name": "distroFilter_config",
                "resource": "$profile:distroFilter_config1"
            }
        ]
    }
}
//Module1的distroFilter，distroFilter_config1.json
{
    "screenShape":{
        "policy": "include",
        "value": ["circle", "rect"]
    }
}
//Feature类型Module2
{
     "module": {
        "name": "module_sample2",
        "type": "feature",
        "deviceType": ["tablet", "wearable"],
         "metadata": [
            {
                "name": "distroFilter_config",
                "resource": "$profile:distroFilter_config2"
            }
        ]
    }
}
//Module2的distroFilter，distroFilter_config2.json
{
    "screenShape":{
        "policy": "include",
        "value": ["rect"]
    }
}

2.校验目标设备只有一个Entry类型的Module与之对应。

a.校验Entry类型Module的deviceType。如果deviceType不相交，校验通过。如果deviceType相交，继续校验Entry类型Module的distroFilter。

例如，同一个Bundle中存在两个Entry类型的Module，分别为Module1和Module2，两者的deviceType不相交，可以有效区分两个Module，校验通过。

//Entry类型Module1
{
    "module": {
        "name": "module_sample1",
        "type": "entry",
        "deviceType": ["tablet"]
    }
}
//Entry类型Module2
{
     "module": {
        name: "module_sample2",
        "type": "entry",
        "deviceType": ["wearable"]
    }
}

b.校验Entry类型Module的distroFilter。如果distroFilter不相交，校验通过。如果distroFilter相交，校验失败，打包失败。

例如，同一个Bundle中存在两个Entry类型的Module，分别为Module1和Module2，两者的deviceType相交，但两者的distroFilter不相交，可以有效区分两个Module，校验通过。

//Entry类型Module1
{
    "module": {
        "name": "module_sample1",
        "type": "entry",
        "deviceType": ["wearable"],
        "metadata": [
    {
        "name":"distroFilter_config"
        "resource": "$profile:distroFilter_sample1"
    }
        ]
    }
}
//Module1的distroFilter，distroFilter_sample1.json
{
    "distroFilter": {
         "screenShape":{
            "policy": "include",
            "value": ["rect"]
        }
    }
}
//Entry类型Module1
{
     "module": {
        "name": "module_sample2",
        "type": "entry",
        "deviceType": ["wearable"],
        "metadata": [
    {
        "name":"distroFilter_config"
        "resource": "$profile:distroFilter_sample2"
    }
        ]
    }
}
//Module2的distroFilter，distroFilter_sample2.json
{
    "distroFilter": {
         "screenShape":{
            "policy": "include",
            "value": ["circle"]
        }
    }
}

那么要想成为一名鸿蒙高级开发，以上知识点是必须要掌握的，除此之外，还需要掌握一些鸿蒙应用开发相关的一些技术，需要我们共同去探索。

为了能够让大家跟上互联网时代的技术迭代，在这里我特邀了几位行业大佬整理出一份最新版的鸿蒙学习提升资料，有需要的小伙伴自行领取，限时开源，先到先得~~~~

领取以下高清学习路线原图请点击→《鸿蒙 (Harmony OS)开发学习手册》纯血鸿蒙HarmonyOS基础技能学习路线图

在这里插入图片描述
 

领取以上完整高清学习路线图，请点击→《鸿蒙基础入门学习指南》小编自己整理的部分学习资料（包含有高清视频、开发文档、电子书籍等）

在这里插入图片描述

以上分享的学习路线都适合哪些人跟着学习？

-应届生/计算机专业
通过学习鸿蒙新兴技术，入行互联网，未来高起点就业。
-0基础转行
提前布局新方向，抓住风口，自我提升，获得更多就业机会。
-技术提升/进阶跳槽
发展瓶颈期，提升职场竞争力，快速掌握鸿蒙技术，享受蓝海红利。

在这里插入图片描述

最后

鸿蒙开发学习是一个系统化的过程，从基础知识的学习到实战技能的锤炼，再到对前沿技术的探索，每一环节都至关重要。希望这份教程资料能帮助您快速入门并在鸿蒙开发之路上步步攀升，成就一番事业。让我们一起乘风破浪，拥抱鸿蒙生态的广阔未来！

如果你觉得这篇内容对你有帮助，我想麻烦大家动动小手给我：点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。

关注我，同时可以期待后续文章ing，不定期分享原创知识。

想要获取更多完整鸿蒙最新VIP学习资料，请点击→《鸿蒙全套学习指南》

码牛程序猿
关注
  • 11
    点赞
  • 踩
  • 13
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
HAP 是什么 （HarmonyOS鸿蒙开发基础知识）
iCloudEnd的博客
09-14 1万+
HAP 是什么 HarmonyOS应用发布形态为APP Pack（Application Package，简称APP），它是由一个或多个HAP（HarmonyOS Ability Package）包以及描述APP Pack属性的pack.info文件组成。 HAP是Ability的部署包，HarmonyOS应用代码围绕Ability组件展开，它是由一个或多个Ability组成。Ability分为两种类型：FA（Feature Ability）和PA（Particle Ability）。FA/PA是应用的基本
手把手教你上架HarmonyOS（鸿蒙）应用
weixin_52542088的博客
12-17 5649
HarmonyOS（鸿蒙）应用上架流程前言正文申请访问证书管理菜单生成密钥和证书请求文件申请证书和Profile编译构建生成HAP编译构建生成APP上架结语 前言 9月鸿蒙开发者大会，12月16号HarmonyOS2.0手机开发者Beta版发布，相信在那之后将会有越来越多开发者加入鸿蒙开发这个系列中，那么开发的应用如何上架应用市场呢？今天将由深鸿会深大学习小组博主（Zzt_01-23）手把手教你上架HarmonyOS应用，本次应用源代码选取从零实现HarmonyOS（鸿蒙）运动手表两个游戏的合并、Harmo
HarmonyOS 签名打包并安装
qq_36158551的博客
12-23 2096
HarmonyOS应用通过数字证书（.cer文件）和Profile文件（.p7b文件）来保证应用的完整性，数字证书和Profile文件可通过申请发布证书和Profile文件获取。
【HarmonyOS开发】探究Hap与App包的结构与区别
qq_23334071的博客
12-26 3674
OpenHarmony 可以进行两种形式（Hap和App）的打包，HAP是用于本地调试的，APP包是用于上架发布的。 根据不同的设备类型，一个APP包可以包含多个HAP包。
HarmonyOS鸿蒙最全OpenHarmony—Hap包签名工具_hap-sign-tool，剖析framework面试 冲击HarmonyOS鸿蒙高级职位
2401_84871291的博客
05-16 536
OpenHarmony系统内置密钥库文件，文件名称为OpenHarmony.p12，内含根CA证书、中间CA证书、最终实体证书等信息，工具基于该密钥库文件对OpenHarmony应用进行签名。无应用签名证书场景： 开发者使用该工具对Hap包签名时，需按照签名步骤从第一步生成应用签名证书密钥对依次完成应用签名证书生成、profile文件签名、应用签名流程。有应用签名证书场景： 开发者可直接从签名步骤第三步对profile文件进行签名开始开发，使用应用签名证书和包含对应密钥的本地密钥库文件对应用进行签名。
HarmonyOS应用签名、打Hap包、Hap调试包真机安装步骤
qq_34462735的博客
12-26 7453
本文根据鸿蒙4.0版本文档，描述了鸿蒙app打包签名文件的生成、hap包打包及安装、鸿蒙应用真机安装等流程。
harmonyos 编译打包生成app,鸿蒙HarmonyOS DevEco编译构建生成HAP方法
weixin_30652105的博客
05-27 3785
HAP可以直接在模拟器或者真机设备上运行，用于HarmonyOS应用开发阶段的调试和查看运行效果。HAP按构建类型和是否签名可以分为以下四种形态：1、构建类型为Debug的HAP(带调试签名信息)：携带调试签名信息，具备单步调试等调试手段的HAP，用于开发者在真机或者模拟器中进行应用调试。2、构建类型为Debug的HAP(不带签名)：不带调试签名信息，具备单步调试等调试手段的HAP，仅能运行在模拟...
HarmonyOS鸿蒙ArkTS证件照生成模板
02-04
HarmonyOS鸿蒙操作系统引入了一种新的编程语言——ArkTS，它是专门为HarmonyOS设计的，旨在提高开发效率和跨平台兼容性。 ArkTS是TypeScript的方言，它结合了JavaScript的灵活性和静态类型的强安全性，使得开发人员...
HarmonyOS 鸿蒙小应用.zip
02-07
7. **编译与打包**：通过DevEco Studio，开发者可以将源代码编译为HAP（HarmonyOS Ability Package）文件，这是鸿蒙应用的打包格式，包含了应用的所有资源和代码。 8. **测试与调试**：IDE内置的调试工具支持模拟器...
HarmonyOS（commandline-tools-linux-2.0.0.2.zip）
11-08
2. **apksigner**: 签名工具，用于对APK或HAP（HarmonyOS应用程序包）进行签名，确保应用的完整性和安全性。 3. **dx**: 字节码转换工具，将Java字节码转换为Dalvik虚拟机或Art运行时能识别的格式。 4. **gradle**...
HarmonyOS开发基础
02-12
在HarmonyOS中，应用程序通常以APP Pack（Application Package）的形式发布，由一个或多个HAP（HarmonyOS Ability Package）和pack.info文件组成。HAP是Ability的部署包，是HarmonyOS应用的核心部分，其代码围绕...
HarmonyOS功能调试1
08-08
HarmonyOS功能调试1 HarmonyOS功能调试是HarmonyOS操作系统中的一种调试机制，旨在帮助开发者快速、轻松地测试和调试应用程序。该调试机制提供了多种调试工具和方法，包括预览器、模拟器和远程模拟器等。 一、预览...
【鸿蒙学习】HarmonyOS应用开发者基础 - 构建更加丰富的页面（一）
一个不断前行的程序者
08-14 659
ArkWeb是用于应用程序中显示Web页面内容的Web组件，为开发者提供页面加载、页面交互、页面调试等能力。可以实现移动端的混合式开发（Hybrid App）。
【鸿蒙学习】Stage模型与FA模型的对比与应用选择
一个不断前行的程序者
08-12 365
Stage模型是一种基于应用生命周期和功能模块划分的架构设计理念。它将应用分为多个阶段（Stage），每个阶段对应一个特定的任务或界面，使得应用结构更加清晰、开发更加高效。FA模型（Feature Ability Model）是鸿蒙OS中另一种应用架构设计理念，它以功能为单元，将应用划分为多个功能模块（Feature Ability），每个模块具有独立的生命周期和功能。Stage模型和FA模型各有优势，适用于不同的开发场景。普通开发者应根据项目需求、团队协作、性能要求等因素，选择最合适的模型。
HarmonyOS应用开发学习-ArkUI-容器组件
最新发布
08-15 788
设置导航点样式:-left: 设置导航点距离Swiper组件左边的距离。-size:设置导航点的直径。例如,"1fr 1fr 2fr'是将父组件分3列，将父组件允许的宽分为4等份，第一列占1份，第二列占1份，第三列占2份。例如,"1fr 1fr 2fr”是将父组件分三行，将父组件允许的高分为4等份，第一行占1份，第二行占一份，第三行占2份。网格容器，由“行”和“列”分割的单元格所组成，通过指定”项目”所在的单元格做出各种各样的布局。设置为false是为横向Tabs，设置为true时为纵向Tabs。
鸿蒙（API 12 Beta3版）【扩展屏投播开发指导】使用投播组件
鸿蒙的技术博客
08-14 1096
通过本节开发指导，可在系统镜像投屏后，获取投屏设备信息，实现扩展屏模式的投播，实现双屏协作的能力。
HarmonyOS Developer之生成二维码
weixin_47988426的博客
08-14 263
生成二维码
鸿蒙开发Location Kit（位置服务）如何设置
A1551143530的博客
08-13 463
鸿蒙Location Kit 是一个强大的位置服务工具包，允许开发者在应用程序中集成精确的定位功能。Location Kit 提供了多种定位模式，支持室内和室外定位，并结合了GPS、Wi-Fi、蓝牙和基站等多种定位技术。
harmonyos hap
05-25
HarmonyOS HAP（HarmonyOS Application Framework）是面向HarmonyOS平台的应用程序框架，它为开发者提供了一系列的API和工具，使得开发者可以更加轻松地开发出高质量的应用程序。HAP具有良好的跨设备兼容性，可以支持不同类型的设备和不同屏幕大小的设备。同时，HAP还提供了丰富的UI组件和多种开发语言的支持，使得开发者可以选择自己熟悉的语言进行开发。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值