【Office Add-ins】开发调试部署流程

2,126 阅读2分钟

一、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

设置开发环境 - Office Add-ins

三、创建加载项项目

执行 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 服务网站,需申请域名及相关证书

www.daxiaamu.com/7398/

(三) 部署 Office 插件

部署和发布 Office 加载项 - Office Add-ins

1. Microsoft 365 集成应用

集成应用门户仅适用于全球客户,全局管理员、全局读者、Exchange 管理员和Azure 应用程序管理员。

通过 Microsoft 365 管理中心访问“集成应用”,选择“上传自定义应用”

上传清单文件,清单文件为 dist 文件夹下 xml 文件

“下一步”->“添加用户”->"下一步"

“下一步”查看权限,部署完成

集成应用入门 - Microsoft 365 admin

2. 受信任加载项目录

(四) 部署成功

Microsoft 365:管理员托管

受信任加载项目录:共享文件夹

(五) 卸载

1. Microsoft 365 集成应用

“集成应用”中选择需要卸载的应用,选择“删除应用”

选择“删除”,即可卸载加载项

2. 受信任加载项目录

“文件”->“选项”->“信任中心”->“信任中心设置”

选择“受信任的加载项目录”,取消“显示在菜单中”复选框