开源三方库HarmonyOS NEXT适配指导

已于 2025-05-08 17:11:55 修改
阅读量869 收藏 25
点赞数 22
分类专栏： 鸿蒙游戏-引擎适配 文章标签： 开源 harmonyos 华为 游戏引擎
于 2025-04-24 17:50:40 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_82404985/article/details/147484911
版权

1 概述

由于HarmonyOS NEXT平台与其他平台的差异性关系，开源/闭源三方库都需要重新使用HarmonyOS NEXT SDK编译适配之后才能在HarmonyOSN NEXT平台上使用。三方库基本上会提供主流平台的编译脚本，但针对HarmonyOS NEXT平台编译脚本，仅少数三方库提供，大多数都需要开发人员进行调整适配。本文将介绍开源三方库如何适配HarmonyOS NEXT游戏。

2 必备基础知识

基础知识

C/C++或其他语言编程知识

编译过程中经常需要修改三方库源码，拥有C/C++语言编程知识在三方库源码编译中很重要。当然熟悉其他编程语言也同样很重要。

CMake使用知识

大多数C/C++三方库都是使用CMake脚本（CMakeList.txt）进行编译，且HarmonyOS NEXT SDK中也提供CMake构建工具，熟悉CMake的同学会更加用以上手。

Clang/LLVM编译器使用知识

同样存在大多数三方库不是使用CMake构建系统进行编译的，这部分三方库一般是用到Makefile或是shell脚本。通常这种类型的三方库一般都是使用此类脚本间接的使用Clang/LLVM编译工具。

如果你编译过Android平台上是三方库的话，对于您来说HarmonyOS NEXT上的三方库编译就简单许多了，因为这两者基本上都是类似的。

HarmonyOS NEXT SDK介绍

下载Command Line Tools For HarmonyOS NEXT工具请前往工具下载地址。

 

    若是在Windows上使用Linux的虚拟机时，下载Linux版的sdk压缩包之后需要在Linux虚拟机中使用unzip或是tar工具解压，避免出现问题。

目录介绍

三方库编译主要使用到的NDK主要在Native文件夹中，仅简单介绍此部分中内容。

cke_185.png

1. build: 防止预定义的toolchain脚本文件ohos.toolchain.cmake。 

cke_186.png

CMake编译时需要读取该文件中的默认值，比如编译器架构、C++库链接方式等，因此在编译时会通过CMAKE_TOOLCHAIN_FILE指出该文件的路径，便于CMake在编译时定位到该文件。

2. build-tools：放置NDK提供的编译工具。

CMake构建系统编译三方库过程中主要使用cmake和ninja。

3. docs：Native接口api文档。

4. llvm：放置NDK提供的编译器。

cke_188.png

5. sysroot：HarmonyOS NEXT SDK的Native依赖及头文件。

cke_189.png

3 C/C++库

C/C++库一般会分三种情况：

  • 情况一：提供了CmakeLists.txt脚本，可以使用sdk中自带的cmake和Ninja工具进行编译。
  • 情况二：非CmakeLists.txt脚本，一般用到shell脚本(autoconf,configure)和make进行编译。
  • 情况三：源码集成，直接将三方库源码添加到项目中和项目源码一起编译。

3.1 CMake编译

提供两个shell脚本，实现CMake构建三方库。

1. cmake_exec.sh。

cmake_exec.sh用来配置编译参数，根据构建规则和依赖关系生成构建文件。

# cmake_exec.sh
# ===============================
#   需调整HarmonyOS SDK路径及工具链路径
# ===============================
{OHOS_SDK_PATH}/native/build-tools/cmake/bin/cmake -GNinja \
 -DOHOS_STL=c++_static -DOHOS_ARCH=arm64-v8a -DOHOS_PLATFORM=OHOS \
 -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=./ \
 -DCMAKE_TOOLCHAIN_FILE="{OHOS_SDK_PATH}/native/build/cmake/ohos.toolchain.cmake" \
 -B build

 cmake_exec.sh编译会生成一些“中间”文件，如调整了CMakeLists.txt文件需要将build文件夹清空，重新执行该脚本，避免文件缓存。若此脚本执行出现错误，一般情况下都是编译脚本的相关问题，主要调整CMakeLists.txt文件。

     在Linux系统中若是上述脚本中不指定-GNinja的话，将默认使用make作为Generator。在windows系统中建议指定Generator为Ninja。

选项

参数

说明

OHOS_STL

c++_static/c++_shared

动态或是静态连接c++库的方式，默认采用c++_shared。

OHOS_ARCH

armeabi-v7a/arm64-v8a/x86_64

ABI中支持的架构。参考HarmonyOS ABI。

OHOS_PLATFORM

OHOS

平台，不指定默认OHOS。

CMAKE_BUILD_TYPE

normal/Release

debug模式或是release模式。

CMAKE_TOOLCHAIN_FILE

toolchain文件路径

指定toolchain文件，可使用自己的toolchain文件。一般建议指定SDK中自带toolchain文件。

2. ninja_exec.sh。

ninja_exec.sh是根据cmake_exec.sh脚本执行得到的构建文件进行构建，生成目标文件。

# ninja_exec.sh
# ===============================
#   需调整HarmonyOS SDK路径及工具链路径
# ===============================

# 使用ninja，在cmake_exec.sh中使用-GNinja
{OHOS_SDK_PATH}/native/build-tools/cmake/bin/ninja -C build/

# 使用make，Linux环境下在cmake_exec.sh中未指定-G
make -C build/

# 或者不区分ninja和make
cd build
{OHOS_SDK_PATH}/native/build-tools/cmake/bin/cmake --build .

ninja_exec.sh需在cmake_exec.sh脚本正常的前提下运行。如此脚本中执行出现错误，一般需要涉及源码调整。使用上述两个脚本，基本上可以满足全部的CMakeList.txt编译，然后再针对编译过程中问题进行调整。

3.2 非CMake编译

使用CMakeLists.txt重写编译脚本

此过程使用于相对简单的三方库，对于依赖简单，且使用工具单一（较为复杂的库可能还需要使用到python、rust等）的情况可以使用。如三方库提供Android平台版本，可以参考Android.mk文件进行编写，内容与CMakeLists.txt文件较为相似。

使用原生的构建工具

使用原生的构建工具，需要针对环境进行配置，一般建议在Linux环境下使用。

 

     Linux环境下需要Linux版本SDK，且需要使用Linux环境下的解压工具进行解压，避免出现问题。

环境配置。

export OHOS_SDK=/home/ohos/tools/OH_SDK/ohos-sdk/linux
export AS=${OHOS_SDK}/native/llvm/bin/llvm-as
export CC="${OHOS_SDK}/native/llvm/bin/clang --target=arm-linux-ohos"
export CXX="${OHOS_SDK}/native/llvm/bin/clang++ --target=arm-linux-ohos"
export LD=${OHOS_SDK}/native/llvm/bin/ld.lld
export STRIP=${OHOS_SDK}/native/llvm/bin/llvm-strip
export RANLIB=${OHOS_SDK}/native/llvm/bin/llvm-ranlib
export OBJDUMP=${OHOS_SDK}/native/llvm/bin/llvm-objdump
export OBJCOPY=${OHOS_SDK}/native/llvm/bin/llvm-objcopy
export NM=${OHOS_SDK}/native/llvm/bin/llvm-nm
export AR=${OHOS_SDK}/native/llvm/bin/llvm-ar
export CFLAGS="-fPIC -D__MUSL__=1"
export CXXFLAGS="-fPIC -D__MUSL__=1"

完成环境配置之后，可参照三方库提供文档按照教程进行编译。编译过程中可能会涉及一些平台相关信息调整和修改。

编译示例

示例请参见Configure构建工程配置HarmonyOS编译工具链。

3.3 编译脚本（oh-compile-script）

基于Conan 2.x的一键编译HarmonyOS NEXT库脚本，请参见脚本归档地址，Conan官方文档网站请参见Conan官方文档网站

优势

  1. 拿来即用，已收录100+常用三方库的多个版本。
  2. 不需要考虑三方库依赖问题，依赖关系已处理。
  3. 可快速适配新版本三方库源码，保持三方库更新。
  4. 使用简单，一条命令可完成编译。
  5. 环境安装简单，安装Python和Conan即可。
  6. 跨平台多端可以，支持Linux和Windows平台下交叉编译。
  7. 方便归档，可搭建Conan制品仓，资源复用。

使用方法

shell脚本如下：

$ python conanbuild.py
Please input the supported library name  (name is the folder name below conan-center-index_ohos/recipes) : zlib
['1.3', '1.2.13', '1.2.12', '1.2.11', 'all']
Please input the version from the above list : 1.3
Please set the build type (Debug or Release,empty for Release) :
Please set the compile target as static(False, default) or shared(True) :
Please input the install path(empty for xx\oh-compile-script/build/zlib/1.3/Release) :
Please set the custom source path(not necessary):

4 C#库

纯C#源码

纯c#源码的库基本上可以多平台使用，参照三方库提供的文件进行操作即可。

HarmonyOS NEXT上需要通过团结引擎出包然后再DevEco Studio上编译验证。

C/C++和C#混编

C/C++部分可以按照第一节操作，然后编译出来的so或是.a文件放在DevEco Studio中使用即可。

C#部分可按照纯C#源码操作进行验证。

带aar包的插件

aar包Android的功能合集，我们可以通过aar包解压出jar包，分析其接口功能。然后再针对接口实现HarmonyOS NEXT的功能。

提供har包替代aar包供C#使用。

5 检查和验证

检查

  1. 同时编译.a和.so文件，如果都能编译成功可进行下一步检查
  2. 通过file命令检查so文件平台信息

cke_192.png

验证

  1. 可以从三方库中找到测试用例，使用DevEco Studio创建一个简单的示例项目验证。将编译后得到的.a文件或是.so文件添加在DevEco Studio中编写一个简单实例工程进行验证。三方库源码中一般会自带测试用例，可选其中一两个案例验证。
  2. 复杂的库，可直接在项目中验证，比如Physx。

6 参考文档

原文链接：华为开发者文章

 更多问题可关注：

鸿蒙游戏官方网站：已有游戏移植-鸿蒙游戏-华为开发者联盟

公开课：华为开发者学堂

【HarmonyOS NEXT应用开发】案例140：基于RN框架实现高性能瀑布流页面
xzs51job的专栏
09-08 827
本案例针对瀑布流页面场景，基于@react-native-oh-tpl/flash-list、axios等框架，实现了一个高性能的瀑布流页面，该案例提供了关键的开发步骤，旨在帮助开发者高效开发出高性能的瀑布流页面。详情请查看。名称版本号0.72.270.0.26rnoh5.0.0.302及以上5.0.0.302及以上页面：页面渲染最大数≤300页面组件嵌套层数≤30。
HarmonyOS NEXT鸿蒙（开发进阶）基于RN框架实现高性能瀑布流页面
adaedwa187545的博客
10-21 1136
本文针对应用开发中相当常见的瀑布流页面场景，基于按需渲染、组件复用等技术，使用RN框架实现了高性能瀑布流页面。本文提供详细的开发步骤，帮助开发人员高效实现高性能瀑布流页面。
HarmonyOS 应用打包 HAP、HAR 和 HSP 的转换
qq_41709661的博客
12-17 584
开发者同僚们，今天我们来聊聊在 HarmonyOS 开发中的三个好兄弟：HAP、HAR 和 HSP。这三个家伙在我们的应用开发中扮演着重要角色，而且他们还能互相变身，让我们的应用更加灵活和强大。
鸿蒙HarmonyOS NEXT十大开源项目
热门推荐
欢迎加入Android老司机学院 482266514（技术交流群）密码CSDN
12-04 1万+
【OH哔哩】是一款基于OpenHarmony系统ArkUI框架开发的哔哩哔哩动画第三方客户端。
HarmonyOS-Next开源三方库 MPChart：打造出色的图表体验
liuhaikang的博客
04-26 2918
随着移动应用的不断发展，数据可视化成为提高用户体验和数据交流的重要手段之一。在 OpenAtom OpenHarmony（简称“OpenHarmony”）应用开发中，一个强大而灵活的图表库是实现这一目标的关键。在 ohpm 中心仓（OpenHarmony三方库中心仓）中，汇聚了众多开发者贡献的图表库，其中之一就是 MPChart。自其发布以来，MPChart 已被广泛应用于各类应用程序，它为开发者提供了丰富的功能和灵活性，使得创建各种类型的图表变得轻而易举。...​。
HarmonyOS NEXT：技术革新与生态挑战的交汇点
喻志强的博客
12-16 6372
OpenHarmony和HarmonyOS NEXT 面临的挑战如生态建设和市场接受度，OpenHarmony的开源特性及HarmonyOS的发展节点和特性。希望HarmonyOS NEXT能够做大做强，创造辉煌！
鸿蒙HarmonyOS三方库推荐
小北的博客
09-05 2947
第三方库众多，但在此我只精选了一些经典之作，希望能为大家提供帮助。不喜勿喷，整理与总结不易，还请点赞👍并收藏📂。如果您有其他推荐，欢迎留言，我会定期更新，并在推荐中署名感谢您的贡献！
【HarmonyOS NEXT】lv-markdown-in 三方库用法说明
weixin_44640245的博客
12-18 1114
鸿蒙原生Markdown解析预览库，可在OpenHarmony、HarmonyOS系统运行，兼容api9（1.x.x版本）、api10及以上（2.x.x版本），支持3种内容加载模式（纯文本、资源文件、沙箱文件）支持html常用标签解析。需要注意的是，使用拦截行为后，才可拦截正常拦截库中默认打开行为，则不拦截，但会进入该逻辑。// 导入 mdRegister// 注册超链接点击回调、return false 则表示拦截，自行处理超链接跳转逻辑console.log("拦截跳转 > " + url)
【HarmonyOS NEXT】三方JS开源库与自研JS库代码如何鸿蒙化
Mayism123的博客
04-02 466
三方JS开源库与自研JS库代码如何鸿蒙化？需要导入源码，并且配置入口文件和声明文件。三方库 / JS / 鸿蒙化 / 移植。
鸿蒙 HarmonyOS NEXT应用开发案例集
小北的博客
08-02 2312
随着应用代码复杂度的提升，为了提高应用的可维护性和可扩展性，良好的应用架构设计显得尤为重要。本篇文章将介绍一个应用通用架构的设计思路，旨在减少模块间的耦合、提升团队开发效率，为开发者提供一个清晰且结构化的开发框架。本文以“应用通用开发范例App”为例，从分层架构设计和模块化设计两个方面介绍应用的架构组成。
极速探索HarmonyOS NEXT：纯血鸿蒙应用开发全攻略【文末好书推荐】
一键难忘的博客
02-19 6244
HarmonyOS NEXT 是华为推出的最新一代操作系统，秉承 “多终端一体化” 的设计理念，致力于在不同设备之间实现无缝的协同与连接。它不仅支持智能手机，还能够广泛适配各种设备，如平板、智能穿戴设备、车载设备、甚至是物联网终端。
【鸿蒙HarmonyOS NEXT】 API11及以上开发文档以及IDE下载
m0_70749039的博客
06-18 3729
有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的。
鸿蒙next开发实战探索：lycium的开源c库编译与集成
m0_70749039的博客
07-01 1516
我们从头开始演示如何编译移植过来的openssl库
【开源三方库】Easyui：基于OpenAtom OpenHarmony ArkUI深度定制的组件框架
鸿蒙开发知识记录
09-04 707
Easyui是一套基于ArkTS语言开发的轻量、可靠的移动端组件库，它是对OpenAtom OpenHarmony（以下简称“OpenHarmony”） ArkUI进行深度定制的组件框架。Easyui可扩展性较强，可以基于源码进行二次开发，修改原有组件以及新增部分组件，以满足具体项目的开发需求。该框架适用大部分OpenHarmony应用的开发 ，能够更加完善OpenHarmony 的应用开发能力，使我们的应用开发更简单。通过本篇文章介绍，您对easyui组件框架应该有了初步的了解。
Void: Cursor 的开源平替
05-14 495
在你的代码库中使用 AI 代理，检查点并可视化更改，并将任何模型或主机本地化。Void 直接向提供者发送消息，而不会保留你的数据。拥有与 Cursor 几乎一样强大的编程功能，最大的不同 Void 是可直接连接任何 AI 模型或使用本地部署模型，无需再经过第三方服务器。
开源网络地图可视化第六章学习指南
CUGLin的博客
05-13 829
本文主要帮助同学们学习WebGIS以及可视化开发
Nginx 动静分离在 ZKmall 开源商城静态资源管理中的深度优化
最新发布
05-14 788
在 B2C 电商高并发场景下，静态资源（图片、CSS、JavaScript 等）的高效管理直接影响页面加载速度与用户体验。ZKmall开源商城通过对 Nginx 动静分离技术的深度优化，将静态资源响应速度提升 65%，带宽成本降低 40%，成功支撑日均千万级访问量下的系统稳定运行。其核心优化策略涵盖缓存策略精细化、资源加载智能化、负载均衡动态化三大维度，为电商静态资源管理提供了可复用的技术方案。
docker部署WeDataSphere开源大数据平台
曼陀罗的博客
05-13 401
容器中各组件安装包均在/data/docker/Install目录下，除Streamis的配置文件在/data/docker/Install/streamis/streamis-server/conf目录，其他组件配置文件均在/data/docker/config目录下，日志均在/data/docker/logs目录，同时，我们提供了各组件升级文档，能够轻松完成升级和维护。直接用新的lib包替换/data/docker/Install/streamis/streamis-server/lib。
团结引擎开源车模 Sample 发布：光照渲染优化 & 动态交互全面体验升级
unityofficial的博客
05-14 514
光照、材质与交互效果的精细控制，通常意味着复杂的技术挑战，但借助 Shader Graph 14.1.0(已内置在团结引擎官方 1.5.0 版本中)，这一切都变得简单易用。通过最新团结引擎官方车模 Sample，开发者能切身感受到全新光照优化与编辑功能的便捷性，直观地调整每个渲染细节。借助 Shader Graph，复杂的渲染效果也能轻松创建，并实现实时调整，满足快速、高效的创作需求。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值