registerCapacitorSpaShell

业务 SPA 接入 Capacitor 通用壳：系统返回键、Web OTA、Android 整包更新。插件与 UI 由调用方注入。

函数签名

function registerCapacitorSpaShell(
  input: RegisterCapacitorSpaShellInput,
): CapacitorSpaShellControllers

前置依赖

参数名	类型	说明
ui.showMessage / showConfirm / showApiError	函数	业务 UI（通常来自 @zengchaowu/vue-ui）
ui.handleNativeBackPress	函数	通常 handleCwNativeBackPress
native.*	Capacitor 适配	App / Filesystem / FileOpener / ZcwWebOta
apkUpdate	distribute 或 manifest	整包检查策略

返回值

字段	说明
runAndroidApkUpdateCheck	手动检查整包
runWebOtaUpdateCheck	手动检查 Web OTA

工作原理

1. 注册硬件返回键，根页 minimizeApp。
2. 若注入 webOta，启动时延迟检查 OTA 清单。
3. apkUpdate.kind === 'distribute' 走公开分发 API；manifest 走 COS 清单。
4. Vite live reload 端口（viteDevPorts）跳过启动自动更新。