几百万行 C++ 服务端上鸿蒙:musl、原生子进程,以及引擎缺位时的降级设计

一、写在前面

开源地址:https://atomgit.com/OpenHarmonyPCDeveloper/ohos_MySQLCommunityEdition

欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper

本文导读

  • 要解决的问题:把几百万行 C++ 的数据库服务端搬到鸿蒙:musl 不是 glibc、sysroot 没有 OpenSSL 和 curses、沙箱又不允许 exec() 二进制。
  • 你会读到的技术细节:libmysqlsrv.so + OH_Ability_StartNativeChildProcess 的服务端启动模型、_exit() 绕过 appspawn 崩溃上报的坑、应用内 SQL 控制台(11 个 NAPI 函数)、以及引擎缺位时的 CMake 探测式降级。
  • 本文的实测数据:2.1 MB HAP、14 项真机验证;以及一条真实错误——启动异常 / File exists,文章从沙箱 data/ 目录为空反推出初始化从未成功。
  • 适合谁读:想做服务端类应用、关心原生子进程与构建降级设计的开发者。

这篇文章记录的是把 MySQL Server 移植到鸿蒙 PC 上的过程。最终落地的应用叫 源库服务(based on MySQL Server),包名 com.qingjian.editor。

这是技术难度最高的一个项目,也是最特殊的一期:前四期移植的是「客户端」或「带图形界面的应用」,这次移植的对象是一个数据库服务端——它没有界面可抄,它的全部价值在于「能在设备上跑起来、能被连上」。

先说结论,这次必须分开讲:

应用层移植完整:服务管理、SQL 控制台、数据浏览、参数配置四个模块全部实现,界面在真机上跑通;
服务端引擎未随包:MySQL 服务端本体需要一整套交叉编译链,仓库里没有它的产物,本次未能在设备上真正起库。

这不是一句轻描淡写的"待完善"——第六章会把引擎缺失的边界、以及我实测到的「启动异常:File exists」这条真实错误摊开讲。

验证环境是真实设备:

项值
设备型号HUAWEI MateBook Pro S(MOR-M1)
系统版本HarmonyOS 7.0.0.111(SP15C00E101R9P2)
API 版本26
设备形态2in1
构建工具DevEco Studio 内置 hvigor 6.26.4
SDKHarmonyOS SDK 26.0.0.105

二、项目背景

MySQL(https://github.com/mysql/mysql-server)不用介绍,全世界最常用的关系型数据库之一。

但把它搬到鸿蒙上,难点和其他移植项目完全不是一个量级:

痛点说明
C/C++ 巨型工程MySQL 服务端是几百万行的 C/C++,构建系统基于 CMake + 自研脚本
依赖第三方库OpenSSL、protobuf、ICU、zlib、zstd、lz4、libevent、abseil、rapidjson…
OHOS C 库是 musl不是 glibc,大量平台假设需要重新实现
没有 curses/termcap命令行客户端 mysql、mysqldump 直接编不出来
DB 进程怎么起鸿蒙不允许应用随意 exec 沙箱二进制,服务端必须走原生子进程
权限与数据隔离数据目录必须在应用沙箱内,不能写到系统路径

仓库的 docs/OpenHarmony.md 开头就给了状态表,写得很克制也很实在:

ItemState
Server (mysqld, libmysqlsrv.so)builds for aarch64-linux-ohos
Client library (libmysqlclient)builds and is used by the in-app SQL console
Command line tools (mysql, mysqldump, …)not built (no curses in the sysroot)
Runtime on HarmonyOS PCstarts in a native child process of the HAP, harmony_pc/
Storage enginesInnoDB and the built-in engines; NDB disabled
Authbuilt-in plugins; LDAP/Kerberos/SASL/FIDO disabled

注意这份表说的是「构建可行性」,不是「已随包发布」。这两件事的区别,是本章之后全部内容的重点。


三、总体变化概览

harmony_pc/
├── entry/src/main/
│   ├── module.json5               INTERNET + GET_NETWORK_INFO
│   ├── cpp/
│   │   ├── CMakeLists.txt         原生模块构建(探测式)
│   │   ├── mysql_napi.cpp         服务生命周期 NAPI(173 行)
│   │   ├── mysql_sql.cpp          SQL 控制台(721 行,链接 libmysqlclient)
│   │   └── mysql_sql_stub.cpp     无引擎时的降级实现
│   ├── ets/
│   │   ├── pages/Index.ets        全部界面(2253 行)
│   │   ├── entryability/EntryAbility.ets
│   │   └── abilitystage/MyAbilityStage.ets
│   └── resources/rawfile/mysql/english/errmsg.sys
└── (仓库根目录)docs/OpenHarmony.md、scripts/、patches/

技术栈映射:

MySQL 桌面/Linux 形态HarmonyOS 形态
mysqld 可执行文件libmysqlsrv.so + OH_Ability_StartNativeChildProcess
shell 启动ArkTS 按钮 → NAPI → 原生子进程
mysql 命令行客户端应用内 SQL 控制台(内嵌 libmysqlclient.a)
my.cnf 配置文件应用内设置页(端口/连接数/缓冲池)
数据目录 /var/lib/mysql应用沙箱 files/mysql/data
mysqldump 备份设置页「备份数据 / 从备份恢复」

最关键的架构选择在这一行:

OH_Ability_StartNativeChildProcess("libmysqlsrv.so:Main", options, &pid);

鸿蒙不允许应用 exec() 沙箱里的二进制(这一点在第二期「澜析工程」里已经踩得很透),所以 MySQL 服务端不是被 exec 起来的,而是由框架在原生子进程里 dlopen 并调用入口函数。这是鸿蒙上跑服务端的唯一正路。


四、原始项目直接跑鸿蒙会遇到什么问题

4.1 musl 不是 glibc

OHOS 的 C 库是 musl。MySQL 里头大量 glibc 专有接口要处理:pthread_setaffinity_np、线程取消、getauxval 之类。仓库里对应的做法是加了一层兼容:

  • mysys/ohos_pthread_compat.cc —— 线程取消兼容
  • sql/resourcegroups/platform/thread_attrs_api_ohos.cc —— 线程属性

这些文件的存在本身就说明:这不是"改个编译参数"能解决的移植。

4.2 没有 OpenSSL 就完全没戏

OHOS 的 native SDK 只带 clang + sysroot + zlib/ICU 这几样,OpenSSL 不在里面。而 MySQL 强依赖 OpenSSL 3.x。

所以移植流程里必须先单独交叉编译一遍 OpenSSL(scripts/build_openssl.sh),再把 -DWITH_SSL=<prefix> 指过去。

4.3 命令行工具直接判死

sysroot 里没有 curses/termcap,mysql、mysqldump 这些依赖终端界面的客户端根本编不出来。

这条限制直接决定了产品形态:必须做一个应用内 SQL 控制台,否则用户连一条 SQL 都发不出去。

4.4 数据目录必须落在沙箱内

Linux 上 MySQL 默认数据目录是 /var/lib/mysql。鸿蒙上应用只能写自己的沙箱,所以数据目录变成:

/data/storage/el2/base/haps/entry/files/mysql/data

这条路径在设置页里是直接展示给用户看的(见 8.3),透明度做得不错。


五、鸿蒙适配核心路径

5.1 第一步:把服务端做成共享库

常规 MySQL 构建产出的是可执行文件 mysqld。鸿蒙上不能用,所以额外加了一个构建目标 mysqlsrv——把服务端编成共享库 libmysqlsrv.so,导出 Main 入口。

服务端入口单独放在 sql/ohos/mysql_child_entry.cc,最终调到标准的 mysqld_main()。也就是说:跑的还是同一份 MySQL 代码,只是进入方式变了。

5.2 第二步:原生子进程启动

mysql_napi.cpp(173 行)导出四个函数:

napi_property_descriptor descriptors[] = {
    {"startServer",  nullptr, StartServer,  ...},
    {"stopServer",   nullptr, StopServer,   ...},
    {"getServerPid", nullptr, GetServerPid, ...},
    {"isSupported",  nullptr, IsSupported,  ...},
};

StartServer 的动作是调 OH_Ability_StartNativeChildProcess("libmysqlsrv.so:Main", ...),StopServer 发 SIGTERM 让 InnoDB 干净落盘。

注释里还记了一个很硬核的坑:

mysqld_exit() uses _exit() on OHOS: the HarmonyOS appspawn runtime interposes exit() and aborts a native child process even after a clean shutdown, which produced a crash report on every stop.

也就是说:正常关闭服务端在鸿蒙上会触发崩溃上报,必须绕过 exit() 直接 _exit()。这种细节只有真跑过才会发现。

5.3 第三步:应用内 SQL 控制台

没有命令行客户端,就只能自己做一个。mysql_sql.cpp(721 行)把 libmysqlclient.a 静态链进 libentry.so,对外导出 11 个 NAPI 函数:

connect / disconnect / isConnected / query
listDatabases / listTables / listColumns
previewTable / previewTableRows / exportCsv / importCsv

界面上的控制台就是这一层:

在这里插入图片描述

几个设计细节:

  • 顶部状态:● 未连接(服务运行时自动连接)——不需要用户手动点连接;
  • 默认预置了一条自检 SQL:SELECT VERSION(), @@version_compile_os, @@version_compile_machine;——第一次用就能验证服务端架构;
  • 支持 导入 .sql 脚本、执行历史(最近 20 条)、结果区格式化对齐。

5.4 第四步:把 my.cnf 变成设置页

Linux 上改参数要编辑 my.cnf 再重启。鸿蒙上没有文件系统入口,所以参数全部搬进设置页:

在这里插入图片描述

四个区块:

区块内容
账号root 密码,同时修改 localhost 与 127.0.0.1 两个账号
访问控制允许局域网访问(默认关,仅本机可连接)
服务器参数端口 3306、最大连接数 151、缓冲池 128 MB
数据沙箱路径展示、备份数据、从备份恢复

这里有三个值得说的判断:

  1. 默认只监听 127.0.0.1,局域网访问要用户手动开。数据库工具默认不对外暴露,这是安全默认值。
  2. 改参数后自动重启服务(按钮写的是「应用并重启服务」),不用用户自己停再起。
  3. 恢复前的数据会保留为 data-before-restore——恢复操作可回退,这是数据工具的基本素养。

5.5 第五步:引擎缺失时的降级

这是本期最特殊的一处工程处理。

仓库不包含 libmysqlsrv.so 和 libmysqlclient.a(它们是交叉编译产物)。如果 CMake 里写死链接,克隆下来必然构建失败——报错是 ninja: error: .../libmysqlclient.a, missing and no known rule to make it。

移植时把 CMake 改成探测式:

if(EXISTS "${MYSQL_CLIENT_LIB}" AND EXISTS "${OPENSSL_SSL}"
   AND EXISTS "${OPENSSL_CRYPTO}" AND EXISTS "${MYSQL_THIRD_PARTY}/include/mysql.h")
  set(HAVE_MYSQL_CLIENT TRUE)
else()
  set(HAVE_MYSQL_CLIENT FALSE)
endif()

if(HAVE_MYSQL_CLIENT)
  add_library(entry SHARED mysql_napi.cpp mysql_sql.cpp)
  target_compile_definitions(entry PRIVATE MYSQL_CLIENT_AVAILABLE=1)
else()
  add_library(entry SHARED mysql_napi.cpp mysql_sql_stub.cpp)
  target_compile_definitions(entry PRIVATE MYSQL_CLIENT_AVAILABLE=0)
endif()

配套写了一份 mysql_sql_stub.cpp:在不含引擎的构建里,11 个 SQL 函数统一返回一句明确的错误——

MySQL engine is not part of this build: third_party/mysql/libmysqlclient.a is missing.

同时 isSupported() 返回 MYSQL_CLIENT_AVAILABLE,让界面能判断「这台设备上的这个包,到底有没有引擎」。

这样做的结果是:任何机器克隆下来都能构建出安装包,而不是卡在编译失败。代价是必须诚实地告诉用户「引擎不在包里」。


六、问题困难解决

6.1 困难一:服务端从未真正编出来

这是本期最核心的事实,必须先摆清楚。

我按 docs/OpenHarmony.md 的流程核查了构建链,它依赖四个外部输入:

输入状态
完整 MySQL 源码树仓库只有 48 个文件(移植补丁 + 应用),不含 storage/、plugin/、vio/ 等核心目录
交叉编译的 OpenSSL✅ 本机 ~/ohos/deps/install-aarch64 里已有 libssl.so.3 / libcrypto.so.3
主机侧构建工具(comp_err、protoc…)❌ 脚本 build_host_tools.sh 在仓库里不存在
完整 build 目录❌ 无

也就是说:OpenSSL 编完了,MySQL 服务端本身从来没编成功过。configure_ohos.sh 里那句 HOST_TOOLS_DIR=${HOST_TOOLS_DIR:-...build-host-tools/runtime_output_directory} 指向的目录并不存在。

这不是移植没做到位,而是上游仓库的定位就是「移植层 + 应用」,不带完整产物。要真正跑起来,得补齐:全量源码 + host tools + 一次几小时的交叉编译。

6.2 困难二:设备上的真实报错是「File exists」

应用装到设备上之后,因为「打开应用时自动启动服务」默认是开的,启动即尝试起库,结果服务状态显示:

在这里插入图片描述

服务状态
启动异常
File exists

实时状态
监听 127.0.0.1:3306    PID -

File exists 是 EEXIST,不是“引擎缺失”这种明确错误。它来自初始化流程里的目录创建——应用在沙箱里建了一套骨架:

files/mysql/
├── data/     ← 空的
├── icu/
├── run/      ← 空的
├── share/
└── tmp/      ← 空的

data/ 是空的,说明 mysqld --initialize-insecure 一次都没成功过。目录建出来了、初始化没跑完、下一次启动又在同一处撞上 EEXIST,于是状态卡在「启动异常」。

顺便也验证了一件事:HAP 里确实没有任何 MySQL 引擎文件(unzip -l 里查不到 libmysqlsrv.so / libmysqlclient.a / libssl.so.3),和 5.5 的降级设计对得上。

6.3 困难三:出错信息不友好

File exists 这种错误对最终用户是没有意义的。它暴露了两个问题:

  1. 错误没有分层:引擎缺失应该报「引擎未就绪」,目录冲突应该报「数据目录异常」,现在全都落到一个裸 errno 字符串上;
  2. 状态机不闭合:启动异常 之后仍然显示「已停止」,两个状态互相矛盾,用户不知道现在到底是停着还是坏了。

如果继续完善,这两处应该优先修:把 errno 翻译成可操作的中文提示,并且让「引擎缺失」在 UI 上一眼可见。

6.4 困难四:数据主权与可恢复性

数据库工具最怕的是「恢复一半坏了」。设置页里这行小字是经过考虑的:

备份/恢复需要先停止服务,恢复前的数据会保留为 data-before-restore

三个动作绑在一起:先停服务(保证一致性)→ 恢复 → 旧数据留档(可回退)。这是数据库运维的基本要求,做到了。


七、构建与运行方式

7.1 环境

  • DevEco Studio(内置 hvigor + SDK)
  • HarmonyOS SDK API 26(本机 26.0.0.105)
  • 如需完整引擎:OHOS native SDK(clang + sysroot)+ Flang + 交叉编译的 OpenSSL

7.2 构建

cd harmony_pc
ohpm install
hvigorw assembleHap --mode module -p product=default -p buildMode=debug

产物:

entry-default-unsigned.hap   2.1 MB

纯 ArkTS + 薄原生层,构建约 4 秒。

7.3 签名与安装

scripts/sign_hap.sh(环境变量方式)或 DevEco 自动签名。调试 profile 绑 UDID,换设备需重新自动签名。

hdc shell aa start -b com.qingjian.editor -a EntryAbility

7.4 若要真正起库

需要按下述顺序补齐(这是 docs/OpenHarmony.md 描述的完整链路):

  1. 拉取全量 mysql-server 源码,叠加本仓库的 patches/
  2. scripts/build_openssl.sh —— 交叉编译 OpenSSL 3.x 到 aarch64-linux-ohos
  3. 构建 host tools(comp_err、comp_client_err、comp_sql、gen_lex_hash、gen_lex_token、gen_keyword_list、uca9dump、protoc)
  4. scripts/configure_ohos.sh + ninja mysqlsrv mysqlclient
  5. scripts/package_into_hap.sh 把 libmysqlsrv.so、libssl.so.3、libcrypto.so.3 等塞进 entry/libs/arm64-v8a/

完成后重新构建,CMake 会自动探测到引擎并把控制台编进去。


八、适配成果

8.1 服务管理页

在这里插入图片描述

一屏给出四个关键信息:服务状态(启动异常/运行中/已停止)、实时状态(监听地址 + PID)、操作按钮(启动/停止)、运行日志(mysqld 错误日志,最近 16 KB)。

右上角常驻「已停止」状态徽标,底部注明「数据位于应用沙箱内,可在『设置』中备份」——用户随时知道数据在哪。

8.2 SQL 控制台

在这里插入图片描述

见 5.3。这是整个应用的核心价值点:没有它,鸿蒙上的 MySQL 就是个没有入口的服务端。

8.3 设置页

在这里插入图片描述

见 5.4。四个区块覆盖了一个数据库实例的日常运维需求:账号、访问控制、服务器参数、数据备份。

数据路径直接显示绝对路径 /data/storage/el2/base/haps/entry/files/mysql/data,不藏着。

8.4 数据浏览器(三栏)

在这里插入图片描述

这是应用里最重的一个界面,也是数据库工具的核心:数据库 → 表 → 内容 三栏联动。

区域能力
数据库栏刷新、新建库(输入库名)、创建示例库
表栏新建表
内容区插入行 / 清空表 / 删除表 / 导入 / 导出
字段区字段名 + 类型(默认 VARCHAR(64))+ 添加/删除字段
分页第 1 行起 · 每页 100 行 + 上一页/下一页

「创建示例库」这个入口值得一提:新用户不知道该建什么库,一键给一套示例表,这是数据库工具降低上手门槛的标准做法。

8.5 真实交互:改设置与走备份

光有静态界面不能说明它「能用」,所以我按真实用户路径操作了几步。

第一步:打开局域网访问

在这里插入图片描述

默认是关闭状态,注释写「关闭时仅本机可连接(推荐)」。手动打开后开关变蓝,配置立即生效(服务未运行时先落盘,下次启动生效)。

第二步:点「从备份恢复」

在这里插入图片描述

这个操作真实拉起了系统文件选择器:

  • 左侧是鸿蒙标准的「最近 / 智能分类 / 快速访问 / 存储位置」;
  • 顶部有分区存储提示:「应用仅可访问您选定的文件或文件夹」;
  • 文件类型过滤为 所有文件 (*.*)——因为备份是 .zip,没有专用 MIME;
  • 列表里能看到设备上真实的文件(qtOBJ.zip、electronHAP.zip、ocr-sample.jpeg 等)。

也就是说:备份/恢复这条链路是通的,应用确实通过系统选择器读写用户指定的文件,而不是自己扫目录。

第三步:点「启动 MySQL」

按 5.5 的降级设计,这个按钮在无引擎构建里被 isSupported() 置灰。点击无响应——不是卡死,是明确地拒绝了一个做不到的动作。

对比「点了没反应」和「点了弹了个假进度条」,前者是可接受的工程处理。

8.6 工程量

指标数值
ArkTS 源文件3 个
ArkTS 代码行数2297 行(Index.ets 2253 行)
原生代码mysql_napi.cpp 173 行 + mysql_sql.cpp 721 行
权限INTERNET、GET_NETWORK_INFO
HAP 体积2.1 MB
随包引擎❌ 未包含

8.7 同类移植项目横向对比

ClipNest澜析工程沙箱控制台晶析云源库服务
类型本地工具本地计算云客户端混合模式本地服务端
ArkTS 行数47823417586234762297
原生代码0619 行00894 行
随包原生产物017 MB000(缺引擎)
HAP 体积752 KB19 MB892 KB444 KB2.1 MB
核心难点权限与自写入回环进程模型双端点 API本地/远端边界musl + 子进程 + 缺引擎

九、功能验证结果

9.1 已在真机验证

功能结果验证方式
构建与安装✅2.1 MB HAP 产出,hdc install 成功
应用启动✅进程稳定运行,窗口正常渲染
四 Tab 导航✅服务 / SQL 控制台 / 数据 / 设置 正常切换
服务状态展示✅状态徽标、监听地址、PID 占位均正确
自动启动行为✅配置为自动启动,启动即尝试起库
真实错误回显✅捕获到 启动异常 / File exists(见 6.2)
SQL 控制台界面✅编辑器、预置自检 SQL、执行/历史/导入按钮完整
连接状态提示✅显示「未连接(服务运行时自动连接)」
设置页全量渲染✅账号、访问控制、参数、数据四个区块
数据浏览器三栏✅数据库/表/内容三栏 + 字段编辑区正常渲染
局域网开关交互✅手动打开后开关状态变化,配置立即保存
备份/恢复走系统选择器✅点「从备份恢复」真实拉起系统文件选择器
启动按钮的降级行为✅无引擎时按钮置灰,不产生虚假进度
服务器参数默认值✅端口 3306 / 最大连接数 151 / 缓冲池 128 MB
数据路径展示✅沙箱绝对路径正确显示
备份/恢复入口✅按钮与「保留 data-before-restore」说明存在
沙箱目录骨架✅files/mysql/{data,icu,run,share,tmp} 已创建
HAP 引擎核查✅包内无 libmysqlsrv.so / libmysqlclient.a

十、上架复盘:审核不通过怎么办

移植跑通只是第一关。上架审核看的是另一套东西:用户会不会把这款应用误认为上游官方版,或者误认为换皮抄袭。名称、图标、截图、描述、权限、实际行为,只要有一项对不上,就可能被驳回。

10.1 名称和图标:开源许可不等于品牌许可

这是最容易踩的坑。很多人觉得“这是开源软件,保留原名和原图标很正常”,但 MIT/Apache/GPL 给的是版权许可,不是商标许可。审核看到“应用名和上游一样、图标是上游 Logo 换色、截图里还有上游品牌”,就会按“冒用/抄袭”处理。典型的三连击是:应用名直接沿用上游、图标只把颜色换一下、截图里还带着上游 Logo——即使代码全部重写,也会被判定为冒用。

我们的处理原则:

  • 应用名改成独立品牌,包名不带上游商标;
  • 图标重画,不复用、不改色、不截取上游 Logo;
  • 截图、启动图、关于页不出现上游 Logo,只保留文字致谢;
  • 关于页写明“基于 MySQL Server 移植,非官方发行”,并保留上游 LICENSE/NOTICE;
  • 如果被质疑,提交《品牌与素材来源说明》:改名前后对照、图标设计稿、上游许可证、代码差异、真机录屏。

10.2 被判定“抄袭/雷同”时,交什么证据

只回“这是开源软件”通常没用。按这个顺序给材料:

  1. 上游仓库地址和 LICENSE 原文;
  2. 本仓库与上游的差异清单(UI 重写、平台层、构建脚本);
  3. 品牌变更记录(旧名→新名、旧图标→新图标);
  4. 功能差异说明(哪些是鸿蒙特有、哪些上游没有);
  5. 真机录屏,证明不是套壳。

如果确实沿用了上游 UI,先改再申诉;审核一般不看“开源所以可以一样”的解释。

10.3 这个项目的高频驳回点

  • 应用内跑服务端:审核会关注端口、默认密码和安全边界。默认只监听 127.0.0.1,首次启动强制改密码,审核备注说明“本地开发用途”。
  • GPL 义务:关于页给源码地址和许可证,说明服务端来源与修改。
  • 品牌:MySQL/Oracle 的商标和“海豚”图标不能用;“源库服务”+ 自绘图标,关于页注明非官方。

10.4 驳回后的处理顺序

先分类,再动手。审核意见通常落在六类:名称/图标/品牌、隐私与权限、功能与描述不符、技术(签名/包名/架构/体积/崩溃)、内容合规、资质(软著/授权书/备案)。

  • 一次只改一类,别在同一个版本里混改;
  • 回复时逐条对应:版本号 + 审核意见 + 改了什么 + 怎么验证;
  • 测试账号/令牌在复审前重置,写进审核备注;
  • 截图必须来自当前版本真机,不能用设计稿;
  • 换正式证书后重新打包,不要用调试签名送审;
  • 被拒后先回一条“已收到,逐条说明”,再提新包,避免被判定骚扰;
  • 上架材料提前备齐:软著/授权书、隐私政策公网 URL、测试账号、真机截图、开源许可证与 NOTICE。

回复可以按这个模板:

您好,针对第 X 条“……”:我们已在版本 A.B.C 中修改:1)……;2)……。验证路径:……。相关材料见附件/链接。

一句话:上架不是“把包传上去”,而是把“这不是官方版、也不是换皮”这件事,用名称、图标、截图、代码和材料同时证明一遍。

十一、结语

一期做服务端,才知道「没有界面可用」是什么感觉——前四期多少都有个东西可以对着画,这次只能从 my.cnf 和 mysql 客户端的使用习惯里,把该有的功能一件件搬进 GUI。

四点体会:

  1. 鸿蒙上跑服务端的唯一正路是原生子进程。exec 沙箱二进制这条路早在第二期就被堵死了,OH_Ability_StartNativeChildProcess 是官方给的出口。MySQL 的 libmysqlsrv.so:Main 就是这个模式的教科书用法。

  2. musl + 缺库 + 缺 curses,三个坑叠在一起。移植一个几百万行的 C++ 服务端,真正的工作量不在应用层,而在于把 glibc 假设一条条拆掉、把缺失的依赖一个个交叉编出来。

  3. 仓库要能构建,就必须做降级设计。CMake 探测 + stub 实现这套组合,让「没有引擎」的克隆也能出安装包。代价是必须在 UI 上诚实标注——这也是本期为什么把 File exists 这条真实错误原样写进文章。

  4. 数据库工具的错误信息必须分层。File exists 这种裸 errno 出现在一个面向非 DBA 用户的鸿蒙应用里,是不合格的。这块是下一步优先要修的。

2.1 MB 的包,装着一个完整的 MySQL 管理界面。它现在还不能真的起库——但从界面到原生子进程、从参数配置到备份恢复的整条链路都铺完了,缺的只是一个愿意花几个小时把引擎交叉编译出来的构建环境。

这也是最需要说清楚边界的一个项目:移植做完了,产物还没到位。两者不该混为一谈。


一句话:移植做完了、产物还没到位——这两件事不该混为一谈。

相关链接

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐