WPS加载项系列(1)第一个WPS项目

  • Post author:
  • Post category:其他



前言

任何一个新技术的学习使用,一般都由demo开始,然后逐步深入直到完全掌握,这个也不例外,所以这个系列的第一篇文章主要写的是如何将官方提供的demo跑起来。


一、项目地址

官方提供的演示示例(OA助手)





https://code.aliyun.com/zouyingfeng/wps/tree/master



官方提供的开发文档





https://open.wps.cn/docs/office




二、环境安装


1.安装node.js



下载地址:







https://nodejs.org/en/download/






安装验证:安装时一直Next,安装后进行版本验证


2.安装vs code



下载地址:






https://code.visualstudio.com/





安装目的:




代码编辑软件,建议使用软件


3.安装wps



建议安装最新专业版wps



注意:存在




兼容性问题




,版本不同可能会导致有的js方法报错



、项目启动

1.进入 oaassist\server\ 目录下
2.npm config set registry http://registry.npm.taobao.org //切换npm淘宝镜像源
3.npm install //安装相应依赖
4.node StartupServer //启动demo的服务

注意:

1、正常情况下,通过新建文件可以自动打开wps文档,并展示wps加载项。如果点击新建文件提示“请允许浏览器打开WPS Office”,同意后如果没有响应是wps版本导致,可以通过重新安装其他版本wps,或者通过手动打开wps文档,也可以看到wps加载项

3、这个项目有使用node.js编写代码,所以需要用node启动。如果你的项目不想通过node启动,可以参考官方技术文档中

生成首个WPS加载项



四、项目解析

参考

生成首个WPS加载项

生成的demo,我简单介绍下wps加载项的主要文件

1、index.html

这个是页面部分,通过main.js来引入所有的外部JavaScript文件,比如ribbon.js、通用.js、业务.js

2、ribbon.js

这个是自定义功能区配置文件,其中第一行配置onLoad=”OnAddinLoad”方法在整个wps加载项中是第一个执行的,可以用来进行初始化操作。

ribbon.xml文件中的getImage会在初始化时完成加载项图标的加载,在用户点击加载项时会通过onAction会触发ribbon.js中对应的方法,并根据加载项id执行对应的业务逻辑。


结束语

这就是本章的内容,如果有什么不明白的可以在下方留言,如果看到我会及时回复的。

在下一篇文章中,我会编写一个简单的wps加载项实操演示一番,另外还会说下wps的相关配置文件以及作用,如果有时间的话,再说说wps的部署模式,感兴趣的小伙伴可以点赞关注,我会尽快更新哦!



版权声明:本文为kuibuzhiqianli原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。