OpenHarmony 跨端生态适配涵盖 Flutter、RN、Cordova、Electron 等主流框架及通用 C/C++ 库。移动端适配提供专属 OH 版本，支持零成本迁移 Dart 库或低代码桥接。桌面端通过 Electron-OH 及交叉编译方案实现。C/C++ 库标准化仅需 HPKBUILD、HPKCHECK 等 6 个文件完成构建与测试。仓颉语言作为原生开发首选，无需额外适配。整体遵循官方标准模板，降低迁移成本，推动生态建设。
鸿蒙的移动端生态中，目前市面主流的跨端开发框架均已推出专属鸿蒙适配版本（XX-OH），所有适配版本均完成了鸿蒙系统的底层兼容、API 映射，开发者可以低成本将原有跨端项目迁移至鸿蒙。所有适配版本均有官方维护的开源仓库，核心信息如下：
鸿蒙生态中成熟度最高、三方库最丰富的跨端框架适配版本。
RN 鸿蒙适配版，兼顾 RN 开发者的开发习惯与鸿蒙原生能力。
基于 WebView 的跨端框架鸿蒙适配版，适合 Web 开发者低成本迁移。
Kotlin 多平台鸿蒙适配版，主打跨 Android/鸿蒙/桌面端的 Kotlin 原生开发。
Ionic 团队出品的现代化跨端框架，暂未推出专属 OH 版本，原生支持鸿蒙的 Web+ 原生混合开发模式。
鸿蒙不仅覆盖移动端，也完成了 PC 端（桌面版）的生态布局，核心分为「Electron 桌面应用适配」和「PC 命令行工具鸿蒙化」两大方向：
桌面端跨平台框架 Electron 的鸿蒙专属适配版，支持开发鸿蒙桌面应用。
核心方向：To D（工具化）。所有 PC 端的命令行工具、终端工具，均可通过鸿蒙的交叉编译能力完成移植，无标准化适配模板，核心依托「通用 C/C++ 库鸿蒙化」的编译方案完成构建。
核心结论：任何一款 C/C++ 三方库，仅需 6 个文件即可完成完整的鸿蒙化适配，无多余文件，标准化程度拉满。
适配核心：鸿蒙官方提供了标准化的 C/C++ 库适配模板 + 编译规范，统一采用「交叉编译」+「GN 编译」的方式完成移植，所有开源 C/C++ 库均遵循此标准，适配成本极低。
这是本次指南的核心内容，鸿蒙的底层能力、三方库生态均依赖 C/C++ 库的支撑，官方对 C/C++ 库的鸿蒙化适配做了极致标准化的定义，所有适配工作均围绕「固定 6 个文件」展开，无任何额外开发工作，所有 C/C++ 库的适配流程、文件结构完全一致。
所有 C/C++ 三方库的鸿蒙化适配，最终产出物固定为 6 个文件，缺一不可，文件清单及作用如下，所有文件均有官方标准模板，直接复用修改即可：
├── HPKBUILD # 核心文件：编译构建脚本（configure/cmake/make 编译逻辑、交叉编译配置、打包安装）
├── HPKCHECK # 测试校验脚本：定义鸿蒙设备端的测试逻辑、日志输出、用例执行
├── README.OpenSource # 开源声明文件：必填，标注库的开源协议、版权信息、源码来源
├── README_zh.md # 中文说明文档：适配说明、编译步骤、使用方式、注意事项
├── SHA512SUM # 可选：源码包哈希校验文件，校验下载的源码完整性，无需校验可忽略
└── xxx_oh_pkg.patch # 补丁文件：源码兼容补丁，解决鸿蒙系统的编译报错、路径兼容、接口兼容等问题，按需添加
所有文件的标准模板均由鸿蒙官方维护，直接 fork 修改即可，无需从零编写：
HPKBUILD是 Shell 编写的标准化编译构建脚本，也是 C/C++ 库鸿蒙化的核心，该文件定义了：库的基础元信息、源码下载地址、交叉编译环境配置、编译构建逻辑、打包安装路径、测试准备、环境清理等所有核心流程。
# This is an example HPKBUILD file. Use this as a start to creating your own,
# and remove these comments.
# NOTE: Please fill out the license field for your package! If it is unknown,
# then please put 'unknown'.
# Contributor: Your Name <[email protected]>
# Maintainer: Your Name <[email protected]>
pkgname=NAME # 库名，必填
pkgver=VERSION # 库版本，必填
pkgrel=0 # 发布号，固定为 0 即可
pkgdesc="" # 库功能描述，必填
url="" # 库官网地址，必填
archs=("armeabi-v7a" "arm64-v8a") # 鸿蒙主流 CPU 架构，固定这两个即可
license=() # 开源协议，必填
depends=() # 运行依赖库，无则留空，依赖库需适配同架构
makedepends=() # 编译依赖工具，无则留空
source="https://downloads.sourceforge.net/$pkgname/$pkgname-$pkgver.tar.gz" # 源码下载链接
downloadpackage=true # 是否自动下载源码包，默认 true
autounpack=true # 是否自动解压源码包，默认 true
buildtools= # 编译方式，支持 cmake/configure/make，必填
builddir= # 源码解压后的目录名
packagename=$builddir.tar.gz # 源码包文件名
# 编译前环境准备：创建目录、设置环境变量、源码预处理
prepare(){
cd $builddir
cd ${OLDPWD}
}
# 核心编译逻辑：交叉编译核心步骤，架构判断、编译命令执行
build(){
cd $builddir
${OHOS_SDK}/native/build-tools/cmake/bin/cmake "$@" -DOHOS_ARCH=$ARCH -B$ARCH-build -S./ -L
make -j4 -C $ARCH-build
ret=$?
cd $OLDPWD
return $ret
}
# 打包安装：将编译产物安装到鸿蒙指定目录
package(){
cd $builddir
make -C $ARCH-build install
cd $OLDPWD
}
# 测试说明：鸿蒙设备端测试的前置说明
check(){
echo "The test must be on an OpenHarmony device!"
}
# 环境清理：编译完成后清理构建产物
cleanbuild(){
rm -rf ${PWD}/$builddir
}
# Contributor: 小肉头君 <[email protected]>
# Maintainer: 小肉头君 <[email protected]>
pkgname=fftw3
pkgver=3.3.10
pkgrel=0
pkgdesc="FFTW is a C subroutine library for computing the discrete Fourier transform (DFT) in one or more dimensions, of arbitrary input size, and of both real and complex data."
url="http://fftw.org/"
archs=("armeabi-v7a" "arm64-v8a")
license=("GPL-2.0-or-later")
depends=()
makedepends=()
source="http://fftw.org/fftw-${pkgver}.tar.gz"
autounpack=true downloadpackage=true
buildtools="configure"
builddir=fftw-$pkgver
packagename=$builddir.tar.gz
source envset.sh host=optargs=
prepare(){
mkdir -p $builddir/$ARCH-build
if [$ARCH=="armeabi-v7a"]
then setarm32ENV host=arm-linux fi
if [$ARCH=="arm64-v8a"]
then setarm64ENV host=aarch64-linux fi
optargs="--enable-single --with-slow-timer"
}
build(){
cd $builddir/$ARCH-build
PKG_CONFIG_LIBDIR="${pkgconfigpath}"../configure "$@$optargs\
--enable-threads --enable-shared --host=$host>$buildlog2>&1
$MAKEVERBOSE=1>>$buildlog2>&1
ret=$?
cd $OLDPWD
return $ret
}
package(){
cd $builddir/$ARCH-build
$MAKEVERBOSE=1install>>$buildlog2>&1
cd $OLDPWD
if [$ARCH=="armeabi-v7a"];then unsetarm32ENV;fi
if [$ARCH=="arm64-v8a"];then unsetarm64ENV;fi
unsethost optargs
}
check(){
cd $builddir/$ARCH-build
sed -i '/.*check-local: bench$(EXEEXT)/c\check-local: #bench$(EXEEXT)' tests/Makefile
sed -i "s#/usr/bin/sed#sed#g" tests/bench
sed -i "s#/bin/bash#/data/CIusr/bin/bash#g" tests/Makefile tests/bench
cd $OLDPWD
echo "The test must be on an OpenHarmony device!"
}
cleanbuild(){
rm -rf ${PWD}/$builddir
}
# Copyright (c) 2023 Huawei Device Co., Ltd.
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# Contributor: Jeff Han <[email protected]> ,Tao Han <[email protected]>
# Maintainer: Jeff Han <[email protected]>
pkgname=tassl pkgver=1.1.1 pkgrel=0
pkgdesc="TASSL is an SSL/TLS protocol implementation that supports national secret algorithms"
url="https://github.com/jntass/TASSL-1.1.1"
archs=("armeabi-v7a" "arm64-v8a")
license=("OpenSSL")
depends=(openssl_1_1_1w zlib_1_3_1)
makedepends=()
commitId="a30d107669fdf7d6909b10f1e179de4aaff38ff5"
source="https://github.com/jntass/$pkgname-$pkgver/archive/$commitId.zip"
autounpack=true downloadpackage=true
buildtools="configure"
builddir=TASSL-${pkgver}-$commitId
packagename=$builddir.zip
source envset.sh patchflag=true
prepare(){
if $patchflag
then
cd $builddir
patch -p1 <`pwd`/../tassl_oh_pkg.patch >>$publicbuildlog2>&1
patchflag=false
cd $OLDPWD
fi
cp $builddir${builddir}-${ARCH}-build -rf
if [$ARCH=="armeabi-v7a"];then setarm32ENV;
elif [$ARCH=="arm64-v8a"];then setarm64ENV;
elseecho"${ARCH} not support";return -1;fi
}
build(){
cd $builddir-$ARCH-build
./config "$@" no-asm >$buildlog2>&1
$MAKE>>$buildlog2>&1
ret=$?
cd $OLDPWD
return $ret
}
package(){
cd $builddir-$ARCH-build
mkdir -p ${LYCIUM_ROOT}/usr/${pkgname}/${ARCH}/
$MAKEinstall>>$buildlog2>&1
cd $OLDPWD
}
check(){
if [$ARCH=="armeabi-v7a"];then unsetarm32ENV;
elif [$ARCH=="arm64-v8a"];then
cd $builddir-$ARCH-build
sed -i.bak "s|PERL=/usr/bin/perl|PERL=/data/CIusr/bin/perl|g" ./Makefile
maketest>>$buildlog2>&1
cd $OLDPWD
unsetarm64ENV
else
echo"${ARCH} not support";return -1;fi
echo "The test must be on an OpenHarmony device!"
}
cleanbuild(){
rm -rf $builddir-$ARCH-build $packagename$builddir
}
该文件是鸿蒙化适配的测试标准文件，定义了 C/C++ 库在鸿蒙设备端的测试逻辑，所有库的 HPKCHECK 结构一致，仅需修改测试命令即可，官方模板如下：
# This is an example HPKCHECK file. Use this as a start to creating your own,
# and remove these comments.
# Contributor: Your Name <[email protected]>
# Maintainer: Your Name <[email protected]>
source HPKBUILD > /dev/null 2>&1
# 导入 HPKBUILD 的元信息
logfile=${LYCIUM_THIRDPARTY_ROOT}/${pkgname}/${pkgname}_${ARCH}_${OHOS_SDK_VER}_test.log # 测试前准备，无则留空
checkprepare(){
return0
}
# 鸿蒙设备端核心测试接口，所有测试逻辑写在这里
openharmonycheck(){
res=0
cd${builddir}/${ARCH}-build
ctest >${logfile}2>&1
# 测试命令，按需修改为 make test/ctest 等
res=$?
cd$OLDPWD
return$res
}
README.OpenSource：固定格式，填写库名、版本、开源协议、源码地址即可；README_zh.md：填写编译步骤、适配说明、使用方式，无固定格式；SHA512SUM：可选，无需校验则不创建，需要则生成源码包的 sha512 哈希值即可；xxx_oh_pkg.patch：按需创建，解决鸿蒙编译的兼容性问题，比如路径适配、接口兼容、编译报错等，补丁文件通过 patch -p1 命令在 prepare 阶段执行。所有 C/C++ 库的编译均基于 鸿蒙交叉编译环境，核心要点如下，也是 HPKBUILD 中最核心的逻辑：
armeabi-v7a(arm32) 和 arm64-v8a(arm64) 两大主流架构；source envset.sh 导入鸿蒙交叉编译环境变量，通过 setarm32ENV/setarm64ENV 设置对应架构的编译环境；configure/make/cmake 三种主流 C/C++ 编译方式，官方均做了兼容；${LYCIUM_ROOT}/usr/${pkgname}/${ARCH}/ 目录，鸿蒙系统可直接调用；仓颉（CangJie）：OpenHarmony 官方原生编程语言，为鸿蒙而生，主打高性能、简洁语法、原生鸿蒙适配，是鸿蒙未来的核心开发语言。
核心定位：鸿蒙原生开发的首选语言，替代部分 C/C++ 和 ArkTS 的开发场景，生态正在快速建设中。
OpenHarmony 的生态建设已经进入标准化、规模化阶段，从主流跨端框架到底层 C/C++ 库，从移动端到 PC 端，从第三方语言到原生仓颉语言，形成了完整的生态体系和适配规范。对于开发者而言，鸿蒙化适配不再是高成本的自研工作，而是基于官方标准的低成本复用与修改。
本文梳理的所有适配方案和资源，均为鸿蒙官方维护的标准化内容，也是现阶段鸿蒙开发的核心参考。希望本文能帮助开发者快速掌握鸿蒙化适配的核心要点，低成本将项目和三方库迁移至鸿蒙生态，共同推动鸿蒙的生态建设。
附：全文核心仓库地址汇总
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online