WPS加载项部署运行问题排查方法

本文档详述了WPS加载项部署过程中的问题排查方法,包括version或runParams接口错误、文件权限、Publish模式、jsplugins.xml模式等。提供了Windows、Linux和国产机的解决方案,涉及端口访问、自定义浏览器协议、权限设置、版本支持等多个方面。在遇到WPS加载项无法正常运行或文档无法打开时,可按照文中步骤进行排查。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

        所有问题排查都是基于加载项目录结构没有问题的情况下进行排查的,必须确保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
评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值