OpenHarmony C/C++三方库移植适配指导说明

一、移植前准备

移植工作启动前，需先使用C/C++三方库风险识别工具对目标库进行扫描分析，提前识别兼容性风险。

• 工具地址：C/C++三方库风险识别工具
• 使用教程：C/C++三方库风险识别工具使用方法

二、核心编译工具介绍

针对开源C/C++三方库编译方式多样化（cmake、configure、make等）及大型库移植耗时的问题，华为开发了Lycium交叉编译工具，支持在Linux环境下利用原生库编译脚本快速构建可在OpenHarmony运行的三方库。

工具核心优势：简化交叉编译流程，支持cmake、configure、make等多种构建方式，大幅提升移植效率。

• 工具地址：Lycium交叉编译工具
• 编译脚本模板：HPKBUILD模板详情

三、主流编译方式适配指南

3.1 CMake相关编译

• CMake交叉编译构建：CMake交叉编译构建指南
• 从零编写CMake构建脚本：从零开始编写cmake构建脚本
• IDE中CMake编译问题处理：原生库cmake无法在IDE编译时，需分析问题原因并修改原生CMakeLists.txt

3.2 Configure交叉编译

详细指导文档：configure 交叉编译指南

3.3 Make交叉编译

详细指导文档：make 交叉编译指南

3.4 多架构适配

如何适配OpenHarmony不同架构的构建：适配不同架构构建指南

四、快速验证方法

4.1 单元测试验证

基于原生库的单元测试用例（ctest/make check）进行快速验证，详情参考：C/C++三方库快速验证

4.2 模拟器验证（无真机场景）

使用DevEco Studio模拟器验证C/C++三方库：模拟器验证指南

五、多环境交叉编译搭建

• Windows环境：Windows上使用OpenHarmony SDK交叉编译指导
• Mac环境：Mac上使用OpenHarmony SDK交叉编译指导

六、参考文档汇总

• C/C++三方库移植总览：thirdparty_port.md
• Lycium工具CI验证：C/C++三方库快速验证（CItools）