【鸿蒙实战开发】基于HAR的跨模块C++头文件引用

最新推荐文章于 2025-08-04 16:52:11 发布

原创

最新推荐文章于 2025-08-04 16:52:11 发布 · 1k 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #c++ #音视频 #ffmpeg #鸿蒙 #ui

场景描述

多个模块使用同一份C++代码是App开发中很常见的问题，比如多个模块使用同一个自研的加解密库、集成三方开源SO库暴露其中的C++代码等。以下列举跨调用C++方法的典型场景：

场景：模块A引用模块B的C++接口

方案描述：

如图所示，通过5个步骤实现，desHar引用srcHar的C++接口：

源码及详细说明：

1、将需要导出的C++头文件放至srcHar模块下的固定目录

首先需要在srcHar/src/main/cpp目录下新建include目录

// srcHar/src/main/cpp/include/test.h

// 此处将头文件放置include目录下

int add(int a,int b)

2、在srcHar模块的build-profile.json5中配置C++头文件的目录

// srcHar/build-profile.json5

{

"apiType": "stageMode",

"buildOption": {

"nativeLib": {

"headerPath": "src/main/cpp/include"

},

"externalNativeOptions": {...},

},

"buildOptionSet": [...],

"targets": [...]

}

使用add_library将test.cpp内的C++代码打到名称为srcHar的so库中。

// srcHar/src/main/cpp/CMakeLists.txt

add_l

最低0.47元/天解锁文章

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

「已注销」

关注关注

15
点赞
踩
11

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

鸿蒙应用开发之调用C++开发代码库2

大坡3D软件开发

05-15

921

是C++库，版本为10.0.1，libc++ 是C++标准库的一种实现，C++11、C++14标准已完全支持，C++17和C++20标准正在完善。接着下来先分析C++部分的代码，主要关注点是C++代码要怎么样编写，才能被ArkTS代码调用，它们之间的数据类型又是怎么样转换的。有了这两个文件，就可以知道C++代码生成库的名称为libhello.so，并且符合index.d.ts类型导出的动态连接库。在这里定义了加载C++库的名称为libhello.so，同时指明类型声明在文件./index.d.ts里。

鸿蒙应用开发之调用C++开发代码库1

大坡3D软件开发

05-14

856

由于鸿蒙应用主要基于ArkTS开发，主要使用的语言是ETS，也就是JS脚本方式来开发，这与C++语言开发是不同的语言，这样就不能直接相互调用，因为不同的语言使用不同的数据结构，不同的调用方式，不同的运行环境。因为C++语言开发的底层库已经比较长的时间，即使不考虑性能的情况之下，也需要很大的工作量来重写和测试，所以ArkTS一定需要能调用C++代码的能力，这样才能方便旧的项目，或者性能要求比较高的项目进行开发。简单起见，先来学习一个鸿蒙代码库提供的一个例子，这样杜绝各种创建项目的不同，以及填写不同的参数。

参与评论您还未登录，请先登录后发表或查看评论

华为鸿蒙开发——开发及引用静态共享包（HAR）、应用配置文件

qq_64131064的博客

12-07

4911

HAR不同于HAP，不能独立安装运行在设备上，只能作为应用模块的依赖项被引用。资源目录的示例如下所示，base目录、限定词目录、rawfile目录称为资源目录，element、media、profile称为资源组目录。每个应用项目必须在项目的代码目录下加入配置文件，这些配置文件会向HarmonyOS的编译工具、HarmonyOS操作系统和应用市场。在FA模型的应用开发过程中，需要在config.json配置文件中对应用的包结构进行声明。编译构建的HAR可在模块下的build目录下获取，包格式为*.har。

基于HAR的跨模块C++头文件引用

hongxiaomeng的博客

06-04

578

基于C++能力的资源访问

hongxiaomeng的博客

06-07

729

鸿蒙(HarmonyOS)实战开发篇——基于HAR的跨模块C++头文件引用

lc748258的博客

10-07

1320

多个模块使用同一份C++代码是App开发中很常见的问题，比如多个模块使用同一个自研的加解密库、集成三方开源SO库暴露其中的C++代码等。注意事项：双冒号前面指的是srcHar/oh-package.json5配置中的name，双冒号后面跟着的是步骤2中srcHar中对外导出的的so库名称，名称必须要一致。5、在desHar的cpp源码中使用 srcHar提供的C++方法。1、将需要导出的C++头文件放至srcHar模块下的固定目录。场景：模块A引用模块B的C++接口。2.构建第一个ArkTS应用。

HarmonyOS 实战开发 —— 基于HAR的跨模块C++头文件引用

CTrup的博客

11-12

340

多个模块使用同一份C++代码是App开发中很常见的问题，比如多个模块使用同一个自研的加解密库、集成三方开源SO库暴露其中的C++代码等。注意事项：双冒号前面指的是srcHar/oh-package.json5配置中的name，双冒号后面跟着的是步骤2中srcHar中对外导出的的so库名称，名称必须要一致。2、在srcHar模块的build-profile.json5中配置C++头文件的目录。5、在desHar的cpp源码中使用 srcHar提供的C++方法。场景：模块A引用模块B的C++接口。

鸿蒙OS开发实例：【Native C++】

鸿蒙的技术博客

04-12

4641

本篇Codelab主要介绍如何使用DevEco Studio创建一个Native C++应用。应用采用Native C++模板，实现使用NAPI调用C标准库的功能。使用C标准库hypot接口计算两个给定数平方和的平方根。在输入框中输入两个数字，点击计算结果按钮显示计算后的数值。

鸿蒙OS模块化引用

Looper的博客

05-14

628

六、在entry中引入lib，打开entry的oh-package.json5文件夹，添加lib。二、新建util目录，创建Log工具类，并export暴露这个类。三、在utils目录中新建Index.ets文件。四、在ets目录下新建Index.ets文件。五、在model的Index文件添加如下内容。

安卓应用移植鸿蒙（三）：Native的C++代码移植（jni和so库）

memoryjs的专栏

08-31

3300

这个也是绕不过去的砍，早起的鸿蒙版本里，Native代码支持的设备类型只有车机，新的DevEco才支持手机，笔者一开始也是找了很多文章，发现一篇文章讲的很详细，贴给大家，我就不赘述了，我按照他们的方法，成功移植的Native的代码带鸿蒙上。鸿蒙JNI开发实战，这篇文章写得很详细，步骤也很清晰，我就说几点它里面没提到的 1、鸿蒙只支持armv8a的架构，如果你在Gradle的Fliter里面写上armv7a，编译会报错（猜测是分布式系统64位的便于寻址和管理） 2、lib++.so一定要引入，这点和安

鸿蒙应用开发之调用C++开发代码库3

大坡3D软件开发

05-16

579

extern "C"的作用就是声明这个函数是以C语言接口方式导出，方便JS引擎加载模块时，可以按C的方式执行函数RegisterModule，RegisterModule的作用是把本模块的信息demoModule放到引擎的调用队列里，以便后面TS代码执行时去查找队列。"myHypot"是声明在文件index.d.ts的函数，也就是JS引擎可以识别的函数，而MyHypot是C++的函数，这中间的转换就靠NAPI框架转换了。我们从JS调用框架图就知道，调用主要分为三层，JS开发的C++模块、框架层、JS引擎。

鸿蒙应用开发之调用C++开发代码库4

大坡3D软件开发

05-16

344

在这里调用函数napi_create_double，它是用来从C++类型double创建一个JS类型对象返回，并且把返回结果保存在变量napiResult，由于napi_value是指针，那么&napiResult就是指向指针的指针。返回值采用napi_value类型定义，napi_value类型是一个指针类型，并且是一个通用的指针类型，其实它就是相当于void*类型，可以保存任何类型的数值指针。接着定义它返回napi_value类型，这个类型是NAPI的通用类型，可以表示数字、字符串和布尔值等。

鸿蒙HarmonyOS应用开发之C/C++标准库机制概述

03-27

4027

OpenHarmony NDK提供业界标准库 libc标准库、 C++标准库，本文用于介绍C/C++标准库在OpenHarmony中的机制，开发者了解这些机制有助于在NDK开发过程中避免相关问题。

鸿蒙开发napi系列学习高阶篇——通过IDE集成C/C++三方库并开发napi接口

m0_70748458的博客

05-17

1872

应用在调用系统固件集成的C/C++三方库时，可能会由于系统固件集成端与IDE的NDK中libc++版本不一致导致调用失败，而且系统固件集成的C/C++三方库对于应用的调式也很不友好，需要多方编译调试，很不方便。因此本文将通过在IDE上适配openjpeg 三方库为例介绍IDE上适配一个C/C++三方库的具体流程。根据原生库的测试用例，我们封装2个测试用例接口} J2K_Info;

【鸿蒙南向开发】如何移植一个C++开源库

HarmonyOS_666的博客

07-22

1346

本文主要介绍了在 OpenHarmony 下如何移植一个开源库，手写一个 BUILD.gn、编译运行这份鸿蒙（HarmonyOS NEXT）文档包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

HarmonyOS中调用C/C++代码（NDK）

热门推荐

NBDR_YL的博客

09-28

2万+

近日在开发过程中，遇到一个问题。将字符串转为十六进制，利用snprintf转换str的格式。下面贴上代码实现。 #include <stdio.h> void test_printf5(char *str,int length) { int iii; printf("the str is:"); for(iii= 0;iii <length;iii++) { printf("%02x ",str[iii]); } printf("\n"); } /*str

HarmonyOS NEXT - 应用程序包开发与使用 - HAR

u011143672的博客

06-13

1507

HAR（Harmony Archive）是静态共享包，可以包含代码、C++库、资源和配置文件。通过HAR可以实现多个模块或多个工程共享ArkUI组件、资源等相关代码。

鸿蒙开发 HAR模块图片$r引用

04-05

<think>好的，用户的问题是关于鸿蒙开发中HAR模块如何处理图片资源引用。我需要结合提供的引用内容来回答。首先，用户提到的引用[2]和[3]是关键，因为里面详细说明了HAR的资源和限制。首先，HAR模块可以包含资源文件，包括图片，这点在引用[2]里提到。接下来，用户想知道如何正确引用这些图片资源。根据引用[2]，HAR模块的图片资源需要放在特定的资源目录下，比如"resources/base/media"，然后通过模块名、资源类型和名称来访问，格式是$r('app.moduleName.type.name')。比如，模块名是hsp，图片放在media目录下，名为icon.png，那么路径就是$r('app.hsp.media.icon')。另外，需要注意HAR的一些限制。比如，引用[3]提到，如果HAR开启了混淆，资源ID会变成-1，这时候不能使用ResourceManager通过ID获取资源，所以必须用命名引用的方式。同时，引用[2]还指出HAR不能引用AppScope的资源，所以图片必须放在HAR自己的资源目录里。用户可能需要知道实际操作的步骤，比如如何创建目录结构，如何正确编写引用代码。还要提醒他们避免常见的错误，比如混淆后的处理，以及不能使用AppScope的资源。总结起来，回答需要涵盖资源存放位置、引用方法、注意事项，并结合实际例子说明。</think>在鸿蒙（HarmonyOS）开发中，HAR模块的图片资源引用需遵循以下规范和方法： ### 一、图片资源存放与引用步骤 1. **资源目录规范** 将图片资源放置在HAR模块的`resources > base > media`目录下，例如： ```lua resources └── base └── media └── icon.png ``` 2. **资源引用语法** 使用**$r('app.moduleName.type.name')**格式访问资源： ```typescript // 示例：HAR模块名为hsp，图片名称为icon.png Image($r('app.hsp.media.icon')) ``` ### 二、关键注意事项 1. **混淆兼容性** HAR开启混淆后需使用**命名引用**而非ID访问资源，否则会因资源ID变为-1导致失败[^3]。 2. **跨模块限制** - 禁止引用主模块`AppScope`中的资源[^2] - 不支持通过`ResourceManager.getResource`等ID相关API获取资源[^3] 3. **编译特性** 未开启混淆时编译产物为源码文件，开启后生成优化后的二进制文件。 ### 三、典型错误场景 ```typescript // 错误示例：直接使用相对路径 Image('common/icon.png') // 编译报错 // 正确示例：通过资源管理器引用 Image($r('app.hsp.media.icon')) ``` ### 四、扩展应用场景通过HAR可集中管理多模块共用的图标、背景图等资源，配合OHPM私仓实现企业级组件库的图片资源标准化管理[^2]。