【入门到实战】OpenHarmony南向开发:编译构建-HAP编译构建指南

OpenHarmony—Hap包签名工具 为了保证OpenHarmony应用的完整性和来源可靠,在应用构建时需要对应用进行签名。经过签名的应用才能在真机设备上安装、运行、和调试。developtools_hapsigner仓 提供了签名工具的源码,包含密钥对生成、CSR文件生成、证书生成、Profile文件签名、Hap包签名等功能。针对无需通过ACL跨级别申请权限的应用,DevEco Studio为开发者提供了自动化签名方案,可以一键完成应用/服务签名。具体可参考自动化签名方案。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


HAP编译构建

概述

基本概念

术语含义
HAPHarmony Ability Package,一个HAP文件包含应用的所有内容,由代码、资源、三方库及应用配置文件组成,其文件后缀名为.hap。
Ability应用的重要组成部分,是应用所具备能力的抽象。Ability是系统调度应用的最小单元,是能够完成一个独立功能的组件,一个应用可以包含一个或多个Ability。
FAFeature Ability,是FA模型的Ability框架下具有UI界面的Ability类型,用于与用户进行交互。Feature Ability唯一对应一种模板,即Page模板(Page Ability)。
PAParticle Ability,是在FA模型的Ability框架下无界面的Ability,主要为Feature Ability提供服务与支持,例如作为后台服务提供计算能力,或作为数据仓库提供数据访问能力。Particle Ability有三种模板,分别为Service模板(Service Ability)、Data模板(Data Ability)、以及Form模板(Form Ability)。
FA模型两种Ability框架模型结构的其中一种。是Ability框架在API 8及更早版本采用FA模型。FA模型将Ability分为FA(Feature Ability)和PA(Particle Ability)两种类型,其中FA支持Page Ability模板,PA支持Service ability、Data ability、以及Form ability模板。详情可参考FA模型综述。
Stage模型两种Ability框架模型结构的其中一种。从API 9开始支持。Stage模型将Ability分为Ability和ExtensionAbility两大类,其中ExtensionAbility又被扩展为ServiceExtensionAbility、FormExtensionAbility、DataShareExtensionAbility等等一系列ExtensionAbility。

功能简介

提供HAP编译构建功能,支持FA模型、Stage模型。

开发指导

编译子系统提供的模板

ohos_hap

声明一个HAP目标,该目标会生成一个HAP,最终将会打包到system镜像中。

支持的变量说明
hap_profileHAP的config.json,Stage模型对应module.json。
raw_assets原始assets,这些assets会直接拷贝到HAP的assets目录下。
resources资源文件,编译后放置在assets/entry/resources目录下
js_assetsjs资源,编译后放置在assets/js/default目录下。
ets_assetsets资源,编译后放置在assets/js/default目录下
deps当前目标的依赖
shared_libraries当前目标依赖的native库
hap_nameHAP的名字,可选,默认为目标名
final_hap_path用户可以制定生成的HAP的位置,可选,final_hap_path中会覆盖hap_name。
subsystem_nameHAP从属的子系统名,需要和ohos.build中的名字对应,否则将导致无法安装到system镜像中。
part_nameHAP从属的部件名,同subsystem_name。
js2abc是否需要将该HAP的js代码转换为ARK的字节码。
ets2abc是否需要将该HAP的ets代码转换为ARK的字节码。
certificate_profileHAP对应的授权文件,用于签名。
certificate_file证书文件,证书文件和授权文件,应用开发者需要去OpenHarmony官网申请。
keystore_pathkeystore文件,用于签名。
keystore_passwordkeystore的密码,用于签名。
key_aliaskey的别名。
module_install_name安装时的HAP名称。
module_install_dir安装到system中的位置,默认安装在system/app目录下。
js_build_mode可选,用于配置HAP是“release”还是“debug”模型编译,默认“release”。
ohos_app_scope

声明一个HAP的AppScope模块,该目标的app_profile和sources会在编译时拼接到具体的entry内编译,该模板只在Stage模型下使用。

支持的变量说明
app_profileHAP的AppScope中的app.json,只在Stage模型下使用。
sourcesHAP的AppScope中的资源resources,只在Stage模型下使用。
ohos_js_assets

js或ets代码,编译后放置在assets/js/default目录下,stage模型根据代码分别放置到js或ets目录。

支持的变量说明
hap_profileHAP的config.json,Stage模型对应module.json。
source_dirjs或ets代码路径,兼容FA模型的单ability配置到ability目录。
ets2abc当前为ets代码,主要用于卡片配置,其他应用可不配,使用ohos_hap中的配置。
js2abc当前为js代码,主要用于卡片配置,其他应用可不配,使用ohos_hap中的配置。
ohos_assets

原始assets,这些assets会直接拷贝到HAP的assets目录下。

支持的变量说明
sources原始assets的路径。
ohos_resources

资源文件,FA模型编译后放置在assets/entry/resources目录下,Stage模型编译后放置在resources目录下。

支持的变量说明
hap_profileHAP的config.json,Stage模型对应module.json。
sources资源文件路径。
deps当前目标的依赖。Stage模型需要配置对ohos_app_scope目标的依赖。

操作步骤

  1. 将开发完成的应用example放到applications/standard/目录下。

  2. 配置gn脚本applications/standard/example/BUILD.gn,FA模型简单示例如下(更多BUILD.gn配置见gn脚本配置示例):

    import("//build/ohos.gni") # 引用ohos.gni
    
    ohos_hap("example") {
      hap_profile = "./src/main/config.json" # config.json
      js_assets = ["./src/main/js/default"]
      raw_assets = ["./raw_assets"]
      resources = ["./src/main/resources"]
      shared_libraries = [
        "//third_party/libpng:libpng", # native库
      ]
      certificate_profile = "../signature/systemui.p7b" # Cer文件
      hap_name = "SystemUI-NavigationBar" # 名字
      part_name = "prebuilt_hap"
      subsystem_name = "applications"
    }
    
  3. 修改applications/standard/hap/ohos.build,示例如下:

    {
      "subsystem": "applications",
      "parts": {
        "prebuilt_hap": {
          "module_list": [
            ...
            "//applications/standard/example:example" # 添加编译目标
          ]
        }
      }
    }
    
  4. 编译命令:

    # 全量编译
    ./build.sh --product-name {product_name}
    
    # 单独编译HAP
    ./build.sh --product-name {product_name} --build-target applications/standard/example:example
    
  5. 编译产物,FA模型简单例子HAP解压视图如下:

      Length      Date    Time    Name
    ---------  ---------- -----   ----
         1439  2009-01-01 00:00   assets/raw_assets                                 -----> raw_assets
          354  2009-01-01 00:00   assets/entry/resources.index                      ------> resources
            1  2009-01-01 00:00   assets/entry/resources/base/media/attributes.key  ------> resources
            1  2009-01-01 00:00   assets/entry/resources/base/media/constants.key   ------> resources
            1  2009-01-01 00:00   assets/entry/resources/base/media/contents.key    ------> resources
         6790  2009-01-01 00:00   assets/entry/resources/base/media/icon.png        ------> resources
            1  2009-01-01 00:00   assets/entry/resources/base/media/nodes.key       ------> resources
        11170  2009-01-01 00:00   assets/js/default/app.js                          ------> js_assets
           48  2009-01-01 00:00   assets/js/default/i18n/en-US.json                 ------> js_assets
           50  2009-01-01 00:00   assets/js/default/i18n/zh-CN.json                 ------> js_assets
          224  2009-01-01 00:00   assets/js/default/manifest.json                   ------> js_assets
        41481  2009-01-01 00:00   assets/js/default/pages/index/index.js            ------> js_assets
          909  2009-01-01 00:00   config.json                                       ------> hap_profile
       266248  2009-01-01 00:00   libs/libpng.z.so                                  ------> shared_libraries
    

gn脚本配置示例

  • FA模型多ability示例

    import("//build/ohos.gni")
    
    ohos_hap("dataability") {
      hap_profile = "entry/src/main/config.json"
      deps = [
        ":dataability_js_assets",
        ":dataability_resources",
      ]
      certificate_profile = "signature/openharmony_sx.p7b"
      hap_name = "dataability"
      part_name = "prebuilt_hap"
      subsystem_name = "applications"
    }
    
    ohos_js_assets("dataability_js_assets") {
      ets2abc = true
      source_dir = "entry/src/main/ets"
      hap_profile = "entry/src/main/config.json"
    }
    
    ohos_resources("dataability_resources") {
      sources = [
        "entry/src/main/resources",
      ]
      hap_profile = "entry/src/main/config.json"
    }
    
    
  • FA模型Js卡片示例

    import("//build/ohos.gni")
    
    ohos_hap("FormOfFaJs") {
      hap_profile = "entry/src/main/config.json"
      deps = [
        ":FormOfFaJs_js_assets",
        ":FormOfFaJs_resources",
      ]
      certificate_profile = "signature/openharmony_sx.p7b"
      hap_name = "FormOfFaJs"
      part_name = "prebuilt_hap"
      subsystem_name = "applications"
    }
    
    ohos_js_assets("FormOfFaJs_js_assets") {
      hap_profile = "entry/src/main/config.json"
      js2abc = true
      source_dir = "entry/src/main/js"
    }
    
    ohos_resources("FormOfFaJs_resources") {
      sources = [
        "entry/src/main/resources",
      ]
      hap_profile = "entry/src/main/config.json"
    }
    
  • FA模型Ets卡片示例

    import("//build/ohos.gni")
    
    ohos_hap("FormOfFaEts") {
      hap_profile = "entry/src/main/config.json"
      deps = [
        ":FormOfFaEts_js_assets",
        ":FormOfFaEts_form_js_assets",
        ":FormOfFaEts_resources",
      ]
      certificate_profile = "signature/openharmony_sx.p7b"
      hap_name = "FormOfFaEts"
      part_name = "prebuilt_hap"
      subsystem_name = "applications"
    }
    
    ohos_js_assets("FormOfFaEts_js_assets") {
      hap_profile = "entry/src/main/config.json"
      ets2abc = true
      source_dir = "entry/src/main/ets"
    }
    
    ohos_js_assets("FormOfFaEts_form_js_assets") {
      hap_profile = "entry/src/main/config.json"
      js2abc = true
      source_dir = "entry/src/main/js"
    }
    
    ohos_resources("FormOfFaEts_resources") {
      sources = [
        "entry/src/main/resources",
      ]
      hap_profile = "entry/src/main/config.json"
    }
    
  • Stage模型简单示例

    import("//build/ohos.gni")
    
    ohos_hap("actmoduletest") {
      hap_profile = "entry/src/main/module.json"
      deps = [
        ":actmoduletest_js_assets",
        ":actmoduletest_resources",
      ]
      certificate_profile = "signature/openharmony_sx.p7b"
      hap_name = "actmoduletest"
      part_name = "prebuilt_hap"
      subsystem_name = "applications"
    }
    
    ohos_app_scope("actmoduletest_app_profile") {
      app_profile = "AppScope/app.json"
      sources = [ "AppScope/resources" ]
    }
    
    ohos_js_assets("actmoduletest_js_assets") {
      ets2abc = true
      source_dir = "entry/src/main/ets"
    }
    
    ohos_resources("actmoduletest_resources") {
      sources = [
        "entry/src/main/resources",
      ]
      deps = [
        ":actmoduletest_app_profile",
      ]
      hap_profile = "entry/src/main/module.json"
    }
    
  • Stage模型卡片示例

    import("//build/ohos.gni")
    
    ohos_hap("FormOfStageEts") {
      hap_profile = "entry/src/main/module.json"
      deps = [
        ":FormOfStageEts_js_assets",
        ":FormOfStageEts_form_js_assets",
        ":FormOfStageEts_resources",
      ]
      js_build_mode = "debug"  # 默认release
      certificate_profile = "signature/openharmony_sx.p7b"
      hap_name = "FormOfStageEts"
      part_name = "prebuilt_hap"
      subsystem_name = "applications"
    }
    
    ohos_js_assets("FormOfStageEts_js_assets") {
      hap_profile = "entry/src/main/module.json"
      ets2abc = true
      source_dir = "entry/src/main/ets"
    }
    
    ohos_js_assets("FormOfStageEts_form_js_assets") {
      hap_profile = "entry/src/main/module.json"
      js2abc = true
      source_dir = "entry/src/main/js"
    }
    
    ohos_app_scope("FormOfStageEts_app_profile") {
      app_profile = "AppScope/app.json"
      sources = [ "AppScope/resources" ]
    }
    
    ohos_resources("FormOfStageEts_resources") {
      sources = [
        "entry/src/main/resources",
      ]
      deps = [
        ":FormOfStageEts_app_profile",
      ]
      hap_profile = "entry/src/main/module.json"
    }

鸿蒙OpenHarmony【HAP编译构建】子系统 提供HAP编译构建功能,支持FA模型、Stage模型。 阅读详情

相关推荐

鸿蒙开发(OpenHarmony)HAP编译构建指导

提供HAP编译构建功能,支持FA模型、Stage模型。

WEZC156465的博客 1564

HarmonyOS/OpenHarmony应用开发-程序包多HAP机制(上)

HarmonyOS/OpenHarmony应用开发-程序包多HAP机制

weixin_69135651的博客 2101

OpenHarmony 实战开发—Hap包签名

为了保证OpenHarmony应用的完整性和来源可靠,在应用构建时需要对应用进行签名。经过签名的应用才能在真机设备上安装、运行、和调试。developtools_hapsigner仓 提供了签名工具的源码,包含密钥对生成、CSR文件生成、证书生成、Profile文件签名、Hap包签名等功能。针对无需通过ACL跨级别申请权限的应用,DevEco Studio为开发者提供了自动化签名方案,可以一键完成应用/服务签名。具体可参考自动化签名方案。

m0_70748458的博客 1698

OpenHarmony 3.1 Beta版本关键特性解析——HAP包安装实现剖析

(以下内容来自开发者分享,不代表 OpenHarmony 项目群工作委员会观点) 石磊 随着社会的不断发展,人们逐渐注重更加高效、舒适、便捷、有趣的生活和工作体验。 OpenAtom OpenHarmony(以下简称“OpenHarmony”)作为面向下一代的分布式操作系统,具有全场景、多设备、自然交互、便捷精准的技术特点,为行业数字化转型的高速发展提供领先的技术基础,为用户体验的创新满足提供了新思路。 为了让大家深入了解 OpenHarmony 的技术特点,本期对 OpenHa

OpenHarmony_dev的博客 5766

OpenHarmony 实战开发——应用HAP包签名

DevEco Studio开发工具为开发人员提供了非常友好的HAP自动签名功能及非常便捷的Debug包。由于IDE的安全密码要求,对于Release包的发布我们暂时需要手动签名,尤其是系统级的应用。

鸿蒙开发知识记录 2210

OpenHarmony实战开发-Hap包签名工具指导

1.该工具基于Gradle 7.1编译构建,请确认环境已安装配置Gradle环境,并且版本高于或等于7.1。

m0_70749039的博客 2088

OpenHarmony4.1 编译系统hap

OpenHarmony在源码中编译系统HAP

weixin_44205232的博客 2902

【鸿蒙南向实战开发】OpenHarmony应用编译 - 如何在源码中编译复杂应用

●在 OpenHarmony 系统中预安装应用的 hap 包会随系统编译打包到镜像中,目前有两种编译预安装应用 hap 包的方式,一种为随系统编译时,编译应用源码生成 hap 包的方式,另一种是将已生成的 hap 包放入系统源码中,再进行打包的方式。后者需要开发者使用 DevEco Studio 或其它途径,把应用源码编译构建为 hap 包,再将 hap 放入系统源码中。

HarmonyOS_666的博客 1437

Flutter for OpenHarmony 实战:工程落地 — 签名、HAP 编译打包与真机发布全流程

本文详细介绍了如何将Flutter开发的Splendid Movie应用打包发布到OpenHarmony设备。主要内容包括:1)通过DevEco Studio配置签名证书,解决真机调试问题;2)使用Flutter命令编译生成HAP格式安装包;3)通过hdc工具安装到鸿蒙手机并进行调试。文章还提供了常见错误排查方法,总结了从UI设计到打包发布的完整开发流程,展示了Flutter在OpenHarmony生态中的跨平台开发能力。该系列教程为开发者提供了从设计到落地的完整参考方案。

jiang_style的博客 1万+

【鸿蒙南向开发】OpenHarmony应用编译 - 如何在源码中编译复杂应用

在 **OpenHarmony** 系统中预安装应用的 **hap** 包会随系统编译打包到镜像中,目前有两种编译预安装应用 **hap** 包的方式,一种为随系统编译时,编译应用源码生成 **hap** 包的方式,另一种是将已生成的 **hap** 包放入系统源码中,再进行打包的方式。后者需要开发者使用 **DevEco Studio** 或其它途径,把应用源码编译构建为 hap 包,再将 **hap** 放入系统源码中。

HarmonyOS_666的博客 1202

【鸿蒙南向开发】—— FAQ问题定位:模块如何单独编译构建

众所周知,当前 OpenHarmony 模块十分庞大,非计算云全量编译代码十分耗时。如果修改、验证单一模块是没有必要全量编译的。注意镜像必须和本地代码日期尽量一致,代码可以稍晚于镜像。核心方法就是从每日构建下载烧录镜像,本地编译单一模块,烧录镜像,推送单一模块进行验证。以下以 RK3568 开发板,主线代码为例进行说明。

huchenghe2的博客 803

【入门到实战】OpenHarmony南向开发:编译构建-模块配置规则

编译子系统通过模块、部件和产品三层配置来实现编译和打包。

Androidbye的博客 1116

OpenHarmony 实战开发——如何编译OpenHarmony自带APP

OpenHarmony 的主干代码是开源社区的重要学习资源,对于想进行应用开发和熟悉 OpenHarmony 能力的同学主干代码是非常重要的资源,在主干代码的 applications 目录里聚集了很多原生的应用实现,那么如何编译这些代码就是我们这篇文章的主要议题。

m0_70748458的博客 1302

OpenHarmony实战—Hap包签名工具

为了保证OpenHarmony应用的完整性和来源可靠,在应用构建时需要对应用进行签名。经过签名的应用才能在真机设备上安装、运行、和调试。developtools_hapsigner仓 提供了签名工具的源码,包含密钥对生成、CSR文件生成、证书生成、Profile文件签名、Hap包签名等功能。针对无需通过ACL跨级别申请权限的应用,DevEco Studio为开发者提供了自动化签名方案,可以一键完成应用/服务签名。具体可参考自动化签名方案。

2501_91726491的博客 1654

HarmonyOS 鸿蒙开发DevEco Studio OpenHarmony:编译构建概述

编译构建是将OpenHarmony应用/服务的源代码、资源、第三方库等,通过编译工具转换为可直接在硬件设备上运行的二进制机器码,然后再将二进制机器码封装为HAP/APP软件包,并为HAP/APP包进行签名的过程。其中,HAP是可以直接运行在真机设备中的软件包;APP则是用于应用/服务上架到应用市场,关于HAP和APP的关系说明请参考OpenHarmony工程介绍。

斌擎科技 1519

PMF5.0计算

EPA PMF5.0 计算步骤

nuistsy的博客 4547

OpenHarmony 实战开发:应用HAP包签名

DevEco Studio开发工具为开发人员提供了非常友好的HAP自动签名功能及非常便捷的Debug包。由于IDE的安全密码要求,对于Release包的发布我们暂时需要手动签名,尤其是系统级的应用。鸿蒙(HarmonyOS)北向开发知识点记录~鸿蒙(OpenHarmony)南向开发保姆级知识点汇总~鸿蒙应用开发与鸿蒙系统开发哪个更有前景?嵌入式开发适不适合做鸿蒙南向开发?看完这篇你就了解了~对于大前端开发来说,转鸿蒙开发究竟是福还是祸?鸿蒙岗位需求突增!移动端、PC端、IoT到底该怎么选?

xianglizaibie的博客 750

原形网络(Prototypical Networks)基于PyTorch的实现

我在Jay2coomzz的基础上修改了数据处理方式和evaluation_model()方法,作为初学者若有不当之处恳请大家批评指正,原文链接如下: https://blog.youkuaiyun.com/weixin_38471579/article/details/102631018 数据集和源码链接将放到评论区 文章目录1 数据集一个简单的数据集介绍数据集处理2 搭建网络CNNProtonets 1 数据集 一个简单的数据集介绍 Omniglot数据集一共包含1623 类手写体,每一类中包含20 个样本。其中.

weixin_43872532的博客 6637
上一篇: 【入门到实战】OpenHarmony南向开发:编译构建-deps、external_deps的使用指南
下一篇: 【入门到实战】OpenHarmony南向开发:Rust编译构建指南-Rust模块配置规则
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值