【鸿蒙二开】WPS 上线前检查清单

鸿蒙工程接 WPS Open SDK 时，Demo 能打开文档不等于可以发版。上线前建议按「身份 → 注册 → 打开 → 回传」四层勾选，避免包名与凭据不一致、未注册就 sendRequest、默认只读被当成可编辑、关窗回传未拷贝沙箱等问题在现网爆发。下面给一版社区向短清单，方便对照联调。

身份与版本

邮件申请发 m_open_sdk@wps.cn：写清 Bundle、专业版 / 个人版、用途。激活序列号走商务 / 技术支持，与 SDK 凭据不是同一渠道。HAR 与凭据必须同批、同版本，不可混用。调试包与正式包包名不同要分别申请或写清以哪套为准。

注册门禁

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
  },
});

未注册成功就打开，Promise 会抛异常——和「打开返回非 OK」不是一类问题。启动只注册一次；打开按钮绑就绪态。

打开与回传

• 系统选择器路径先拷进应用沙箱再给 OpenFileRequest。

• 编辑验收必须 enableEdit = true（未设 / false = 只读）。

• 需要关窗上传：设 wpsTransferType，并把 fileUri / FD 拷贝到本应用沙箱后再当业务路径。

• sendRequest 要同时处理非 OK 与 catch。

• 真机安装匹配版本的 WPS 客户端。

失败怎么拆

发布勾选与小结

发版前建议阻塞：身份归档一致；注册成功日志；门禁生效；编辑 / 回传验收通过；密钥脱敏；目标机端到端打开。专业版若不落地，确认分享 / 打印等被覆盖关闭是否符合产品说明。调试包与正式包包名不同时，邮件里务必写清，否则最容易出现「本地偶发 1013」。

建议把就绪态做成全局标志，打开按钮绑定该标志；失败时把 code / msg 打到可复制日志。样例文档先入沙箱再给 OpenFileRequest。注册模块不要夹带水印、回传等高级配置，先保证 ResultCode.OK，再逐项叠加。现场可准备一键导出 Bundle、HAR、注册结果、最近打开 code、客户端版本，方便远程协助。

鸿蒙 WPS 二开上线检查的核心是：registerApp 门禁清楚，参数对齐验收，回传真正落盘。把清单贴进评审，比发版后热修鉴权便宜得多。后续编辑、水印、关窗回传都可以按专题继续聊，但都应建立在注册成功之后；真机先确认客户端能独立打开同类文档，再看 SDK 日志，排障会快很多。发版前再核对一次 HAR 与 Bundle，能少很多现网噪音。