feat: HarmonyOS/OHOS platform support — 移植完成，征求合入意见

[pandaJuEned]

feat: HarmonyOS/OHOS platform support — 移植完成，征求合入意见

背景

我已将 Server Box 移植到华为鸿蒙（OpenHarmony / HarmonyOS NEXT），应用可在 OHOS 设备上正常运行。完整的踩坑记录已整理成专栏：

• 📝 移植记录：https://www.bilibili.com/opus/1239215970340306953
• 🎥 运行视频：https://www.bilibili.com/video/BV1u48B6PEyW

环境：Flutter SDK 3.41.10-ohos-1.0.0（华为 fork，Dart 3.11.5）/ OpenHarmony 6.1.1.120 (API 24, aarch64)

想征求一下您是否愿意合入 OHOS 平台支持，以及期望的提交形式——因为改动涉及面较广，想先沟通再整理 PR，避免白做。

改动范围

1. OHOS 平台目录（ohos/）

• EntryAbility.ets：注册 path_provider / shared_preferences / flutter_secure_storage 三个 MethodChannel（OHOS 引擎不自动注册 Android/iOS 插件）
• shared_preferences / flutter_secure_storage：文件持久化实现（非内存 Map，重启不丢数据）
• 预编译 libsqlite3.so（SQLite3MultipleCiphers，OHOS 无系统 SQLite）
• hvigor 构建配置、资源、测试用例
• 平板/横屏适配（module.json5）

2. Rust FFI 交叉编译

• OHOS target aarch64-unknown-linux-ohos（Tier 3，需 nightly + -Z build-std）
• native_toolchain_rust：target 映射 + 解除 nightly 禁令
• 链接器 wrapper（OHOS ld.lld 不兼容 GNU ld 部分选项）
• flutter_pty 的 C 代码绕过 CBuilder 直接调用 OHOS clang

3. 第三方库 OHOS 适配（pub cache 补丁）

库	改动
responsive_framework	switch 补 TargetPlatform.ohos 分支
flutter_math_fork	selectable.dart / line_editable.dart 同上
flutter_secure_storage	复用 AndroidOptions 作 fallback
sqlite3	load_library.dart 加 OHOS 分支 DynamicLibrary.open('libsqlite3.so')

4. fl_lib 的 OHOS 适配

• TargetPlatform.ohos 相关处理
• Flutter 3.41 API 变更适配（SizeTransition.alignment→axisAlignment、sqlite3 close()→dispose()、onReorderItem→onReorder 等）

需要沟通的点

1. 是否接受 OHOS 作为第六个平台？ 项目目前支持 Android/iOS/macOS/Linux/Windows。
2. 提交形式：改动涉及 fl_lib（需单独向 lollipopkit/fl_lib 提 PR）、若干第三方库的 OHOS 补丁（提 PR 到上游库 or fork）、以及本仓库的 ohos/ 目录。您希望怎么拆分？
3. 第三方库补丁：pub cache 补丁不持久，正式做法是 dependency_overrides 指向 fork 或向上游库提 PR。您倾向哪种？
4. 依赖版本：为配合华为 fork 的 Flutter 3.41，我本地降级了 drift_dev/freezed/riverpod_generator 等。这部分不会进 PR，仅说明背景。

当前状态

移植已完成，应用正常启动（服务器列表、SSH 终端、SFTP、Docker 等功能可用），重启不白屏。如果您有意合入，我会按您的要求整理成干净的 PR。

期待您的意见 🙌

[winnowl]

Issue triage

Feasibility:needs-clarification ｜ Risk:medium

Related code:

• ohos/EntryAbility.ets · EntryAbility
• ohos/ · OHOS platform module and build configuration
• native_toolchain_rust · OHOS target mapping and linker configuration
• flutter_pty/ · OHOS C/FFI build integration
• fl_lib/ · TargetPlatform.ohos and Flutter API compatibility
• pubspec.yaml · dependency overrides and platform-specific dependencies

Information needed to reproduce:

• Which exact repository commit or patch contains the OHOS port, since the issue describes completed local changes but does not attach a PR or diff?
• What is the minimum supported OHOS device/API level and architecture beyond OpenHarmony 6.1.1.120/API 24/aarch64?
• Can the reporter provide reproducible build commands, required Flutter OHOS SDK/toolchain versions, Rust nightly version, and any environment variables or linker-wrapper setup?
• Which features and automated tests were run on OHOS, especially SSH terminal, SFTP, Docker, SQLite encryption, secure storage persistence, and app restart?
• Can the reporter provide a clean-install and upgrade/migration test showing persistence behavior for shared preferences, secure storage, and SQLite data?
• How are the pub-cache patches currently applied, and are upstream PRs or maintained forks available for each affected dependency?
• Are there known limitations on OHOS, including permissions, background execution, filesystem paths, keyboard/input, orientation, or plugin API differences?
• Can a non-HarmonyOS build be verified from the same proposed changes to detect regressions on Android, iOS, macOS, Linux, and Windows?

Suggested labels(not applied automatically):enhancement, platform: HarmonyOS/OHOS, cross-compilation, third-party-dependencies

Suggested owners(not applied automatically):platform/maintainers, build-system maintainers, fl_lib maintainers

[GT-610]

牛逼兄弟，有源代码吗，看一看我们做个对比，如果好合的话会考虑

[pandaJuEned]

@GT-610 有的，源代码在我的仓库上https://github.com/pandaJuEned/flutter_server_box 我的仓库就是fork你们的

[GT-610]

主要问题还是：

• Flutter 3.41和当前3.44基线不一致，3.44的API改动很大，没法回退
• Rust nightly和当前1.97.1基线不一致
• libsqlite3.so的源代码缺失。项目要求100%自由软件+可重复构建，如果只有二进制没有源代码的话不能合入

OH那边有3.44之后在3.44上看一下吧，以及别忘了同步main的最新更改🤔

[pandaJuEned]

好的，我跟进看看OH3.44的进展