保姆级教程：用Advanced Installer 18打包VSTO插件，让WPS也能用上你的Excel工具
从零到一：用Advanced Installer打造兼容WPS的VSTO插件全指南
办公室里总有些重复性工作让人头疼——每天手动整理几十张表格、核对上百条数据。当你终于用VSTO开发出一个自动化工具时，却发现同事电脑上只有WPS，插件根本无法加载。这种"最后一公里"的困境，正是本教程要解决的痛点。
1. 环境准备与工具选择
工欲善其事，必先利其器。在开始打包前，我们需要准备以下环境：
- Visual Studio：确保已安装VSTO开发环境
- WPS Office：建议安装最新个人版（测试环境为2019版）
- Advanced Installer：版本18.x以上（官方提供30天试用版）
提示：虽然网上存在破解版，但商业用途建议购买正版授权，避免法律风险
安装Advanced Installer时，注意勾选中文语言包。首次启动后，在View→Language中选择简体中文，界面将完全本地化：
[安装配置建议] 安装路径 = 建议默认C:\Program Files\Advanced Installer 临时目录 = 预留至少2GB空间 防病毒排除 = 添加安装目录到杀毒软件白名单2. 创建VSTO安装项目
启动Advanced Installer后，选择新建项目→Visual Studio插件模板。关键配置项如下：
| 配置项 | 推荐值 | 注意事项 |
|---|---|---|
| 项目名称 | YourAddinName | 避免特殊字符 |
| 输出格式 | MSI+EXE组合 | 兼顾安装便利性 |
| 目标平台 | x86/x64自适应 | 需与Office位数匹配 |
| 安装范围 | 当前用户 | 避免权限问题 |
在应用程序文件夹中添加以下文件：
- 主程序集（.dll）
- VSTO清单文件（.vsto）
- 依赖的NuGet包
- 许可证文件（.rtf）
<!-- 示例文件结构 --> <Files> <File Source="bin\Release\ExcelAddIn.dll"/> <File Source="ExcelAddIn.vsto"/> <File Source="license.rtf"/> </Files>3. 注册表关键配置
这是实现WPS兼容的核心步骤。通过注册表编辑器，我们需要添加两套配置：
Office路径（标准配置）
HKEY_CURRENT_USER\Software\Microsoft\Office\Excel\Addins\ YourAddinName Description = "你的插件描述" FriendlyName = "显示名称" LoadBehavior = 3 Manifest = "file:///[INSTALLDIR]YourAddin.vsto"WPS路径（需手动添加）
HKEY_CURRENT_USER\Software\Kingsoft\Office\ET\AddinsWL\ YourAddinName (默认) = "file:///[INSTALLDIR]YourAddin.vsto"实际操作步骤：
- 在Advanced Installer中打开
资源→注册表 - 右键
HKEY_CURRENT_USER新建键路径 - 分别创建上述两个注册表结构
- 为每个键添加对应的字符串值
注意：不同WPS版本的注册表路径可能略有差异，建议先用regedit查看本机准确路径
4. 安装程序优化技巧
基础配置完成后，可以通过这些优化提升用户体验：
自定义安装界面
- 添加公司Logo（尺寸建议164×314像素）
- 修改欢迎图片（建议使用600×400的Banner）
- 添加安装完成后的快捷方式
依赖项自动安装
[Prerequisites] .NET Framework 4.7.2 = 自动检测并下载 VSTO Runtime = 包含在安装包中版本控制配置
<Upgrade> <UpgradeCode>{YOUR-GUID-HERE}</UpgradeCode> <MinimumVersion>1.0.0</MinimumVersion> </Upgrade>5. 构建与测试
点击构建按钮前，建议进行最后检查：
- 注册表路径是否准确
- 所有文件是否包含
- 许可证文件是否有效
- 版本号是否更新
构建成功后，在测试机上执行以下验证流程：
- 纯净系统安装（无Office/WPS）
- 仅安装WPS的环境
- Office+WPS共存环境
- 不同Windows版本测试（Win10/Win11）
常见问题排查表：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| WPS中不显示插件 | 注册表路径错误 | 核对Kingsoft路径 |
| 插件加载失败 | 缺失VSTO Runtime | 打包时包含运行时 |
| 功能异常 | .NET版本不符 | 更新目标机框架 |
6. 高级定制方案
对于企业级分发，可以考虑以下增强功能：
静默安装参数
YourInstaller.exe /quiet /norestart ALLUSERS=1多语言支持
- 在
资源→语言中添加所需语言 - 为每种语言准备对应的：
- 界面文本
- 许可证文件
- 注册表项
数字签名
signtool sign /fd sha256 /f cert.pfx /p password YourInstaller.exe最后分享一个实战经验：在为某财务部门部署插件时，发现WPS 2016的注册表路径与新版不同。通过添加版本检测逻辑，最终实现了自动适配不同WPS版本的功能。关键是在安装时执行自定义动作检查注册表：
RegistryKey key = Registry.CurrentUser.OpenSubKey("Software\\Kingsoft\\Office"); if (key != null) { string version = key.GetValue("Version").ToString(); // 根据版本号动态修改注册表路径 }