Skip to content

应用联调

联调环境

可根据实际需要选择以下任一种联调环境

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生态企业才能下载,加入到企业可以联系@彭文勋 )

2VQVGBIA3QPS3GGBIA7M
工具开关DevTool界面

3)打开调试入口

请参考 WPS内联调- 开发版本(测试)

WEB浏览器端

  1. 方式一:PC浏览器应用市场灰度调试地址

https://co.wps.cn/workbench/?for_gray=1#/team/

提供对应的测试企业id给WPS方加入灰名单,访问灰度链接进行调试

  1. 方式二:在浏览器输入应用主页地址进行测试(该地址需要具备触发用户授权能力)

PC web浏览器应用市场正式地址(支持mac、linux、win等系统浏览器)

https://co.wps.cn/workbench/?vcl=v2#/team/

Mac端

WPS版本未提供企业应用市场及测试入口,如需测试,在浏览器输入应用首页地址进行测试。

WPS内联调

ISV 应用需在WPS应用中心进行应用的测试、上架操作,WPS登录账号与WPS开放平台一致。ISV可在平台左上角选择需要测试或正式上架的应用。

SS2VIBIAGY

发布wps端内应用版本

  1. 选择应用:选择需要测试或上架的应用

  2. 开发版本:创建开发版本,填入测试首页链接

  3. 审核版本:创建待审核的版本【首次发布后,后期没有改首页地址就不用再申请发布

  4. 上架管理:提交审核版本,由WPS审批

  5. 线上版本:显示已审批通过的应用版本

3HBGKBIASU

开发版本(测试)

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

SS2VIBIA7E

  1. 创建测试版本,填入应用首页地址

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

SW2VIBIAU4

PYFJ5BA5AAAGU
WPS Office客户端域名灰名单
  1. 开启【开发者应用】入口

注意事项:

此方式应用测试人员必须是应用开发企业的本企业成员,使用的按照企业也是本企业,无法使用外部企业进行测试

  • 操作步骤:打开WPS并登录(登录账号与WPS开放平台一致),应用测试人员在WPS应用市场中连续点击10次 右上角【我的应用】,启动开发者模式后,即可看见开发者应用入口。

  • 具备的能力(需要企业普通管理员或超管角色操作):

    • 安装/进入应用

    • 卸载应用,企业卸载后再次打开应用时,可重新触发获取应用流程,卸载应用目前仅为联调方便,未对用户侧开放,卸载操作不会清空已产生的应用/订单数据。

    • 更新应用,每次更新都会推送一次应用授权事件

CW4WGBIAK44GKD4BIAAQ4GKD4BIAFIJQ2FWBIAGA
WPS应用市场入口WPS应用市场开启开发者应用模式开发者应用入口

提交审核版本

注意:首次发布后,后期没有改首页地址就不用再申请发布

提交期望上架的版本,其中jssdk版本可以选2.3版本,WPS官方审批通过可在【线上版本】面板中看到对应版本信息。

SW2VIBIAZA
提交审核版本

联调场景

应用在首次打开时会触发【获取应用】动作,安装过程会触发【应用安装变更】等事件。【通讯录权限范围变更】、【ISV应用付费购买】事件可通过应用详情界面进行设置。下列是各关键事件触发的时机。

事件触发场景相关场景截图

应用授权变更

topic:

kso.developer.application.authorization.status

  1. 365应用市场应用安装或更新时

  2. 管理员在企业管理后台针对成员授权模式应用进行主动授权时

  • WPS365应用市场应用安装入口

UKZGIBIADA

  • 开发者应用入口【更新】

DTDWIBIAEY

应用安装变更

Topic:kso.app_store.application.installation

目前也使用该事件承载

  1. 365应用市场应用首次安装时

  2. 企业管理后台应用的启用/禁用

  3. 客户端入口我的开发者应用入口的

  4. 卸载功能(用于开发联调用)

  • WPS365应用市场应用安装入口

XKZGIBIASM

  • 开发者应用入口【更新】

EHDWIBIALI

D6ZWIBIAFM

通讯录权限范围变更事件

Topic:

kso.contact.permission_setting

  1. 365应用市场应用首次安装时

  2. 企业管理后台通讯录权限范围变更时

  3. 推送通讯录权限范围变更事件,再通过获取通讯录权限范围接口获取可租户应用有权限获取的企业组织架构数据信息。

  1. 设置入口地址,需要是普通企业管理员才有该入口访问权限

HVCMHPBBABQAK

应用付费购买

Topic:kso.store.app.order

  1. 365应用市场应用首次安装时,推送试用类型订单事件

  2. 企业管理后台的发生的应用购买

  3. 应用内发生的应用购买

  1. 设置入口地址,需要是普通企业管理员才能访问

MOZWIBIA3I