WPSJS加载项在线模式和离线模式

1、模式介绍

WPS加载项分为在线模式和离线模式，两个模式同时只能启用一个。离线模式是在加载项项目运行前，将其下载到本地进行运行，在线模式一直在去请求服务器上的代码和页面

通俗解释：

打开浏览器，进入任何一个页面，ctrl+s保存网页。

直接在浏览器中打开的那个网页就叫做在线模式。

运行保存到本地的那个网页，就叫做离线模式。

2、模式详情

2.1、在线模式

在线模式是JSAPI的加载项部署在服务器上面，提供给WPS一个下载地址，WPS在打开的时候动态下载该加载项，并显示到WPS界面。

标签：jspluginonline 访问方式：实时在线访问 具体实现：

name:加载项的名称，启动时需将名称传递正确 type:加载项的类型 url：加载项的网络访问地址，指向加载项的根目录，需要保证 url下ribbon.xml和url下index.html能够访问

优点：适合通过服务器分发的形式，企业私有化部署方案，比如企业内部使用的中心化的服务器，安装WPS的时候配置好加载路径，然后统一从中心服务器下载。加载比较平滑，用户首次加载或版本更新后的用户初次访问时间会比离线模式高，且每次都是使用最新的代码。 缺点：每次执行时，都是去请求服务器上的资源，执行速度慢一些，因为要等到加载项下载完成才能显示，比较浪费网络资源，并且网络不好时，不能访问。 总结：在线模式适合在资源频繁改动，且网络稳定的情况下使用（项目开发阶段）

2.2、离线模式

严格意义来说这种部署属于Publish模式，需要使用wpsjs build命令将WPS打包然后部署。基本介绍如下：

标签：jsplugin 访问方式：将对应的版本号压缩文件下载到本地，加载项加载时，访问本地加载项项目 具体实现：

name:加载项的名称，启动时需将名称传递正确 type:加载项的类型 url:加载项的压缩包下载地址，需要保证包的压缩后缀为.7z，且该url能在浏览器中打开并下载压缩包。 version:包的版本，加载时，jsaddons是否有name+_+version 文件夹,如果有，则使用本地包来执行加载项项目，如果没有，则会去网络上请求新的包，如果网络上下载下来的包解压出来后也和name+_+version 不相等，则不使用加载项 windows

cd ~/.local/share/Kingsoft/wps/jsaddons文件

win + r

输入%appdata% 回车

查看kingsoftwpsjsaddons文件夹,

Linux

cd ~/.local/share/Kingsoft/wps/jsaddons文件

优点：只要name_version等于加载项文件夹的名字，加载项就不会去更新加载项的包，采用本地的加载项包资源，大大的节省网络资源和用户的时间。 缺点：初次加载或版本变更时，都会先去下载整个加载项包，并解压，会比较耗费时间 总结：离线模式适合资源改动不频繁的情况（项目发布阶段）

2.3、特殊离线模式

这种模式是针对电脑不联网的情况下（包括内网），希望能够直接发送插件包给到用户，用户安装即可访问。这种模式是WPS会从固定的目录下面读取JS的加载项，一般是%appdata%kingsoftwpsjsaddons目录，属于单机模式，比如小型的企业，用户数量较少，没有中心服务器，可以单机部署到每个用户的电脑上面使用即可。

该模式和离线模式原理是差不多的，步骤如下：

1、配置oem.ini（jsplugins.xml模式）或者publish.xml（publish模式）,都需要配置为离线模式

2、将离线包发送给客户，将代码包复制到jsaddons目录下，并解压

windows

win + r

输入%appdata% 回车

查看kingsoftwpsjsaddons文件夹,

Linux

cd ~/.local/share/Kingsoft/wps/jsaddons文件