生成首个 WPS 加载项

在本教程中,将创建一个 WPS 加载项,该加载项将:

  • 设计自定义功能区
  • 打开对话框
  • 创建自定义任务窗格

准备开发环境

  • 安装WPS 12.1.0.18912个人版
  • 安装Node.js
  • 安装代码编辑器 Visual Studio Code

新建 WPS 加载项

1、通过npm全局安装wpsjs开发工具包

安装命令: 

npm install -g wpsjs

如果之前已经安装了,可以检查下wpsjs版本。

更新wpsjs的命令为:

npm update -g wpsjs

2、新建一个WPS加载项:HelloWps

输入命令: 

wpsjs create HelloWps

会出现如下图的几个选项:

生成首个 WPS 加载项

通过上下方向键可以选择要创建的WPS加载项的类型,如果选择“文字”,则创建的加载项会在WPS文字程序中加载并运行,同理选择“电子表格”,则会在WPS表格中运行,这里假设我们选择的是“文字”,按Enter键确定。

3、选择示例代码的代码风格类型

wpsjs工具包提供了两种不同代码风格的示例,“无”代表示例代码中都是原生的JS及HTML代码,没有集成vue\react等流行的前端框架。

生成首个 WPS 加载项

初步学习建议不使用框架,选“无”。实际项目开发推荐使用Vue框架。

确认后wpsjs工具包会在当前目录下生成一个HelloWps的文件夹,我们进入到此文件夹,可以看到HelloWps的相关代码已经生成。

4、开始调试并愉快的写代码

在HelloWps项目文件夹下,执行命令: 

wpsjs debug
生成首个 WPS 加载项
生成首个 WPS 加载项

执行此命令后即可开始调试,wpsjs工具包会自动启动WPS并加载HelloWps这个加载项,同时wpsjs工具包启了一个HTTP服务,此服务主要提供两方面的能力:

(1)提供前端页的的热更新服务,wpsjs工具包检测到网页数据变化时,自动刷新页面。

生成首个 WPS 加载项

(2)提供WPS加载项的在线服务,wpsjs生成的代码示例是一个在线模式,WPS客户端程序实际上是通过HTTP服务来请求在线的WPS加载项相关代码和资源的。

生成首个 WPS 加载项

最后,可以用Visual Studio Code打开示例代码,开始愉快的写代码了。

备注:wpsjs工具包为示例代码中有一个package.json文件,这是node工具标准的配置文件,其中有一个依赖包为wps-jsapi,这个依赖包是WPS支持的全部接口的TypeScript描述,方便在vscode中敲代码时,提供代码联想功能,由于WPS接口会跟随业务需求不断更新,因此当发现代码联想对于有些接口不支持时,通过”npm update –save-dev wps-jsapi“命令定期更新这个包。

(0)
上一篇 2024年11月12日 下午12:43
下一篇 2024年11月12日 下午9:17

相关推荐

  • 银河麒麟搭建Samba服务器共享文件

    在银河麒麟桌面操作系统中,一般通过配置使用FTP来共享文件。本文将介绍另一种办法,即通过配置Samba共享文件。 1.创建Samba共享文件夹 在桌面右键,选择打开终端,在打开的终端内,输入以下命令: 上述命令在当前用户目录下创建了一个 share 目录,用于专门存放共享文件,用户也可根据自己需要指定其他位置或重新命名。 2.设置Samba共享文件夹 选择想…

  • WPS 加载项开发说明

    WPS加载项结构  WPS加载项由自定义功能区和网页两部分组成。自定义功能区只需要一个配置文件,对应WPS加载项目录中的ribbon.xml文件;网页部分负责执行自定义功能区对应的逻辑功能。因为不需要显示网页,所以省略了HTML文件,并用main.js来引入所有的外部JavaScript文件;这些JavaScript文件中通常包含了一系列用Java…

    2024年11月12日
    1300
  • 使用iptables配置防火墙规则

    在银河麒麟桌面操作系统V10,如果遇到通过安全中心配置防火墙规则不生效的情况,则可以使用iptables配置防火墙规则。 一、防火墙基础知识 1.什么是防火墙? 防火墙是一种网络安全系统,用于保护计算机网络免受未经授权的访问、攻击和其他安全威胁。它通过监控和控制进出网络的数据流来实现这一目的。防火墙可以是硬件设备、软件程序或两者的结合。 2.iptables…

    2024年11月13日
    2000
  • 系统登录界面多次输错密码导致账户锁定

    【适用版本】银河麒麟桌面操作系统V10  【问题现象】在登录界面,连续多次输错密码,导致账户锁定。现象如下图所示: 【解决方案】解除账户锁定有两种方法:第一种是进入高级模式对锁定账户进行解锁,第二种是切换至其他可正常登录用户并对锁定账户进行解锁。这里我们介绍第一种办法,下一篇我们再介绍第二种办法。 具体操作步骤  01 重启电脑…

    2024年11月5日
    3700
  • 在银河麒麟中使用来自银河麒麟的共享打印机

    一、打印机侧配置步骤 1)银河麒麟添加打印机后,选中打印机右键勾选“共享”选项 2)打开:服务器—>设置,勾选“发布连接到这个系统的共享打印机”和“允许从互联网打印” 二、银河麒麟侧配置步骤 1)打开:开始菜单—>设置—>设备—>打印机—>添加打印机和扫描仪;点击添加,点击“使用SAMBA 的Windows 打印机”,输入“连接共享打印机的电脑IP 地址/”…

    2024年11月13日
    2000

发表回复

登录后才能评论
微信公众号