鸿蒙OpenHarmony【HAP编译构建】子系统

HAP编译构建指导

概述

基本概念

术语 含义
HAP Harmony Ability Package,一个HAP文件包含应用的所有内容,由代码、资源、三方库及应用配置文件组成,其文件后缀名为.hap。
Ability 应用的重要组成部分,是应用所具备能力的抽象。Ability是系统调度应用的最小单元,是能够完成一个独立功能的组件,一个应用可以包含一个或多个Ability。
FA Feature Ability,是FA模型的Ability框架下具有UI界面的Ability类型,用于与用户进行交互。Feature Ability唯一对应一种模板,即Page模板(Page Ability)。
PA Particle 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_profile HAP的config.json,Stage模型对应module.json。
raw_assets 原始assets,这些assets会直接拷贝到HAP的assets目录下。
resources 资源文件,编译后放置在assets/entry/resources目录下
js_assets js资源,编译后放置在assets/js/default目录下。
ets_assets ets资源,编译后放置在assets/js/default目录下
deps 当前目标的依赖
shared_libraries 当前目标依赖的native库
hap_name HAP的名字,可选,默认为目标名
final_hap_path 用户可以制定生成的HAP的位置,可选,final_hap_path中会覆盖hap_name。
subsystem_name HAP从属的子
<think>好的,我现在要帮助用户了解如何学习OpenHarmony源码以及进行编译构建。首先,我需要整理用户提供的引用内容,看看里面有没有相关的指导信息。用户给出了四个引用,都是关于OpenHarmony编译过程和构建工具的。引用1提到编译过程分析完毕,并推荐另一篇关于编译构建的文章。引用2介绍了OpenHarmony的背景和学习阶段,分为看、实操、写。引用3提到DevEco Studio和Hvigor构建工具。引用4详细解释了构建工具链,包括GN、Ninja、clang/llvm等。 接下来,我需要根据这些信息构建一个结构清晰的回答。用户的需求是学习源码和编译构建的教程,所以需要分步骤来指导。可能需要包括环境准备、源码获取、工具链理解、编译配置、实操步骤、问题排查等部分。同时,用户要求生成相关问题,所以还要考虑可能的相关问题。 首先,回答的结构应该按照学习步骤来组织,比如从环境准备开始,然后获取源码,再了解工具链,接着配置编译,最后实操。每个步骤中需要引用提供的资料中的内容,比如引用4提到的GN、Ninja等工具,需要解释清楚它们的作用。引用2提到的学习阶段可以作为框架,引导用户从理论到实践再到总结。 同时,需要确保使用正确的中文表达,行内公式用$...$,独立公式用$$...$$,但当前问题可能不涉及数学公式,所以可能不需要使用。但需要检查是否有需要用到的地方,比如构建过程中的某些参数或命令是否需要特别标注。 然后,生成相关问题需要考虑用户可能进一步想知道的内容,比如编译优化方法、构建失败处理、与其他系统的对比等。根据引用中的内容,比如引用4提到后续会出编译和链接的问题解决,所以相关问题可以涉及常见问题处理。 最后,确保所有引用标识正确添加,比如在提到编译工具链时引用[^4],在环境准备时引用[^3]提到的DevEco Studio。需要自然地在段落末尾添加引用标识,避免打断阅读。 现在需要整合这些思考,按照用户提供的结构来组织回答,确保每个步骤清晰,引用正确,并且生成的相关问题有针对性。</think>### OpenHarmony源码学习与编译构建教程 #### 一、学习准备阶段 1. **环境搭建** - 操作系统:建议使用Ubuntu 18.04及以上版本(官方推荐)。 - 工具链安装:需安装`gn`、`ninja`、`clang/llvm`等核心工具,可通过OpenHarmony官方文档获取安装脚本[^4]。 - 开发工具:推荐使用DevEco Studio作为IDE,支持Hvigor构建插件,用于任务编排和HAP/APP包生成。 2. **源码获取** - 通过官方仓库或镜像站点下载源码,建议使用`repo`工具管理多仓库代码: ```bash repo init -u https://gitee.com/openharmony/manifest.git -b master repo sync -c ``` #### 二、理解编译构建框架 1. **工具链组成** - **GN**:生成`ninja`构建文件,语法简洁,支持模块化配置[^4]。 - **Ninja**:专注于编译速度,通过`gn`生成的`.ninja`文件驱动编译流程。 - **Clang/LLVM**:负责代码编译与优化,支持多平台交叉编译。 2. **构建流程解析** - **配置阶段**:通过`hb set`命令选择目标设备(如Hi3516开发板)。 - **编译阶段**:执行`hb build`触发GN生成构建文件,并由Ninja调用Clang完成编译链接。 - **输出结果**:生成HAP/APP包,位于`out/[device]/[project]/`目录下。 #### 三、实操步骤 1. **首次编译示例** ```bash # 初始化配置 hb set # 选择目标平台(如@ohos_hi3516dv300) hb build -f # 全量编译 ``` 2. **模块化编译** - 若仅需编译特定组件(如`kernel`),可通过以下命令实现: ```bash hb build kernel ``` #### 四、常见问题与优化 1. **依赖缺失** - 若编译报错提示工具缺失,需检查Python版本(要求3.7+)及`gn/ninja`路径配置。 2. **加速编译** - 启用并行编译:`ninja -j [线程数]`,利用多核CPU提升速度[^4]。 - 增量编译:仅修改代码后重新运行`hb build`,避免全量编译。 #### 五、深入学习建议 - **源码结构分析**:重点关注`build/lite`目录,包含编译配置与脚本[^2]。 - **构建扩展**:自定义`BUILD.gn`文件实现新模块添加,参考官方文档中的GN语法指南[^4]。 - **调试技巧**:通过`ninja -v`输出详细编译日志,定位失败原因。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值