鸿蒙 PC:源库服务(ohos_MySQLCommunityEdition)数据库服务端移植全记录
几百万行 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 |
| SDK | HarmonyOS 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 开头就给了状态表,写得很克制也很实在:
| Item | State |
|---|---|
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 PC | starts in a native child process of the HAP, harmony_pc/ |
| Storage engines | InnoDB and the built-in engines; NDB disabled |
| Auth | built-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 interposesexit()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 |
| 数据 | 沙箱路径展示、备份数据、从备份恢复 |
这里有三个值得说的判断:
- 默认只监听 127.0.0.1,局域网访问要用户手动开。数据库工具默认不对外暴露,这是安全默认值。
- 改参数后自动重启服务(按钮写的是「应用并重启服务」),不用用户自己停再起。
- 恢复前的数据会保留为
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 这种错误对最终用户是没有意义的。它暴露了两个问题:
- 错误没有分层:引擎缺失应该报「引擎未就绪」,目录冲突应该报「数据目录异常」,现在全都落到一个裸
errno字符串上; - 状态机不闭合:
启动异常之后仍然显示「已停止」,两个状态互相矛盾,用户不知道现在到底是停着还是坏了。
如果继续完善,这两处应该优先修:把 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 描述的完整链路):
- 拉取全量
mysql-server源码,叠加本仓库的patches/ scripts/build_openssl.sh—— 交叉编译 OpenSSL 3.x 到aarch64-linux-ohos- 构建 host tools(
comp_err、comp_client_err、comp_sql、gen_lex_hash、gen_lex_token、gen_keyword_list、uca9dump、protoc) scripts/configure_ohos.sh+ninja mysqlsrv mysqlclientscripts/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 行数 | 4782 | 3417 | 5862 | 3476 | 2297 |
| 原生代码 | 0 | 619 行 | 0 | 0 | 894 行 |
| 随包原生产物 | 0 | 17 MB | 0 | 0 | 0(缺引擎) |
| HAP 体积 | 752 KB | 19 MB | 892 KB | 444 KB | 2.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 被判定“抄袭/雷同”时,交什么证据
只回“这是开源软件”通常没用。按这个顺序给材料:
- 上游仓库地址和 LICENSE 原文;
- 本仓库与上游的差异清单(UI 重写、平台层、构建脚本);
- 品牌变更记录(旧名→新名、旧图标→新图标);
- 功能差异说明(哪些是鸿蒙特有、哪些上游没有);
- 真机录屏,证明不是套壳。
如果确实沿用了上游 UI,先改再申诉;审核一般不看“开源所以可以一样”的解释。
10.3 这个项目的高频驳回点
- 应用内跑服务端:审核会关注端口、默认密码和安全边界。默认只监听 127.0.0.1,首次启动强制改密码,审核备注说明“本地开发用途”。
- GPL 义务:关于页给源码地址和许可证,说明服务端来源与修改。
- 品牌:MySQL/Oracle 的商标和“海豚”图标不能用;“源库服务”+ 自绘图标,关于页注明非官方。
10.4 驳回后的处理顺序
先分类,再动手。审核意见通常落在六类:名称/图标/品牌、隐私与权限、功能与描述不符、技术(签名/包名/架构/体积/崩溃)、内容合规、资质(软著/授权书/备案)。
- 一次只改一类,别在同一个版本里混改;
- 回复时逐条对应:版本号 + 审核意见 + 改了什么 + 怎么验证;
- 测试账号/令牌在复审前重置,写进审核备注;
- 截图必须来自当前版本真机,不能用设计稿;
- 换正式证书后重新打包,不要用调试签名送审;
- 被拒后先回一条“已收到,逐条说明”,再提新包,避免被判定骚扰;
- 上架材料提前备齐:软著/授权书、隐私政策公网 URL、测试账号、真机截图、开源许可证与 NOTICE。
回复可以按这个模板:
您好,针对第 X 条“……”:我们已在版本 A.B.C 中修改:1)……;2)……。验证路径:……。相关材料见附件/链接。
一句话:上架不是“把包传上去”,而是把“这不是官方版、也不是换皮”这件事,用名称、图标、截图、代码和材料同时证明一遍。
十一、结语
一期做服务端,才知道「没有界面可用」是什么感觉——前四期多少都有个东西可以对着画,这次只能从 my.cnf 和 mysql 客户端的使用习惯里,把该有的功能一件件搬进 GUI。
四点体会:
-
鸿蒙上跑服务端的唯一正路是原生子进程。
exec沙箱二进制这条路早在第二期就被堵死了,OH_Ability_StartNativeChildProcess是官方给的出口。MySQL 的libmysqlsrv.so:Main就是这个模式的教科书用法。 -
musl + 缺库 + 缺 curses,三个坑叠在一起。移植一个几百万行的 C++ 服务端,真正的工作量不在应用层,而在于把 glibc 假设一条条拆掉、把缺失的依赖一个个交叉编出来。
-
仓库要能构建,就必须做降级设计。CMake 探测 + stub 实现这套组合,让「没有引擎」的克隆也能出安装包。代价是必须在 UI 上诚实标注——这也是本期为什么把
File exists这条真实错误原样写进文章。 -
数据库工具的错误信息必须分层。
File exists这种裸errno出现在一个面向非 DBA 用户的鸿蒙应用里,是不合格的。这块是下一步优先要修的。
2.1 MB 的包,装着一个完整的 MySQL 管理界面。它现在还不能真的起库——但从界面到原生子进程、从参数配置到备份恢复的整条链路都铺完了,缺的只是一个愿意花几个小时把引擎交叉编译出来的构建环境。
这也是最需要说清楚边界的一个项目:移植做完了,产物还没到位。两者不该混为一谈。
一句话:移植做完了、产物还没到位——这两件事不该混为一谈。
相关链接
- 适配仓库:https://atomgit.com/OpenHarmonyPCDeveloper/ohos_MySQLCommunityEdition
- 上游项目 MySQL Server:https://github.com/mysql/mysql-server
- OpenHarmony PC 开发者社区:https://atomgit.com/OpenHarmonyPCDeveloper
更多推荐

所有评论(0)