【鸿蒙二开】WPS Open SDK 能力周回顾

鸿蒙工程接 WPS Open SDK 时，Demo 能打开文档之后，能力点容易散落在注册门禁、Token、编辑、回传和错误码几处。联调效率取决于会不会按同一调用链自查，以及提问时能不能带齐可核对材料。这篇按社区交流帖写法，把一周高频项压成清单，方便直接对照。

调用链先钉死

申请 HAR/凭据 → registerApp →（ToB）setWpsFileToken → OpenFileRequest + sendRequest → 可选回传落盘。

官方文档：https://365.kdocs.cn/l/clQl5cek2NoT

最小代码

WPSApi.registerApp(APP_KEY, APP_SECRET, {
  onCallback: (r) => {
    if (r.code !== ResultCode.OK) {
      console.error(r.code, r.msg);
      return;
    }
    if (!SdkConstants.isPersonalSdk()) {
      WPSApi.setWpsFileToken(PRO_SN);
    }
    // ready 后再 sendRequest
  },
});

打开侧：

const req = new OpenFileRequest(ctx, sandboxPath);
req.enableEdit = true; // 需要编辑时显式设置
// 不要写 req.wpsToken
await WPSApi.sendRequest(req);

未注册成功就打开会抛异常——和「打开返回非 OK」分开记日志。系统选择器路径先拷贝到应用沙箱。

周回归别漏

1. 冷启动注册 OK

2. 沙箱样例可打开

3. 只读 / 可编辑各一次

4. ToB 确认已 setWpsFileToken；全仓搜掉 request.wpsToken

5. 回传开启时完成 URI/FD 落盘

6. 1013 先查身份再改业务参数

调试包与正式包 Bundle 不同，必须分开申请或明确以哪套为准。限时凭据过期走官方渠道续期。能力叠加顺序建议：注册成功 → 只读打开 → 可编辑 → 水印/extraOptions → 回传；不要在注册失败时优先调高级参数。周回顾时把「本周已验收」和「下周计划叠加」写成两列，避免口头说「都试过了」却对不上日志。真机至少保留一次冷启动注册成功记录；出现 1013 时把 Bundle 打印值与申请单并排贴出。路径类问题同时附拷贝前后 URI，确认 OpenFileRequest 收到应用可访问路径。全仓搜索 wpsToken，清掉 Request 上的旧写法。

提问请带

Bundle、HAR 交付日、ToB/ToC、registerApp 的 code/msg、sendRequest 结果或异常、是否已设 Token。邮箱：m_open_sdk@wps.cn。完整 secret 不要发群里。材料齐了再进交流渠道，比只说「打不开」高效。

小结

统一版是一套 API 覆盖专业版与个人版交付；周回顾重点是工程纪律：身份对齐、注册门禁、Token 全局化、参数显式、回传落盘。把清单贴进评审，比发版后追日志便宜。社区里遇到偶发 1013，优先对齐 Bundle 与申请材料；能注册不能打开时先查就绪态与沙箱路径。把本周 HAR 文件名和一次成功日志一并贴出，远程协助会快很多。下周若要加深编辑或回传，仍应建立在稳定 ResultCode.OK 之上。把对接文档链接固定到群公告或 Wiki，减少过期副本。