开源移植实战：把 Arduino IDE 移植到鸿蒙 PC —— 轻创客 适配全记录

欢迎加入开源鸿蒙 PC 社区https://harmonypc.csdn.net/欢迎在 PC 社区平台申请新建项目https://atomgit.com/OpenHarmonyPCDeveloper适配开源地址https://gitcode.com/OpenHarmonyPCDeveloper/ohos_ArduinoIDE一、为什么要适配 轻创客「轻创客」的定位是开源硬件 IDE。选择 Arduino IDE 做鸿蒙 PC 适配看中的是它在同类桌面工具中的位置上游社区活跃、功能覆盖完整、许可合规路径清晰。对 HarmonyOS PC 生态而言这类桌面级工具正是应用矩阵里最稀缺的一块。Arduino IDE 是 Web 应用形态界面运行在浏览器引擎里本地能力文件、窗口、外链依赖宿主环境——这些假设在鸿蒙上都不成立。把它带过来等于回答一组结构性的问题如何在没有传统显示服务器、没有窗口管理器参与窗口治理的系统上渲染并接收输入文件、剪贴板、输入法如何对接以及 AGPL-3.0 许可义务如何合规履行。当前适配的发布形态「轻创客」已上架华为应用市场开源仓与本篇对应https://gitcode.com/OpenHarmonyPCDeveloper/ohos_ArduinoIDE。收录上游版本 2.3.11。二、先划清边界不是编译通过而是换掉平台依赖如果只以消除编译报错为目标把源码编出动态库也得不到可用的应用。本项目的验收口径是真机上可安装、可启动、可完成核心工作闭环。上游实现与鸿蒙侧方案的对应关系如下层次上游实现鸿蒙侧方案UI 运行时Electron / 浏览器系统 ArkWeb 承载 Web 应用本地 APINode/Electron 主进程boot.js 桥文件对话框/剪贴板/窗口控制映射到 ArkTS进程多进程单进程 kiosk 形态三、鸿蒙版的整体架构Web 应用类移植以系统 ArkWeb 为运行时应用静态资源随包部署壳层以 boot.js 桥把Web 侧需要的能力文件选择、下载、外部链接、窗口控制映射到 ArkTS 实现。应用 Web 代码零修改或仅去品牌小补丁输入法由 ArkWeb 原生承载无需桥接。仓库收录 2590 个上游源码文件约 119.7 MiB与移植层配套全仓 4433 个文件。结构如下仓库结构上游源码树整树收录在仓库根目录 ├── 上游源码树 → 仓库根目录arduino-ide ├── port-*/ # 平台配套patches、scripts、src ├── README-upstream.md # 上游原始 README 存档 └── README.md # 中文仓库说明四、核心适配过程资源随包Web 构建产物入 rawfile首启按版本戳幂等解压boot.js 桥window 注入桥对象文件/分享/外链逐项映射去品牌化启动页/帮助/外链按上架口径裁剪导航兜底BACK 被页面吞时由壳层提供导航回退。工程推进中的关键节点摘自工程台账补遗调研已证伪 TheiaNode 死路arduino-cli 归 TUI 工具箱线Go-OHOS spike 前置2026-10-27 回读市场名去品牌改名「轻创客」AppScope app_name3 套 EntryAbility_label隐私协议名三处已对齐11 项受限 ACL 全部获批并出发布 Profile1.1.0/1100000 于 10-27 08:34 CST 送审人工审核state4、reviewState1、无在架版本随包 HNP 原生编译链已在 2in1 实证IDE 442BCLI 944B上传/串口为平台能力缺口文案已删该表述五、适配中的难点与对策难点一后端依赖需要服务端的 Web 应用在端侧不可验上架口径需标注或提供演示后端。难点二触摸适配Web 应用假定鼠标悬停触摸直通与兜底导航是必调项。六、编译、安装与启动环境前置DevEco Studiohvigorw 与 OHOS SDK、meson ninja、python3交叉工具链路径见仓库port-*/scripts/env.sh。仓库port-*/scripts/内含交叉构建脚本链改动上游树或后端补丁后按BUILD.md/脚本注释重跑对应构建再打包hvigorw assembleApp --no-daemon安装与启动hdc install -r entry/build/default/outputs/default/*-signed.hap hdc shell aa start -b com.airarduino.app -a EntryAbility七、功能边界与合规能力边界如实说明已验证的是可安装、可启动、核心工作流可用依赖独立进程或平台缺口的能力如部分插件体系不在当前形态内后续以仓库记录为准逐项推进不提前宣称完成。合规方面Arduino IDE 采用 AGPL-3.0本仓库对源码的全部修改在同协议下公开预编译产物与源码同仓分发以满足对应源码义务再分发产物时必须一并提供完整源码。上游项目名与商标归其所有方本适配为独立衍生作品不代表上游官方背书。签名私钥与含密钥配置一律不入库。八、总结这套适配的价值不在于能跑一个演示程序而在于把 Arduino IDE 这样体量的 ArkWeb 壳 应用整体搬到鸿蒙 PC 的路径走通平台依赖收敛到可替换的后端窗口治理与输入法在壳层补齐许可义务随仓库履行。最终产物是能在 HarmonyOS PC、平板乃至手机上安装使用的完整应用「轻创客」。欢迎在开源鸿蒙 PC 社区https://harmonypc.csdn.net/交流移植经验仓库地址https://gitcode.com/OpenHarmonyPCDeveloper/ohos_ArduinoIDE