OpenHarmony C/C++三方库移植适配指南

OpenHarmony 生态中 C/C++ 三方库移植需解决编译兼容性、架构适配、功能验证等核心问题。本指南整合风险识别工具、高效编译框架及多场景适配方案，帮助开发者快速完成三方库移植与验证。

一、移植前准备：风险识别与预处理

移植前需先排查三方库与 OpenHarmony 的兼容性风险，优先使用专用工具扫描符号不兼容问题。

• 风险识别工具：使用 C/C++三方库风险识别工具，核心检测不同系统间的 symbol 不兼容问题。
• 工具使用方法：参照 工具官方指南，通过命令行指定三方库路径、黑白名单表格路径即可执行扫描，支持分批次数据合并与汇总。
• 注意事项：工具运行时可能删除三方库文件中的注释代码，建议扫描前备份原始文件。

二、核心移植工具：lycium 交叉编译框架

针对开源库编译方式多样化（cmake、configure、make 等）、手动适配耗时的问题，推荐使用华为开发的 lycium 交叉编译框架，无需修改原生源码即可快速构建 OpenHarmony 兼容的二进制文件。

框架核心优势

• 支持 cmake、configure、make 等多种构建方式，无需手动改写编译脚本。
• 提供标准化编译模板（HPKBUILD）和自动化测试模板（HPKCHECK），降低配置成本。
• 编译产物自动打包至指定目录，支持多架构适配与依赖管理。

关键配置与使用

• 编译模板参考：HPKBUILD 模板详情可查阅 官方模板文档，需按三方库实际编译参数修改。
• 基础命令：
  • 编译所有库：./build.sh
  • 编译指定库（需包含依赖库）：./build.sh 库名1 库名2
  • 测试所有已编译库：./test.sh
  • 测试指定库：./test.sh 库名1 库名2

三、不同编译方式适配指南

若需手动适配或补充框架未覆盖的场景，可参考以下针对性指导：

多架构适配

针对 x86、arm64-v8a、armeabi-v7a 等不同架构，参考 OpenHarmony 多架构适配指南，需在编译参数中指定目标架构（如 OHOS_ARCH）。

四、移植验证方案：真机与模拟器

编译完成后需验证功能完整性，优先使用原生库测试用例（ctest/make check），支持真机与模拟器两种验证场景。

1. 真机验证

• 测试环境搭建：参照 CI 测试环境配置，集成 cmake、ctest 等测试工具。
• 核心步骤：打包源码与编译产物 → 通过 hdc 工具推送至设备 → 执行原生测试用例。

2. 模拟器验证

无真机时可使用 DevEco Studio 模拟器，具体步骤参考 模拟器验证 C/C++ 三方库。

通用验证参考

完整移植流程与验证标准可查阅 C/C++ 三方库移植总纲。

五、多系统环境搭建

针对不同开发主机系统，提供专属 SDK 配置与交叉编译指导：

• Windows 环境：Windows 上使用 OpenHarmony SDK 交叉编译指导
• macOS 环境：macOS 上使用 OpenHarmony SDK 交叉编译指导（含 Intel/M 系列芯片适配、CMake 平台配置）

补充资源

• 三方库移植常见问题：OpenHarmony 三方库移植知识库

• 已适配三方库列表：OpenHarmony 兼容三方库清单