鸿蒙南向开发实战：HAP编译

最新推荐文章于 2024-07-09 20:42:41 发布
最新推荐文章于 2024-07-09 20:42:41 发布
阅读量872 收藏 10
点赞数 20
分类专栏： 鸿蒙南向开发 鸿蒙 OpenHarmony 文章标签： harmonyos 华为 鸿蒙 OpenHarmony android 驱动开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/shudaoshanQAQ/article/details/138170235
版权
鸿蒙 同时被 3 个专栏收录
631 篇文章 58 订阅
订阅专栏
OpenHarmony
200 篇文章 2 订阅
订阅专栏
鸿蒙南向开发
126 篇文章 1 订阅
订阅专栏
本文详细介绍了HarmonyOS的HAP文件结构、FA与PA两种Ability框架模型、开发工具ohos_hap的使用方法，以及不同模型下的模板配置和操作步骤。涵盖了从基础概念到实际开发的全方位内容，包括资源管理、模板选择和证书配置等。
摘要由CSDN通过智能技术生成

基本概念

术语含义
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模板。
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"
}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员，可以直接领取这份资料

 获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

 有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。 

蜀道山QAQ
关注
  • 20
    点赞
  • 踩
  • 10
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
HarmonyOS NEXT 定制HAP多目标构建产物
shudaoshanQAQ的博客
04-23 1050
本案例展示如何将工程打包成不同版本，并单独配置资源文件，实现定制多目标构建产物功能。
鸿蒙（HarmonyOS）项目方舟框架（ArkUI）更改应用名称
adendean的博客
12-19 394
更改位置如下：entry->src->main->module.json5 更改文件内的lable值。鸿蒙（HarmonyOS）项目方舟框架（ArkUI）更改应用名称。按Ctrl点击lable值可以跳转值多语言和资源的值内。操作系统: Windows 10 专业版。lable对应的值也是多语言内容。
OpenHarmony4.1 编译系统hap
weixin_44205232的博客
04-10 791
OpenHarmony在源码中编译系统HAP
HarmonyOS之深入解析编译构建的配置和代码混淆
╰つ栺尖篴夢ゞ
07-25 1558
一、概述 编译构建是将 HarmonyOS 应用的源代码、资源、第三方库等打包生成 HAP 或者 APP 的过程。其中，HAP 可以直接运行在真机设备或者模拟器中；APP 则是用于应用上架到华为应用市场。 为了确保 HarmonyOS 应用的完整性，HarmonyOS 通过数字证书和授权文件来对应用进行管控，只有签名过的 HAP 才允许安装到设备上运行（如果不带签名信息，仅可以运行在模拟器中）；同时，上架到华为应用市场的 APP 也必须通过签名才允许上架。因此，为了保证应用能够发布和安装到设备上， 需要提
鸿蒙hap解压缩后,鸿蒙HI3516-HAP的编译
weixin_33517451的博客
05-29 909
目录：环境搭建请看https://device.harmonyos.com/cn/docs/start/introduce/oem_quickstart_3516_environment-00000010545019811.通过repo下载代码repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-ve...
OpenHarmony应用编译 - 如何在源码中编译复杂应用（3.2-Release）
TiZizzz
12-04 1224
本文档以系统应用Launcher为例，带大家了解如何通过系统源码编译应用的方式来打包预安装应用。
HarmonyOS 2.0鸿蒙应用开发实战教程视频教程2.4G
06-16
鸿蒙应用开发实战教程视频教程2.4G涵盖了从基础到进阶的全面内容，帮助开发者掌握在HarmonyOS上构建应用的核心技能。 在本教程中，你将学习到以下几个重要的知识点： 1. **HarmonyOS概述**：了解HarmonyOS的设计...
HarmonyOS开发基础
02-12
【HarmonyOS开发基础】是针对开发者学习HarmonyOS应用开发的重要内容，涵盖了移动应用前端界面的定制、国际化和本地化处理以及第三方库的使用等多个关键知识点。在HarmonyOS中，应用程序通常以APP Pack（Application...
鸿蒙应用开发从入门到实战书后答案
04-08
3. **编程语言与API**：鸿蒙应用开发支持Java、Kotlin和JavaScript等语言，主要使用HarmonyOS SDK中的API进行开发。书后答案会解答关于API的使用、调用方法及常见问题。 4. **UI界面设计**：HarmonyOS提供了...
HarmonyOS开发必备基础知识.pdf
10-14
HarmonyOS开发基础知识 HarmonyOS是一个基于微内核的操作系统，由华为公司开发。 HarmonyOS应用软件包以APP Pack（Application Package）形式发布，由一个或多个HAP（HarmonyOS Ability Package）以及描述每个HAP...
entycats:HAP合同（收集和托付）
03-28
在深入探讨"Entycats:HAP合同（收集和托付）"这个主题之前，我们首先需要理解几个关键概念。Entycats可能是一个基于区块链技术的数字收藏品平台，类似于CryptoKitties，允许用户购买、出售和繁殖独特的虚拟猫。HAP...
OpenHarmony 源码解析之SystemUi—Statusbar（TS）
1
03-25 1248
SystemUI应用是OpenHarmony中预置的系统应用，为用户提供系统相关信息展示及交互界面，包括系统状态、系统提示、系统提醒等，例如系统时间、电量信息。导入batteryInfo模块，监听系统电池事件，实时获取电池电量状态导入时间模块，调用JS内置函数，实时获取系统时间、日期、星期信息导入Wifi模块，监听设备Wlan通信与连接事件，实时获取Wifi开关、供电、连接名等信息。
【HarmonyOS开发】探究Hap与App包的结构与区别
qq_23334071的博客
12-26 3209
OpenHarmony 可以进行两种形式（Hap和App）的打包，HAP是用于本地调试的，APP包是用于上架发布的。 根据不同的设备类型，一个APP包可以包含多个HAP包。
鸿蒙应用开发项目新建过程与hap包生成方法
嵌入式技术开发
07-13 2634
今天主要和大家聊一聊，如何利用DevEco Studio创建工程项目，应用层的开发需要知道其中的配置方法。​1、打开DevEco Studio选择【Lite】Empty Ability项目2.点击next，输入项目名称（Project name），项目类型（Project type）选择Application，输入包名（Bundle name），项目存放路径（Save location），开发语言（Language）默认是JS，api支持版本（Compatible API version）这里选择SDK：A
Html Agility Pack (HAP) 应用入门
无知人生，记录点滴
12-18 4143
【爬虫】系列文章目录上一节简单介绍了 Html Agility Pack (HAP)：c# HTML 解析利器 。本节以一个简单的例子说说 Html Agility Pack (HAP)  的应用。一、下载 or 安装1、下载使用 VS 2015 之前的版本，需要将 Html Agility Pack (HAP) 发布版本下载到本地，然后添加引用。下载地址：HAP 1.4.6          1...
鸿蒙app生成HAP包及重构
m0_56450064的博客
03-16 3857
目录概述生成HAP包步骤对应用进行签名生成HAP包HAP包的重构步骤 参考文档： 编译构建生成HAP-编译构建-HUAWEI DevEco Studio使用指南-工具-HarmonyOS应用开发 概述 在此生成的是带自动化签名信息的Debug类型HAP包 带签名信息的HAP包（包括Debug和Release类型），可以在真机设备上运行。在构建HAP包前，需要对应用/服务进行签名。不带签名信息的HAP（包括Debug和Release类型），只能运行在模拟器设备上，不需要对应用/服务进行签名。 生成HAP包步骤
鸿蒙语言基础类库：【@ohos.util.ArrayList (线性容器ArrayList)】
最新发布
2301_76813281的博客
07-09 912
本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。点击或者复制转到。ArrayList是一种线性数据结构，底层基于数组实现。ArrayList会根据实际需要动态调整容量，每次扩容增加50%。ArrayList和[Vector]相似，都是基于数组实现。它们都可以动态调整容量，但Vector每次扩容增加1倍。ArrayList和[LinkedList]相比，ArrayList的随机访问效率更高。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值