首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >专栏 >OpenHarmony(鸿蒙南向开发)——轻量和小型系统三方库移植指南(二)

OpenHarmony(鸿蒙南向开发)——轻量和小型系统三方库移植指南(二)

原创
作者头像
小帅聊鸿蒙
发布2025-06-25 20:31:51
发布2025-06-25 20:31:51
1540
举报
文章被收录于专栏:鸿蒙开发笔记鸿蒙开发笔记

Makefile方式组织编译的库移植

以yxml库为例,其移植过程如下文所示。

源码获取

从仓库获取yxml源码,其目录结构如下表:

表1 源码目录结构

名称

描述

yxml/bench/

benchmark相关代码

yxml/test/

测试输入输出文件,及测试脚本

yxml/Makefile

编译组织文件

yxml/.gitattributes

-

yxml/.gitignore

-

yxml/COPYING

-

yxml/yxml.c

-

yxml/yxml.c.in

-

yxml/yxml-gen.pl

-

yxml/yxml.h

-

yxml/yxml.md

-

yxml/yxml-states

-

设置交叉编译

设置Makefile的交叉编译工具链,修改并编译该库,生成OpenHarmony平台的可执行文件,步骤如下:

  1. 设置工具链 将下列clang工具链配置替换掉yxml库根目录的Makefile(即表1中的文件)中的原有配置。

clang工具链配置:

代码语言:c
复制
    #设置交叉编译工具链,确保工具链所在路径已经添加到了PATH环境变量中
    CC:=clang
    AR:=llvm-ar
    #cflags中必须要添加--target及--sysroot选项
    CFLAGS:=-Wall -Wextra -Wno-unused-parameter -O2 -g --target=arm-liteos -march=armv7-a -mfloat-abi=softfp -mcpu=cortex-a7 -mfpu=neon-vfpv4 --sysroot=$(OHOS_SYSROOT_PATH)

原有配置:

代码语言:shell
复制
    CC:=gcc
    AR:=ar
    CFLAGS:=-Wall -Wextra -Wno-unused-parameter -O2 -g
  1. 执行编译 linux命令行中进入yxml的源文件目录(即图1所示目录),执行下列命令:
代码语言:shell
复制
    make test OHOS_SYSROOT_PATH=...

其中OHOS_SYSROOT_PATH需用绝对路径指定出sysroot所在目录,以OpenHarmony为例即源码根目录下out/hispark_xxx/ipcamera_hispark_xxx/sysroot目录的绝对路径。上述目录会在全量编译后生成,因此移植前先完成一次全量编译。

  1. 查看结果 步骤2操作完成后,yxml下会生成out目录,里面有静态库文件和测试用例:

表2 yxml编译生成目录

名称

描述

OpenHarmony/third_party/yxml/yxml/out/lib/

编译生成的静态库的存放目录

OpenHarmony/third_party/yxml/yxml/out/test/

编译生成的测试用例及其输入输出等文件的存放目录

测试

yxml库测试步骤与double-conversion库基本一致,可参考CMake方式组织编译的库移植的测试过程,以下内容介绍yxml库测试用例的使用方法:

表3 生成的test目录结构示意

名称

描述

OpenHarmony/third_party/yxml/yxml/out/test/test.sh

自动化测试脚本,由于OpenHarmony不支持脚本运行,因此无法使用,可参考其内容手动测试

OpenHarmony/third_party/yxml/yxml/out/test/test

用于测试的可执行文件

OpenHarmony/third_party/yxml/yxml/out/test/*.xml

测试输入文件

OpenHarmony/third_party/yxml/yxml/out/test/*.out

期望的输出文件

test.sh内容如下所示:

代码语言:shell
复制
#!/bin/sh
for i in *.xml; do
  b=`basename $i .xml`
  o=${b}.out
  t=${b}.test
  ./test <$i >$t
  if [ -n "`diff -q $o $t`" ]; then
    echo "Test failed for $i:"
    diff -u $o $t
    exit 1
  fi
done
echo "All tests completed successfully."

由于OpenHarmony的shell中暂不支持输入输出重定向(<和>),所以测试时需要将输入*.xml文件内容直接复制进shell后回车,输出内容会直接展示在shell窗口。过程如下:

下列操作假定已按照2.4节的步骤搭建OpenHarmony,挂载并进入nfs目录:

  1. 执行下列命令
代码语言:c
复制
    ./test
  1. 复制*.xml内容到shell 以表3test目录下pi01.xml为例,内容如下,输入到shell并回车:
代码语言:xml
复制
    <?SomePI abc?><a/>
  1. 比较shell中输出的内容与表3test目录中对应的*.out文件是否一致 输出结果如下:
代码语言:c
复制
    pistart SomePI
    picontent abc
    piend
    elemstart a
    elemend
    ok

经比较与表3test目录下pi01.out内容一致,测试通过。

DD一下:欢迎大家关注工粽号<程序猿百晓生>,可以了解到以下知识点。
代码语言:erlang
复制
欢迎大家关注工粽号<程序猿百晓生>,0取以下学习清单:
1.OpenHarmony开发基础
2.OpenHarmony北向开发环境搭建
3.鸿蒙南向开发环境的搭建
4.鸿蒙生态应用开发白皮书V2.0 & V3.0
5.鸿蒙开发面试真题(含参考答案) 
6.TypeScript入门学习手册
7.OpenHarmony 经典面试题(含参考答案)
8.OpenHarmony设备开发入门【最新版】
9.沉浸式剖析OpenHarmony源代码
10.系统定制指南
11.【OpenHarmony】Uboot 驱动加载流程
12.OpenHarmony构建系统--GN与子系统、部件、模块详解
13.ohos开机init启动流程
14.鸿蒙版性能优化指南
.......

将该库编译添加到OpenHarmony工程中

yxml库添加的过程除了适配文件build.gn和config.gni有些许变化外,其他和double-conversion库完全一致,参考CMake方式组织编译的库移植的配置过程。要修改的适配文件及添加后的目录结构如下:

  • yxml库新增的BUILD.gn实现如下:
代码语言:c
复制
import("config.gni")
group("yxml") {
    if (ohos_build_thirdparty_migrated_from_fuchisa == true) {
        deps = [":make"]
    }
}
if (ohos_build_thirdparty_migrated_from_fuchisa == true) {
    action("make") {
        script = "//third_party/yxml/build_thirdparty.py"
        outputs = ["$target_out_dir/log_yxml.txt"]
        exec_path = rebase_path(rebase_path("./yxml", root_build_dir))
        command = "make clean && $MAKE_COMMAND"
        args = [
            "--path=$exec_path",
            "--command=${command}"
        ]
    }
}
  • yxml库新增的config.gni配置如下:
代码语言:c
复制
TEST_ENABLE = "YES"

if (TEST_ENABLE == "YES") {
    MAKE_COMMAND = "make test OHOS_SYSROOT_PATH=${root_out_dir}sysroot/"
} else {
    MAKE_COMMAND = "make OHOS_SYSROOT_PATH=${root_out_dir}sysroot/"
}
  • 添加完成后目录结构示意:

表4 添加到工程后的目录结构

名称

描述

OpenHarmony/third_party/yxml/BUILD.gn

将三方库加入工程的gn适配文件

OpenHarmony/third_party/yxml/build_thirdparty.py

GN调用shell命令脚本文件,由上面GN文件将相关命令传入,实现GN转Makefile

OpenHarmony/third_party/yxml/config.gni

三方库编译配置文件,可修改该文件来配置用例是否参与构建等

OpenHarmony/third_party/yxml/yxml/

要移植的三方库目录

写在最后

如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:

  • 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力;
  • 关注小编,同时可以期待后续文章ing🚀,不定期分享原创知识;
  • 想要获取更多完整鸿蒙最新学习知识点,可关注B站:码牛课堂;

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • Makefile方式组织编译的库移植
    • 源码获取
    • 设置交叉编译
    • 测试
    • 将该库编译添加到OpenHarmony工程中
    • 写在最后
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档