所有问题排查都是基于加载项目录结构没有问题的情况下进行排查的,必须确保ribbon.xml和index.html在项目根目录下,且index.html中引入的js的路径没有问题。
排查首先开启调试器:
1. oem.ini地址
windows
安装路径\WPS Offlce\一串数字(版本号)\offlce6\cfgs\
linux
/opt/kingsoft/wps-office/office6/cfgs/
uos
/opt/apps/cn.wps.wps-office-pro/files/kingsoft/wps-office/office6/cfgs/
2. 国产机修改之后,需要重启WPS
普通Linux
终端执行 quickstartoffice restart
uos
终端执行
cd /opt/apps/cn.wps.wps-office-pro/files/bin
./quickstartoffice restart
1、排查问题导航
1.1 无法唤起WPS客户端:排查 version或runParams接口报错
1.2 WPS打开了,但是文档未打开,分两种情况(确保oem.ini中Support栏下配置了JsApiShowWebDebugger=true)
1.2.1 WPS中点击新建,alt+f12能打开调试工具
不能:排查publish模式或者jsplugins.xml模式(第四条或第五条)
能:排查加载项正常,但是未打开文档(第六条)
1.3 WPS打开后,提示 xxx is not undefined
2、version或runParams接口报错
2.1、查看58890端口是否有访问
- 先排查网络策略,是否有开启网络代理,并代理了http:127.0.0.1,如果有,则取消代理
- 在浏览器地址栏中访问http://127.0.0.1:58890/version接口(如果端口通了,则会返回1.0.0或者1.0.1)
- 如果无法访问,则清除浏览器缓存
- (火狐浏览器较特殊,勾选为总是询问)
- 在浏览器的f12中执行
- window.location.href = "ksoWPSCloudSvr://start