在鸿蒙PC上适配ocs desktop手记
鸿蒙适配开源地址:https://atomgit.com/OpenHarmonyPCDeveloper/ohos_ocs-desktop
欢迎在 PC 社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper
开源鸿蒙 PC 社区:https://harmonypc.csdn.net/
这篇文章记录的是开源浏览器多开管理工具 OCS Desktop(Electron + Vue 3)在 OpenHarmony / HarmonyOS PC(2in1 形态)上的适配过程,偏向「工程复盘」:每一步做什么、遇到什么报错、怎么定位、改哪一层、如何确认生效,全部真实执行与留档。
本次适配的核心事实是:仓库中原有的 Electron + Vue 3 代码(约 2.8 万行)基本保持原样,适配工作集中在三件事上——把 Web 渲染产物内联进 HAP 交给 ArkWeb 承载(或交给 Electron-OH 运行时承载)、把平台差异收敛到一个适配层、把构建链从桌面环境搬到鸿蒙 PC 本机。围绕这条链路,重点处理了几条主线:
- 渲染产物单文件内联进 HAP rawfile,ArkWeb
Web组件直接加载,真机离线独立运行 - 平台判定、GPU 策略、能力开关收敛到
packages/app/src/platform/,业务代码零散布 - 构建链在鸿蒙 PC 本机打通:esbuild 官方 openharmony 二进制 + rollup WASM + hvigor 打包
- devecocli(AGC 调试证书 + 本机 UDID profile)完成签名,本机安装、启动、日志与截屏取证
最终效果——签名 HAP 在本机安装、启动后,OCS 以独立应用窗口运行:

完整适配过程(命令 / 报错 / 解决 / 证据):docs/harmonyos-pc-adaptation-log.md
一、项目背景
OCS Desktop 是一个基于 Electron 的浏览器多开/分身管理工具,项目描述是:
拥有 一键刷课,多账号刷课,浏览器多开/分身,浏览器管理,自动登录 等功能
当前适配项目版本:
cn.enncy.ocs 3.9.1(HAP)
项目原生的技术栈包括:
- Electron 43 + Vue 3 + Vite 5(界面与渲染)
- electron-store + AES-256-GCM 信封加密(配置持久化)
- Express 本地服务(导航页 / 图标 / 用户脚本代理)
这个项目的关键特点是:界面是标准 Vue 单页应用,与 Electron API 的耦合点集中在 window.electron 与 IPC 四动词协议。因此鸿蒙适配的取舍是:Vue 渲染产物原样保留、以「内联单文件 + ArkWeb 承载」或「Electron-OH 运行时承载」两种形态运行,平台差异全部收敛进适配层。这也决定了适配的主要工作不在业务代码,而在构建链搬迁与运行形态选择。
全部构建、签名、安装、运行与验证均在鸿蒙 PC 本机完成:系统预装命令行工具包 hmos-clt(hvigor / ohpm / SDK / hdc / node),配合已登录华为开发者账号的 devecocli 完成签名与部署,不需要额外的桌面开发机。
二、项目结构
.
├── packages/
│ ├── app/ # Electron 主进程(@ocs-desktop/app)
│ │ ├── index.ts # 启动编排:GPU 开关 / 平台分支 / 本地服务 / 窗口
│ │ ├── src/platform/ # ★ 平台适配层(isOhos 判定 / GPU 开关 / BrowserRuntime)
│ │ │ ├── runtime.ts # 单一事实来源:isOhos + flags + GPU_SWITCHES
│ │ │ └── browser/ # 分身运行时(persist 分区 + CDP PageLike,替代 Playwright)
│ │ └── electron.vite.config.ts # OCS_OHOS_BUNDLE 全量 bundle 模式
│ ├── web/ # Vue 3 渲染层(零改动)
│ │ └── vite.config.ohos.ts # ★ ArkWeb 单文件产物构建配置(IIFE 内联)
│ └── common/ # 共享代码
├── ohos_hap/ # 鸿蒙 HAP 工程
│ ├── entry/src/main/
│ │ ├── module.json5 # deviceTypes: ["2in1", "tablet"]
│ │ └── ets/pages/Index.ets # ArkWeb 承载页(Web 组件加载 rawfile 单文件)
│ ├── web_engine/.../CommandLineAdapter.ets # ★ Electron-OH 命令行参数(GPU 开关镜像)
│ └── entry/src/main/resources/rawfile/renderer/ # 内联后的单文件渲染产物(构建产物)
├── scripts/
│ ├── verify-ohos-bundle.cjs # ★ bundle 自包含校验(状态机扫描外部 require)
│ └── inline-ohos-renderer.cjs # 渲染产物内联进 index.html
├── docs/
│ ├── harmonyos-pc-adaptation-log.md # 完整适配日志(E1–E48 报错索引与证据)
│ └── assets/harmonyos/ # 截图、GPU 证据、设备信息
└── README.OpenHarmony_CN.md # 本文档
一次构建包含两个产物:全量 bundle(out/main/index.js 3.52 MB + out/renderer/,供 Electron-OH 运行时或桌面端使用)与 ArkWeb 单文件(rawfile/renderer/index.html 5.8 MB,HAP 离线自包含)。
三、环境要求
| 项 | 要求 | 说明 |
|---|---|---|
| 设备 | 鸿蒙 PC(2in1 形态),aarch64 | 实测 HUAWEI MateBook Pro,HarmonyOS 6.1.x |
| 命令行工具 | hmos-clt 1.0.0(系统预装) | hvigor / ohpm / SDK / hdc |
| Node | hmos-clt 自带 v24.18.1 | 不要用系统 /data/service/hnp/bin/node(V8 崩溃,见 E39) |
| Node.js / pnpm(构建 JS 侧) | Node ≥ 22 / pnpm ≥ 10 | pnpm 从 npmmirror 手动部署(见第五步第二步) |
| 签名 | devecocli(已登录华为开发者账号) | AGC 调试证书 + 本机 UDID profile |
| SDK 版本 | compatibleSdkVersion 6.1.0(23) / targetSdkVersion 6.1.1(24) | 对齐真机 |
| 设备类型 | 2in1 / tablet | phone 未验证 |
四、编译与运行
1. 获取代码与依赖
git clone git@atomgit.com:OpenHarmonyPCDeveloper/ohos_ocs-desktop.git
cd ohos_ocs-desktop
CLT=/data/service/hnp/hmos-clt.org/hmos-clt_1.0.0
export PATH="$HOME/.local/bin:$PATH" # 可用的 node 与 pnpm(见第五步)
pnpm install
2. 构建产物
pnpm build:ohos # 全量 bundle + 自包含校验(Electron-OH 形态输入)
pnpm build:ohos:renderer # ArkWeb 单文件渲染产物(ArkWeb 承载形态输入)
3. 打包、签名、安装
cd ohos_hap
devecocli signature generate # AGC 调试证书 + 本机 UDID profile
devecocli build # hvigor 打包 + SignHap
# → entry/build/default/outputs/default/entry-default-signed.hap
devecocli run --skip-build # 安装 + 启动(本机回环设备 127.0.0.1)
# → App installed successfully / start ability successfully.
详细分步与报错处理见第五步起的十步详述。
五、如何完成 PC 适配
适配按实际操作顺序分十步完成,每一步做什么、遇到什么报错、怎么定位、改哪一层、如何确认生效,全部真实执行与留档。这里给出主干流程,完整命令与报错见 docs/harmonyos-pc-adaptation-log.md(E1–E48 报错索引)与 docs/assets/harmonyos/。
第一步:准备开发环境
鸿蒙 PC 预装的 hmos-clt 就是本机构建的基础,但它自带的 node 有版本之分:
Node 版本坑(E39,必读):系统 PATH 里的 /data/service/hnp/bin/node(v24.13.0)执行任何脚本都会立刻崩溃:
# Fatal error in , line 0
# Check failed: 12 == (*__errno_location()).
Signal 5 (core dumped)
定位:hnp 分发的这版 node 与 musl 环境的 V8 errno 断言不兼容。解决:全部 node 调用改走 hmos-clt 自带的 v24.18.1:
mkdir -p ~/.local/bin
cat > ~/.local/bin/node <<'EOF'
#!/bin/sh
exec /data/service/hnp/hmos-clt.org/hmos-clt_1.0.0/node/bin/node "$@"
EOF
chmod +x ~/.local/bin/node
node -v # v24.18.1
npm 与 corepack 在本机同样不可用(同一个崩溃根因),pnpm 从 npmmirror 手动部署——下载官方 tgz,解出 bin/pnpm.cjs 与 dist/,用可用的 node 以包装脚本方式运行:
mkdir -p ~/.local/bin ~/.local/lib/pnpm/bin && cd /tmp
curl -fsSL -o pnpm.tgz https://registry.npmmirror.com/pnpm/-/pnpm-10.21.0.tgz
mkdir pnpm-pkg && tar -xzf pnpm.tgz -C pnpm-pkg --strip-components=1
mkdir -p ~/.local/lib/pnpm
cp -r pnpm-pkg/package ~/.local/lib/pnpm
cat > ~/.local/bin/pnpm <<'EOF'
#!/bin/sh
exec /data/service/hnp/hmos-clt.org/hmos-clt_1.0.0/node/bin/node \
"$HOME/.local/lib/pnpm/bin/pnpm.cjs" "$@"
EOF
chmod +x ~/.local/bin/pnpm
pnpm -v # 10.21.0
pnpm.cjs 内部会 require('../dist/pnpm.cjs'),所以 dist/ 目录必须与 bin/pnpm.cjs 一起就位——第一次只拷了 bin 会报 Cannot find module '../dist/pnpm.cjs'。
第二步:安装依赖
直接 pnpm install 会在 esbuild 的 postinstall 失败:
Error: Unsupported platform: openharmony arm64 LE
根因:项目锁定的 esbuild 0.21.5 的 install.js 不认识 openharmony 平台(解法见第四步的版本升级)。此时用 --ignore-scripts 先完成 1344 个包的安装,再补齐两个被跳过的原生件:
pnpm install --ignore-scripts # 1344 包
electron 的安装脚本同样不识别 openharmony 平台(Electron builds are not available on platform: openharmony),从 npmmirror 的 electron 镜像手动下载 aarch64 包解压进 dist/,并写入 path.txt(electron 的 cli 靠它定位二进制):
cd /tmp
curl -fsSL -o electron.zip \
https://npmmirror.com/mirrors/electron/43.8.0/electron-v43.8.0-linux-arm64.zip
D=<项目>/node_modules/.pnpm/electron@43.8.0/node_modules/electron
mkdir -p "$D/dist" && unzip -q electron.zip -d "$D/dist"
echo -n electron > "$D/path.txt"
依赖就位后先跑类型检查确认基线:
pnpm typecheck # tsc --noEmit(app)+ vue-tsc --noEmit(web),全绿
类型检查全绿证明原有 Electron 代码在编译层天然兼容鸿蒙——这是整条适配链路的信心基础,也决定了后续所有改动都应收敛在构建配置与适配层,而不是去动业务代码。
第三步:平台适配层与 GPU 策略
所有平台差异收敛在 packages/app/src/platform/runtime.ts,不允许业务代码里散落 process.platform 判断。isOhos 有三个来源——Electron-OH 运行时把 process.platform 报成 linux 而不是 ohos(E32),所以还要靠 process.resourcesPath 的路径特征兜底:
export const isOhos =
(process.platform as string) === 'ohos' ||
process.env.OCS_PLATFORM === 'ohos' ||
process.env.OCS_OHOS === '1' ||
process.resourcesPath.includes('resfile/resources');
export const flags = {
skipChromeInit: isOhos || process.env.OCS_SKIP_CHROME_INIT === '1',
skipExtensionIntegrity: isOhos || process.env.OCS_SKIP_EXTENSION_INTEGRITY === '1',
skipAutoLaunch: isOhos || process.env.OCS_SKIP_AUTO_LAUNCH === '1',
skipUpdater: isOhos || process.env.OCS_SKIP_UPDATER === '1',
skipTray: isOhos || process.env.OCS_DISABLE_TRAY === '1',
captureDir: process.env.OCS_CAPTURE_DIR || ''
};
每个 flag 对应一个「鸿蒙无对应能力」的平台事实:内置浏览器下载/解压体系、扩展完整性校验、开机自启静默注册、自更新、托盘,在鸿蒙侧全部短路。
GPU 关闭开关收敛为一个常量数组,在 app ready 之前生效(app.disableHardwareAcceleration() 双保险):
export const GPU_SWITCHES = [
'disable-gpu',
'disable-gpu-sandbox',
'disable-accelerated-video-decode'
] as const;
注意开关集合是实测收敛出来的最小安全集:最初照搬桌面端的 disable-gpu-compositing / disable-gpu-rasterization / disable-software-rasterizer 与 OHOS 合成器路径冲突,运行约 15 秒后 Cpp Crash(OhosCanvasSurface::PresentCanvas window null,E35);去掉这三个、保留三个后稳定 120 秒以上。GPU 开关同时维护在 TS 侧与 HAP 工程 CommandLineAdapter.ets 的 vec_args 里(Electron-OH 形态的参数入口),两处必须同步修改。
第四步:esbuild 升级到 openharmony 官方二进制
esbuild 官方从 0.25.6 起提供 @esbuild/openharmony-arm64 原生二进制,在鸿蒙 PC 上可直接执行。项目锁定的 0.21.5 的 install.js 不认识这个平台:
Error: Unsupported platform: openharmony arm64 LE
at pkgAndSubpathForCurrentPlatform (.../esbuild/install.js:76:11)
在根 package.json 加 override 升级:
// package.json
{
"pnpm": {
"overrides": {
"esbuild": "0.28.2"
}
}
}
pnpm install --ignore-scripts
node_modules/.pnpm/esbuild@0.28.2/node_modules/esbuild/bin/esbuild --version
# 0.28.2 —— 直接执行成功
教训:社区老教程里「手动下载
@esbuild/linux-arm64替换」的路在 OHOS 上走不通——glibc/musl 的 Linux 二进制在这里执行报Permission denied。官方 openharmony 包才是正解。这个发现把之前「本机无法构建」的结论整体推翻了。
第五步:rollup 换 WASM 版(绕开 dlopen 限制)
esbuild 能跑之后,构建卡在 rollup 的原生模块上。rollup 4.63.1 官方自带 @rollup/rollup-openharmony-arm64 包(可选依赖,pnpm 会自动装上),但其 .node 共享库在本域 dlopen 报 Permission denied:
Error: Error loading shared library .../rollup.openharmony-arm64.node: Permission denied
可执行 ELF 能跑、共享库 dlopen 受限——两条通道策略不同。绕法:@rollup/wasm-node 是同一套 rollup API 编译成 WASM 的官方包,纯 JS 加载,完全不走 dlopen:
cd /tmp
curl -fsSL -o rollup-wasm.tgz \
https://registry.npmmirror.com/@rollup/wasm-node/-/wasm-node-4.63.1.tgz
mkdir rollup-wasm && tar -xzf rollup-wasm.tgz -C rollup-wasm
# 用 wasm-node 的 dist 覆盖 rollup 包的 dist(保留 rollup 的 package.json,require('rollup') 解析路径不变)
R=<项目>/node_modules/.pnpm/rollup@4.63.1/node_modules/rollup
rm -rf "$R/dist" && cp -r /tmp/rollup-wasm/package/dist "$R/dist"
node -e "const r=require('rollup'); console.log('ROLLUP_WASM_OK', typeof r.rollup)"
# ROLLUP_WASM_OK function
WASM 在 node 进程内编译执行,不触及动态库加载策略,构建速度与传统原生版没有可感知差异。
第六步:构建目标提到 ES2022
esbuild 0.25 起有一个与版本升级相伴的行为变化:不再向低 target 降级解构语法。vite 默认 target(chrome87/edge88/firefox78/safari14 组合)直接构建失败,报 1268 个错误:
[vite:esbuild-transpile] Transform failed with 1268 errors:
app.js:2088:12: ERROR: Transforming destructuring to the configured target environment
("chrome87", "edge88", "es2020", "firefox78", "safari14" + 2 overrides) is not supported yet
这些 target 本身都支持解构,但 esbuild 0.25+ 的降级器已经移除该能力,触发了硬错误。解法不是回退 esbuild,而是把 target 提到现代水平——ArkWeb 内核是 Chromium 138,完全支持 ES2022:
// packages/web/vite.config.ohos.ts
build: {
// ArkWeb 内核为 Chromium 138,直接面向 ES2022 构建;
// esbuild ≥0.25 不再向老 target 降级解构语法,低 target 会直接构建失败
target: 'es2022',
// ...
}
第七步:全量构建与自包含校验
pnpm build:ohos
# [verify] ✅ 通过:3 个 bundle 文件自包含(合计 3.67 MB)
# [verify] ⚠ 已知豁免 1 处(Phase 2 删除):playwright-core
这一步的背后是构建链的「全量 bundle」模式(packages/app/electron.vite.config.ts 的 OCS_OHOS_BUNDLE=1):HAP 的 resfile 里没有 node_modules,任何外部 require 在设备上直接 Cannot find module。桌面端默认的 externalizeDepsPlugin 全部外部化策略在此废弃,改为显式白名单 + 其余全打包:
// electron.vite.config.ts
const OHOS_EXTERNAL_DEPS = ['electron', 'keytar', 'playwright-core', 'playwright'];
const isOhosExternal = (id: string) => OHOS_EXTERNAL_DEPS.some(d => id === d || id.startsWith(d + '/'));
const ohosExternalPlugin = {
name: 'ocs:ohos-external',
enforce: 'pre',
resolveId(id) {
return isOhosExternal(id) ? { id, external: true } : null;
}
};
注意用
resolveId钩子返回{ id, external: true },而不要写build.rollupOptions.external——electron-vite 内部会覆盖这个字段,配置里写了也不生效(实测踩坑 E9)。
产物自包含由 scripts/verify-ohos-bundle.cjs 校验:用状态机扫描 bundle 区分「代码位置的 require」与「字符串字面量」(ajv 的代码生成模板曾造成 26 处误报,E10),只统计真实外部依赖。
第八步:ArkWeb 单文件渲染产物
ArkWeb 的 Web 组件加载 resource://rawfile 时不执行 ES module(整页白屏,E19),所以 ArkWeb 承载形态要把渲染产物内联成单文件:
pnpm build:ohos:renderer
# [inline] ✅ 单文件写入 ohos_hap/entry/src/main/resources/rawfile/renderer/index.html (5977 KB)
packages/web/vite.config.ohos.ts 的关键配置:
build: {
target: 'es2022',
assetsInlineLimit: 200 * 1024 * 1024, // 图片/字体全部内联
cssCodeSplit: false, // 单文件:不拆分 CSS
rollupOptions: {
input: path.resolve(__dirname, 'index.html'),
output: {
format: 'iife', // 单文件 IIFE
inlineDynamicImports: true, // 动态 import 全部内联
entryFileNames: 'app.js'
}
}
}
scripts/inline-ohos-renderer.cjs 把 app.js 与 style.css 内联进 index.html。内联有个必须处理的坑(E29):内联后 <script> 从 type="module"(延迟执行)变成普通脚本,必须插到 </body> 之前——留在 <head> 会在 #app 挂载前执行,Vue 挂载失败整页白屏。另外 String.replace 的替换串会把 $&/$1 当特殊模式,内联脚本里恰好有这些字符时会把 HTML 写坏,必须用 replacer 函数:html.replace(re, () => replacement)(E30)。
第九步:devecocli 签名
零售鸿蒙 PC 只信任华为根证书,OpenHarmony 测试证书安装时报 code:9568257 fail to verify pkcs7 file(E25)。解法是 devecocli 的 AGC 调试证书 + 绑定本机 UDID 的 profile:
cd ohos_hap
devecocli auth status # Current user: hal****
devecocli signature generate
# Start generating p12 / csr / certificate / profile
# Profile covers 1 device(s): F9E5...48C7 (detected)
# Signing config written to build-profile.json5
签名物料管理:signature generate 会把本机专属配置(绝对路径 + 加密口令)写入 build-profile.json5,不要提交入库——仓库保持 "signingConfigs": [],使用者本地重新执行一次即可;换环境后 hvigor 报 Invalid storeFile value 也是同一根因,清空后重新生成。
第十步:打包、安装、启动与取证
devecocli build
# > hvigor Finished :entry:default@SignHap... after 144 ms
# > hvigor BUILD SUCCESSFUL in 9 s 407 ms
# → entry/build/default/outputs/default/entry-default-signed.hap (6.9 MB)
devecocli run --skip-build
# Auto-selected device: HUAWEI MateBook 14 (127.0.0.1:39207)
# App installed successfully
# Launching cn.enncy.ocs/EntryAbility...
# Application 'cn.enncy.ocs': start ability successfully.
运行取证用 devecocli 的截屏与日志(hdc 独立通道在本域 Connect server failed,devecocli 自带回环传输可用):
devecocli ui screenshot --path .ohos-adapt/ocs-verify.png
devecocli log --bundle-name cn.enncy.ocs --tail 15
# 11-22 11:31:28.175 I A04510/cn.enncy.ocs/chromium:
# [arkweb/chromium_ext/ui/base/clipboard/ohos/clipboard_ohos.cc:160] Inform Clipboard Changed
日志中出现 cn.enncy.ocs/chromium(ArkWeb 内核)即确认渲染进程存活。真机截屏:

六、改动了哪些代码
仓库中原有的 Electron + Vue 业务代码(约 2.8 万行)基本未动,全部适配代码集中在构建配置与平台适配层。下面按文件贴出关键改动。
6.1 平台适配层(packages/app/src/platform/runtime.ts)
// 平台判定:三重来源(运行时平台 / 环境变量 / resourcesPath 特征)
export const isOhos =
(process.platform as string) === 'ohos' ||
process.env.OCS_PLATFORM === 'ohos' ||
process.env.OCS_OHOS === '1' ||
process.resourcesPath.includes('resfile/resources');
// GPU 关闭:单一事实来源,与 CommandLineAdapter.ets 的 vec_args 镜像同步
export const GPU_SWITCHES = [
'disable-gpu',
'disable-gpu-sandbox',
'disable-accelerated-video-decode'
] as const;
export function applyGpuSwitches(app: App): string[] {
for (const sw of GPU_SWITCHES) app.commandLine.appendSwitch(sw);
app.disableHardwareAcceleration(); // Electron 层双保险
return [...GPU_SWITCHES];
}
启动编排(packages/app/index.ts)按 flag 短路各平台能力:
task('初始化自动启动', () => (flags.skipAutoLaunch ? undefined : autoLaunch())),
task('AppImage桌面集成', () => (isOhos ? undefined : integrateAppImageDesktop())),
task('启动渲染进程', async () => {
await app.whenReady();
const window = createWindow();
if (flags.skipChromeInit) console.log('[platform] 跳过内置浏览器初始化(isOhos=' + isOhos + ')');
const relaunched = flags.skipChromeInit ? false : await task('初始化谷歌浏览器', () => initChrome(window));
// ...
});
6.2 构建配置
根 package.json——esbuild 版本 override(openharmony 官方二进制):
"pnpm": {
"overrides": {
"esbuild": "0.28.2"
}
}
packages/web/vite.config.ohos.ts——ArkWeb 单文件产物配置(完整见第八步):
build: {
target: 'es2022', // ArkWeb = Chromium 138
assetsInlineLimit: 200 * 1024 * 1024, // 资源全部内联
cssCodeSplit: false,
rollupOptions: {
output: {
format: 'iife',
inlineDynamicImports: true,
entryFileNames: 'app.js'
}
}
}
packages/app/electron.vite.config.ts——鸿蒙模式全量 bundle(白名单外全部打包,见第七步)。
6.3 ArkWeb 承载页(ohos_hap/entry/src/main/ets/pages/Index.ets)
// SELF_CONTAINED=true 时加载 rawfile 内联单文件;false 为开发调试模式(宿主机 HTTP + hdc rport)
Web({ src: SELF_CONTAINED ? $rawfile('renderer/index.html') : RENDERER_URL, controller: this.controller })
.onControllerAttached(() => {
// rawfile 没有 URL hash 可传,首屏路由由 runJavaScript 注入
this.controller.runJavaScript(`location.hash='${INITIAL_ROUTE}';`);
})
.javaScriptAccess(true)
.domStorageAccess(true)
.width('100%')
.height('100%')
6.4 Electron-OH 命令行参数(ohos_hap/web_engine/.../CommandLineAdapter.ets)
static buildDefaultArgs(): string[] {
const vec_args: string[] = [
'--disable-gpu',
'--disable-gpu-sandbox',
'--disable-accelerated-video-decode'
];
return vec_args;
}
Electron-OH 的启动参数以此处为唯一可靠入口(JS 侧 app.commandLine.appendSwitch 是否生效待验证),所以这个文件与 runtime.ts 的 GPU_SWITCHES 构成镜像关系,改一处必须同步另一处。
七、迁移能力(T0 / T1 / T2)
适配情况按 T0 基础能力(能不能编、能不能装、能不能起、能不能渲染)、T1 主要能力(软件的日常核心)、T2 增强能力(桌面端加分项)三档如实标注。
状态分三种:能用(真机实际操作过并有可复核证据)、待验证(已实现但缺真机实测)、未适配(当前阶段未实现,属明确的下一步工作项)。
T0 基础能力(能不能编、能不能装、能不能起、能不能渲染)
| 能力 | 状态 | 依据 |
|---|---|---|
| 鸿蒙 PC 本机构建 | 能用 | esbuild 0.28.2 openharmony 二进制 + rollup WASM,build:ohos 自包含校验通过 |
| 全量 bundle 自包含 | 能用 | verify-ohos-bundle 0 处外部 require(3 个 bundle 合计 3.67 MB) |
| 依赖安装与类型检查 | 能用 | 1344 包安装成功;tsc / vue-tsc 全绿 |
| HAP 打包与签名 | 能用 | hvigor BUILD SUCCESSFUL + devecocli AGC 调试证书,SignHap 成功 |
| 真机安装与启动 | 能用 | App installed successfully + start ability successfully(本机回环 127.0.0.1) |
| ArkWeb 界面加载与渲染 | 能用 | 浏览器列表 / 设置 / 用户脚本三路由真机渲染(截图取证) |
| 离线自包含运行 | 能用 | rawfile 单文件 5.8 MB,无宿主机依赖 |
T1 主要能力(软件的日常核心)
| 能力 | 状态 | 依据 |
|---|---|---|
| Electron-OH 运行时(真实 Electron 窗口 + IPC) | 能用 | Electron 37.2.4 / Chromium 138 / Node 22.17 真机验证,require 与 ipcRenderer.invoke/sendSync 均可用(适配日志第 16 章) |
| 本地 Express 服务(:15319) | 能用 | Electron-OH 主进程 Node http 真机监听 |
| 配置持久化(electron-store + 加密) | 能用 | safeStorage 同步 API 兼容层(E33)落地,明文键文件降级可用 |
| 浏览器分身(persist 分区 + CDP) | 待验证 | 分身隔离 + CDP 六件套桌面端自测 12/12 通过;Electron-OH 真机复验待做 |
| GPU 关闭(最小安全集) | 能用 | E35 修复后连续存活 120s+,gpu-status.json 如实上报 |
T2 增强能力(桌面端的加分项)
| 能力 | 状态 | 依据 |
|---|---|---|
| Playwright 自动化脚本(6 个内置) | 未适配 | 切换到 PageLike 契约的代码已就位(platform/browser/*),真机复验未做 |
| 自研用户脚本运行时(@match + GM_*) | 未适配 | Phase 3 工作项,替代 Tampermonkey/ScriptCat |
| 上架级签名 | 未适配 | 当前为 debug 侧载,需 AGC 正式证书 + Profile |
| 手机形态(phone) | 未适配 | deviceTypes 目前 2in1/tablet |
八、与原版差异(如实说明)
- ArkWeb 承载形态没有
window.electron:渲染层走inBrowser分支,IPC / 文件 / 分身 / 自动化在该形态不可用;完整能力走 Electron-OH 形态(libelectron.so运行时,需从华为 DevCloud 获取); - GPU 关闭为最小安全集:
disable-gpu-compositing/rasterization/software-rasterizer与 OHOS 合成器冲突会 Cpp Crash(E35),TS 与 ets 两侧必须同步; - 原生模块不可交叉编译:keytar 走 try/catch 降级(safeStorage 同步 API → 明文键文件,E33),
npmRebuild: false; - 没有隐藏不兼容:所有已知差异(GPU 策略、签名方式、dlopen 限制、esbuild 行为变化)均在适配日志中如实记录,未适配的能力是明确的下一步工作项,而不是「宣称已迁移」。
一句话总结:ohos_ocs-desktop 已在鸿蒙 PC 本机完成「依赖安装 → 全量构建 → 打包 → AGC 签名 → 安装 → 启动 → 渲染取证」全链路验证,ArkWeb 承载形态与 Electron-OH 形态(含 IPC)均在真机确认可用;分身自动化真机复验、自研用户脚本运行时与上架签名是明确的下一步工作项。
更多推荐
所有评论(0)