local-sdk-api-map.md 2.3 KB
本地 SDK API 权威映射（SDK 26.0.0，2026-08-23 验证）
SDK 根目录：~/Library/OpenHarmony/Sdk/26.0.0/（本机另有 20、23 两个旧版本） API 定义目录：ets/api/（ArkTS 应用面）与 js/api/（同名双份） 工程 targetSdkVersion：26.0.0（DSHohos/build-profile.json5，runtimeOS: HarmonyOS）
协议适配层所需 API（全部存在，已验证）
| API | d.ts 文件 | 用途 |
|---|---|---|
| HTTP | @ohos.net.http.d.ts | Typert RPC 一元调用（POST /api） |
| WebSocket | @ohos.net.webSocket.d.ts（注意大写 S） | 两条下行事件流 events.mux / events.host |
| TCP Socket | @ohos.net.socket.d.ts | 备用 |
UI / 平台能力 API（全部存在，已验证）
| API | d.ts 文件 | 用途 |
|---|---|---|
| UIAbility | @ohos.app.ability.UIAbility.d.ts | 应用入口、生命周期 |
| 窗口管理 | @ohos.window.d.ts | 多窗口、自由窗口、窗口状态 |
| Web 组件 | @ohos.web.webview.d.ts | WebView 逃生舱（兼容模式） |
| 文件选择 | @ohos.file.picker.d.ts | 附件选择、目录选择（FSPicker） |
| KV 偏好 | @ohos.data.preferences.d.ts | 设置存储 |
| 关系数据库 | @ohos.data.relationalStore.d.ts | 会话索引缓存 |
| 通知 | @ohos.notificationManager.d.ts | 升级完成/审批等待/任务完成通知 |
| 安全存储 | @ohos.security.asset.d.ts | API Key 凭据加密（Asset Store） |
关键结论（重要）
子进程能力（开发方案 R1 风险项，2026-08-23 判定进展）
@ohos.app.ability.childProcessManager.d.ts（@since 11，PC/二合一/平板可用）源码阅读结论：
- 仅支持启动 ArkTS 源码子进程（srcEntry 为 .ets 文件，继承 ChildProcess 类实现 onStart）
- 子进程仅支持同步 ArkTS API，不支持异步调用；onStart 执行完即销毁；父进程退出子进程随之退出
- 不能拉起任意二进制（如 node）——开发方案 3.2 节的 In-App Spawn 路线基本被否定，双轨托管（Attach + Guided Service）确认为主路线
- 后续 M0 仅需再验证：hnp 终端常驻服务的自启方式（用户侧），无需再验证 App 内 spawn
使用方法
- 查 API 签名：grep -A 20 declare 目标d.ts
- 查权限要求：grep -B 2 -A 5 permission 目标d.ts
- 注意 d.ts 中的 @since 标注，确认 API 在目标版本可用