如何更简便创建OfficeJS开发的Word加载项Windows安装包
Office JS Word任务窗格加载项本地测试快速安装方案
本地测试场景不需要走官方正式发布的全套流程,以下3种方案都可以快速实现安装效果验证,配置成本远低于正式发布流程:
方案1:旁加载部署(零打包,5分钟完成)
这是开发阶段最常用的测试方式,不需要生成任何安装文件:- 启动本地开发服务,确保加载项入口资源可以通过HTTPS正常访问(Office加载项强制要求HTTPS源,本地开发可以用工具生成的自签名证书)
- 准备一个空的本地目录,将项目中的
manifest.xml文件放入该目录 - 打开Word,依次进入「文件-选项-信任中心-信任中心设置-受信任的加载项目录」,将刚才存放manifest的目录路径添加为受信任目录,勾选「显示在菜单中」后保存设置,重启Word
- 重启后在「插入-我的加载项-共享文件夹」分类下即可找到你的加载项,点击即可加载运行,代码修改后刷新任务窗格就能看到最新效果。
方案2:注册表脚本一键安装(单文件,双击即装)
如果需要模拟安装文件的使用体验,可以通过写入注册表的方式实现一键配置,不需要手动操作信任中心:- 确认
manifest.xml中的加载项ID、入口地址、名称、版本信息配置正确 - 新建文本文件,修改后缀为
.reg,写入注册表配置内容,参考示例如下:
Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Wef\Developer\替换成你manifest里的加载项ID] "FriendlyName"="你的测试加载项名称" "Description"="本地测试用Word加载项" "ManifestPath"="C:\\test-addin\\manifest.xml" "LoadBehavior"=dword:00000003- 测试时双击这个reg文件,确认导入注册表后重启Word,即可自动加载对应加载项。卸载时只需要删除对应注册表键值即可。
注意:该方案仅适用于本地开发测试,请勿用于对外分发。
- 确认
方案3:打包为标准EXE安装文件
如果需要验证标准桌面软件的安装流程,可以用轻量打包工具快速生成EXE安装包,不需要走官方的MSIX、应用商店打包流程:- 将加载项的静态前端资源和本地HTTPS静态服务打包为单文件程序,运行后自动在后台启动固定端口的本地HTTPS服务,确保加载项入口地址稳定可访问
- 将上述服务程序、自签名证书导入脚本、注册表配置脚本、卸载逻辑整合,用Inno Setup、NSIS这类免费的安装包制作工具封装为标准EXE安装包
- 安装包可以配置为一键完成程序文件释放、证书导入、注册表写入、服务自启配置,用户点击下一步即可完成安装,和普通桌面软件安装体验完全一致。首次配置好打包模板后,后续版本更新只需要替换资源文件,1分钟就能生成新的安装包。
- 所有本地测试部署方式都需要注意:自签名证书必须提前加入系统受信任根证书列表,否则Office会拦截加载项的网络请求,导致加载项无法正常显示。
内容的提问来源于stack exchange,提问作者Gocool Ad
相关产品推荐
相关产品推荐

