WPS加载项介绍

1. WPS加载项是什么？

       WPS 加载项是一套基于 Web 技术用来扩展 WPS 应用程序的解决方案。每个 WPS 加载项都对应打开了一个网页，并通过调用网页中 JavaScript 方法来完成其功能逻辑。 WPS 加载项打开的网页可以直接与 WPS 应用程序进行交互，同时一个 WPS 加载项中的多个网页形成了一个整体， 相互之间可以进行数据共享。 开发者不必关注浏览器兼容的问题，因为 WPS 加载项的底层是以 Chromium 开源浏览器项目为基础进行的优化扩展。 WPS 加载项具备快速开发、轻量化、跨平台的特性，目前已针对Windows/Linux *** 作系统进行适配。 WPS 加载项功能特点如下:

1）完整的功能。可通过多种不同的方法对文档、电子表格和演示文稿进行创作、格式设置和 *** 控；通过鼠标、键盘执行的 *** 作几乎都能通过WPS 加载项 完成；可以轻松地执行重复任务，实现自动化。

2）三种交互方式。自定义功能区，采用公开的CustomUI标准，快速组织所有功能；任务窗格，展示网页，内容更丰富；Web 对话框，结合事件监听，实现自由交互。

3）标准化集成。不影响 JavaScript 语言特性，网页运行效果和在浏览器中完全一致；WPS 加载项开发文档完整，接口设计符合 JavaScript 语法规范，避免不必要的学习成本，缩短开发周期。

2. WPS加载项推出背景

        近些年来，随着 h5 及 nodejs 相关技术的繁荣，前端开发生态圈空前繁荣，前端开发涌现出了大量工程化的开发方法、框架及工具链，这些开发工具和方案使前端开发的生产力大大提高。web 技术由于其跨平台、轻量化、丰富的界面表现能力等特点，让其成为开发小程序应用的不二选择，业内流行的小程序应用开发方案，如微信小程序，都是以 web 技术作为首选开发方案。

        wps 桌面版是一个传统的典型的庞大的桌面应用程序，它有着标准的 office 的二次开发接口，在 win 平台上，一般是以 com/vsto 等技术方案来对 wps 进行插件开发。如果能把这些接口进行改造，以 web 技术来给 wps 进行插件开发，将会大大提高开发 wps 插件的生产力。

3. WPS加载项集成优势

        在传统的 com/vsto 的 office 插件开发中，插件的代码健壮性是对 wps 客户端本身稳定性有决定性影响的因素之一，因为在这种传统的技术方案中，这些插件模块是在 wps 进程内运行的，这样带来的问题是，只要插件中存在引起程序 crash的代码，势必会直接引起 wps 客户端本身的 crash, 目前是当 wps 发现某个插件运行崩溃后，即主动把该插件加入黑名单，待下一次进程启动时，主动询问用户是否要加载此插件来解决此问题。jsapi 的执行模型解决了这个问题，jsapi 运行在 wps 主进程外，虽然会带来 ipc 的时间开销，但有效的避免了第三方代码的健壮性问题。在一次 js 任务的执行过程中，如果 js 执行线程崩溃，wps 主线程完全可以检测到这种异常，从而从异常的状态中恢复过来，放弃这一次 js 任务的执行，转向其它的 js 任务，或者去处理新的主线程消息队列中的消息。

4. WPS 加载项的三种交互方式

自定义菜单

        自定义功能区采用通用的 CustomUI 标准进行配置， 该标准定义了一整套标准的控件，比如按钮、下拉菜单、组合框；能够对控件的标签、图标、点击事件等属性进行配置。下面通过一个示例进行详细说明。

 

自定义任务窗格

        WPS 加载项的任务窗格是一个用来浏览网页的用户界面面板，通常停靠在 WPS 应用程序主窗口的一侧，开发者可以控制任务窗格停靠的位置及宽高。 但重要的是任务窗格中的这个网页可以和 WPS 直接完成交互，开发者可以提取 WPS 文档中的数据在网页中集中显示，也可以通过网页交互将数据直接写进文档。

自定义 WEB 对话框

        根据给定的url、标题、宽高等信息创建一个对话框，对话框中的内容是一个web网页。

5. WPS 加载项与 COM 和 VSTO 的区别？

        COM 或 VSTO 加载项是采用C++、.net语言开发的组件形式集成解决方案，仅在 Windows 版 WPS Office 和 MSO上运行。WPS加载项 与 COM 加载项不同，WPS 加载项采用javascript语言，不涉及在用户设备或客户端中运行的代码。对于 WPS 加载项，主机应用程序（例如 wps）会读取加载项清单，并挂钩 UI 中的加载项自定义功能区按钮和菜单命令。

6. WPS加载项与MSO加载项的区别

	WPS加载项	MSO加载项
开发环境OS	windows、Linux（跨平台）	windows
环境工具	Git、nodejs（轻量化，上手容易，使用广）	.NET Framework（重，上手难）
代码工具	visual studio code（轻量化，上手容易）	Visual Studio（重，上手难）
支持产品	WPS文字、WPS表格、WPS演示（可扩展）	word、Excel、Powerpoint....
产品适用系统	windows、Linux、MAC（开发中）	windows、MAC、IPAD
接口丰富度	全量API	受控API
对接方式	Javascript	Script Lab
代码调试	不依赖互联网	依赖互联网

7. WPS加载项的支持版本

终端	*** 作系统	WPS 版本	支持情况	下载地址
PC	Windows	WPS Office 2019 个人版、专业版、专业增强版	支持	https://pc.wps.cn
PC	Linux	WPS Office 2019 专业版（MIPS、ARM）	支持	联系商务获取
PC	Linux	WPS Office 2019 社区版（x64）	支持	https://linux.wps.cn
PC	MAC	WPS Office 2019 个人版	规划中	无
PC	Windows	WPS Office 2016 及以下版本	不支持	无
移动端	安卓&IOS	WPS Office	不支持	无

8. 学习本教程前你需要了解的技术

        你应该了解一些基本的计算机编程术语。如果你学习过Javascript，PHP，Java等编程语言，将有助于你更快的了解WPS加载项。如果有使用nodejs、Git工具的习惯会容易理解WPS 加载项。技术栈如下：

Javascript/Typescipt,  VBA,  Nodejs，npm，Git。

浏览器自定义协议

常见协议：http:// https:// ftp:// 等

常见自定义协议： thunder://（迅雷）；item://（itunes）；ed2k://（电驴）

这样的协议是需要浏览器和本地计算机安装软件接应， 实现相应 *** 作。

当点类似的连接，浏览器会通知系统以何种程序处理该种协议的连接，这种对应是通过注册表来实现的。

浏览器支持情况：所有浏览器都支持自定义URL协议。

https://en.wikipedia.org/wiki/URL

9. 开发环境准备

*** 作系统	windows：7、8、10； Linux：Ubuntu 18.0.4、CentOS 7
浏览器	Chrome [推荐] 、IE、Firefox、360、奇安信
代码管理	Git：[下载地址] Git - Downloads
Web服务	Nodejs：[下载地址] 下载 | Node.js 中文网 Tomcat：[下载地址] Apache Tomcat® - Apache Tomcat 9 Software Downloads
编程工具	VScode： [下载地址] Visual Studio Code - Code Editing. Redefined