WPS 鸿蒙二开：版本与凭据 FAQ

社区同事接入 WPS Open SDK 鸿蒙版时，问题常卡在版本配对、邮件申请要写哪些字段、注册与序列号谁先谁后，以及为什么出现 1013 或只能预览不能编辑。下文按 FAQ 速查整理，方便大家对照联调。细节以官方对接文档为准。

版本关系一句话

统一版 = 专业版能力保留 + 新增个人版支持。申请 HAR/凭据时仍要标明 ToB 或 ToC；API 统一，Token 与不落地行为不同。

用 SdkConstants.isPersonalSdk() 判断，勿猜包名。业务页不要复制两套打开函数，差异收在 prepare。

申请邮件写什么

发至 m_open_sdk@wps.cn：应用名、Bundle 包名、版本类型、联系人、用途。包名变更须重申。专业版激活序列号另找商务/技术支持，与 SDK 凭据渠道不同。调试包与正式包包名不同时，凭据分开归档，避免「本地绿、上架红」。

推荐五步

1. 集成对应 HAR

2. 启动 registerApp，处理 1013

3. 专业版：OK 后 setWpsFileToken

4. 文件入沙箱 → enableEdit = true 打开

5. 再叠回传 / 水印 / extraOptions

const r = await WPSApi.sendRequest(
  new RegisterAppRequest(ctx, APP_KEY, APP_SECRET)
);
if (r.code === ResultCode.OK && !SdkConstants.isPersonalSdk()) {
  WPSApi.setWpsFileToken(PRO_SN);
}

每步只改一类行为。未注册完成就 sendRequest 会进 catch，不能只看 result.code。

高频坑

换 HAR 后 clean。密钥勿进公开仓。开了关闭回传时，UI 提示「请关闭文档」，避免被当成卡死。回传 URI 须拷贝到本应用沙箱后再给业务。

小结

FAQ 核心是版本配对 + 包名绑定 + 注册时序。业务代码可共用，分叉收在 prepare。欢迎补充各机型 1013 与包名案例。

接入评审确认 HAR、包名、是否需要序列号。周五正式包复测注册与可编辑打开。UI 勿在未就绪时开放打开按钮。把对照表贴进联调页，新人会对得更快。联调反馈请带上 flavor、是否已设 Token、code/msg，定位会快很多。

同一工程若打多渠道包，提前在申请表列全 Bundle 名，避免上架前才发现缺凭据。业务代码保持一条打开路径，版本差异只留在 prepare。欢迎补充真机上包名后缀与 1013 的对应案例，便于对齐验收口径。

打开按钮在注册完成前保持禁用；日志区分「注册失败」与「打开失败」两个事件。回传验收与仅打开验收分开写用例，勿把 data 空当成失败。把这三句话贴进联调页：申请写清版本、注册完成再打开、只读默认要显式改。换 HAR 后记得 clean 再测。