一、Office 加载项的本质
Office 加载项可以理解为 Office 插件,支持在 Office 网页版、Windows、Mac 和 iPad 等中使用。
Office 加载项包括两个基本组件
- XML 清单文件:一个 XML 文件,定义加载项的设置和功能。
- Web应用:定义加载项组件的 UI 和功能,基于标准 Web 技术。
Web 应用程序使用 Office JavaScript API 与运行加载项的 Office 文档进行交互
Office 加载项平台概述 - Office Add-ins
开发 Office 加载项 - Office Add-ins
二、设置开发环境
Office 提供两种类型的开发环境,两个环境创建的 Office 加载项的框架是不同的
- Node.js 环境(官方推荐)
- Visual Studio 环境
本文采用 Node.js 环境
(一) 安装 Node.js、npm
(二) 安装代码编辑器
Visual Studio Code
(三) 安装 Yeoman 生成器 -- Yo Office
三、创建加载项项目
执行 yo office
若报错
直接 Git 下载代码
git clone xxx
npm install
npm start
若报错,执行
We can’t open this add-in from localhost - Office
将 VS Code 终端设置为始终以管理员权限打开 - 掘金
四、开发和调试
(一) 官网调试方法
调试 Office 加载项 - Office Add-ins
(二) 部署到 Office 网页版调试
“插入“->”加载项”
“上传我的加载项”上传 清单文件
(三) 浏览器打开直接调试
五、部署
(一) 准备部署文件
修改 webpack.config.js 文件,设置 urlProd 为静态网站地址
运行 npm run build
生成 dist 文件
(二) Nginx 部署静态网站
此网站为 https 服务网站,需申请域名及相关证书
(三) 部署 Office 插件
部署和发布 Office 加载项 - Office Add-ins
1. Microsoft 365 集成应用
集成应用门户仅适用于全球客户,全局管理员、全局读者、Exchange 管理员和Azure 应用程序管理员。
通过 Microsoft 365 管理中心访问“集成应用”,选择“上传自定义应用”
上传清单文件,清单文件为 dist 文件夹下 xml 文件
“下一步”->“添加用户”->"下一步"
“下一步”查看权限,部署完成
2. 受信任加载项目录
- 添加 manifest.xml 所在目录为受信任的目录
原理:旁加载 Office 加载项以从网络共享进行测试 - Office Add-ins
(四) 部署成功
Microsoft 365:管理员托管
受信任加载项目录:共享文件夹
(五) 卸载
1. Microsoft 365 集成应用
“集成应用”中选择需要卸载的应用,选择“删除应用”
选择“删除”,即可卸载加载项
2. 受信任加载项目录
“文件”->“选项”->“信任中心”->“信任中心设置”
选择“受信任的加载项目录”,取消“显示在菜单中”复选框