鸿蒙适配开源地址: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
Nodehmos-clt 自带 v24.18.1不要用系统 /data/service/hnp/bin/node(V8 崩溃,见 E39)
Node.js / pnpm(构建 JS 侧)Node ≥ 22 / pnpm ≥ 10pnpm 从 npmmirror 手动部署(见第五步第二步)
签名devecocli(已登录华为开发者账号)AGC 调试证书 + 本机 UDID profile
SDK 版本compatibleSdkVersion 6.1.0(23) / targetSdkVersion 6.1.1(24)对齐真机
设备类型2in1 / tabletphone 未验证

四、编译与运行

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)均在真机确认可用;分身自动化真机复验、自研用户脚本运行时与上架签名是明确的下一步工作项。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐