应用联调
联调环境
可根据实际需要选择以下任一种联调环境
windows端
1)下载安装包
UAT应用联调,请下载指定版本:下载地址
防止wps升级,请在host里面新增2个域名配置:
1.1.1.1 update.wps.cn
127.0.0.1 updatepro.wps.cn
正式应用验收可使用上述指定版本或下载官网最新版本
2)调试工具
WPS中内嵌浏览器默认禁用控制台,前端可通过工具:https://kdocs.cn/l/cgAF4b547Ynp,在WPS中打开网页控制台(DevTool),打开开关后,重启WPS客户端,在页面中点击任意空白处按下Ctrl+F8打开控制台,笔记本不生效尝试Ctrl+Fn+F8。
(需要帐号加入到WPS365 ISV生态企业才能下载,加入到企业可以联系@彭文勋 )
![]() | ![]() |
|---|---|
| 工具开关 | DevTool界面 |
3)打开调试入口
请参考 WPS内联调- 开发版本(测试)
WEB浏览器端
- 方式一:PC浏览器应用市场灰度调试地址
https://co.wps.cn/workbench/?for_gray=1#/team/
提供对应的测试企业id给WPS方加入灰名单,访问灰度链接进行调试
- 方式二:在浏览器输入应用主页地址进行测试(该地址需要具备触发用户授权能力)
PC web浏览器应用市场正式地址(支持mac、linux、win等系统浏览器)
https://co.wps.cn/workbench/?vcl=v2#/team/
Mac端
WPS版本未提供企业应用市场及测试入口,如需测试,在浏览器输入应用首页地址进行测试。
WPS内联调
ISV 应用需在WPS应用中心进行应用的测试、上架操作,WPS登录账号与WPS开放平台一致。ISV可在平台左上角选择需要测试或正式上架的应用。

发布wps端内应用版本
选择应用:选择需要测试或上架的应用
开发版本:创建开发版本,填入测试首页链接
审核版本:创建待审核的版本【首次发布后,后期没有改首页地址就不用再申请发布】
上架管理:提交审核版本,由WPS审批
线上版本:显示已审批通过的应用版本

开发版本(测试)
- 登录wps应用中心(需应用开发者角色,设置方法参考配置成员权限),选择应用需要测试的应用,打开其【调试应用】开关

- 创建测试版本,填入应用首页地址
填写完测试链接后就能在客户端开始联调了,如果地址不在客户端灰名单内(下图“WPS Office客户端域名灰名单”),会使用系统默认浏览器打开测试链接,这种调试模式是没有问题的。

![]() |
|---|
| WPS Office客户端域名灰名单 |
- 开启【开发者应用】入口
注意事项:
此方式应用测试人员必须是应用开发企业的本企业成员,使用的按照企业也是本企业,无法使用外部企业进行测试
操作步骤:打开WPS并登录(登录账号与WPS开放平台一致),应用测试人员在WPS应用市场中连续点击10次 右上角【我的应用】,启动开发者模式后,即可看见开发者应用入口。
具备的能力(需要企业普通管理员或超管角色操作):
安装/进入应用
卸载应用,企业卸载后再次打开应用时,可重新触发获取应用流程,卸载应用目前仅为联调方便,未对用户侧开放,卸载操作不会清空已产生的应用/订单数据。
更新应用,每次更新都会推送一次应用授权事件
![]() | ![]() | ![]() | ![]() |
|---|---|---|---|
| WPS应用市场入口 | WPS应用市场 | 开启开发者应用模式 | 开发者应用入口 |
提交审核版本
注意:首次发布后,后期没有改首页地址就不用再申请发布
提交期望上架的版本,其中jssdk版本可以选2.3版本,WPS官方审批通过可在【线上版本】面板中看到对应版本信息。
![]() |
|---|
| 提交审核版本 |
联调场景
应用在首次打开时会触发【获取应用】动作,安装过程会触发【应用安装变更】等事件。【通讯录权限范围变更】、【ISV应用付费购买】事件可通过应用详情界面进行设置。下列是各关键事件触发的时机。
| 事件 | 触发场景 | 相关场景截图 |
应用授权变更 topic: kso.developer.application.authorization.status |
|
|
应用安装变更 Topic:kso.app_store.application.installation 目前也使用该事件承载 |
|
|
通讯录权限范围变更事件 Topic: kso.contact.permission_setting |
|
|
应用付费购买 Topic:kso.store.app.order |
|
|












