鸿蒙Next中C++文件如何导出引用

在鸿蒙Next系统中，使用C++开发时如何正确导出和引用文件？具体需要配置哪些编译参数或宏定义？如果涉及到跨模块调用，应该如何设置共享库的可见性？能否提供具体的代码示例或配置文件模板？

2 回复

鸿蒙Next里C++想被其他模块调用？用__attribute__((visibility("default")))给函数或类贴个“欢迎使用”的标签就行！记得在编译时加-fvisibility=hidden藏好其他没贴标签的，不然它们会像超市试吃员一样全跑出来。简单说：想导出的函数前加个魔法标记，编译选项里开个隐身模式，搞定！

更多关于鸿蒙Next中C++文件如何导出引用的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在鸿蒙Next（HarmonyOS NEXT）中，C++文件导出引用主要通过模块定义文件（.def） 或使用导出宏来实现，确保其他模块或应用能够调用C++库中的函数。以下是具体方法：

1. 使用模块定义文件（.def）

创建一个.def文件，列出需要导出的函数名。例如，在项目目录中创建mylib.def：

EXPORTS
    MyFunction1
    MyFunction2
  • 在BUILD.gn中配置该文件：
shared_library("mylib") {
  sources = [
    "mylib.cpp",
  ]
  def = "mylib.def"  # 指定模块定义文件
}

2. 使用导出宏

在C++头文件中，使用__attribute__((visibility("default")))或鸿蒙提供的宏（如OHOS_EXPORT）声明导出函数：

// mylib.h
#ifdef __cplusplus
extern "C" {
#endif

// 方法1：使用GCC属性
__attribute__((visibility("default"))) void MyFunction1();

// 方法2：使用鸿蒙宏（需包含对应头文件）
// #include "hilog/log.h"
// OHOS_EXPORT void MyFunction2();

#ifdef __cplusplus
}
#endif

在源文件mylib.cpp中实现函数：

#include "mylib.h"
void MyFunction1() {
    // 函数实现
}

3. 在BUILD.gn中配置共享库

确保BUILD.gn正确声明共享库：

shared_library("mylib") {
  sources = [
    "mylib.cpp",
    "mylib.h",
  ]
  include_dirs = [ "include" ]  # 包含头文件路径
  # 如果使用.def文件，添加 def = "mylib.def"
}

注意事项：

  • 名称修饰问题：C++函数可能因编译器修饰名称导致链接失败。建议使用extern "C"包裹导出函数，确保名称不变。
  • 依赖管理：在调用方的BUILD.gn中，通过deps添加对该库的依赖：
    executable("myapp") {
  sources = [ "main.cpp" ]
  deps = [ ":mylib" ]
}
  • 文档参考：具体宏定义可能因鸿蒙版本而异，请查阅官方NDK文档获取最新信息。

以上方法适用于鸿蒙Next的C++动态库开发，确保函数正确导出并可被外部调用。

回到顶部