如何用Add-in Express从现有.Net VSTO Outlook插件项目生成MSI安装包

前置准备 #

• 安装匹配版本的Add-in Express for Office and .NET，版本需兼容当前项目使用的经典.NET Framework版本，同时覆盖需要支持的Outlook版本范围。
• 操作前关闭所有Visual Studio实例、Outlook及其他Office进程，避免文件占用、注册表写入冲突。
• 将原有VSTO插件项目切换到Release编译模式，目标平台和部署目标的Office架构对齐：仅支持32位Office选x86，仅支持64位选x64，需兼容双架构则分别准备对应平台的编译输出。

安装项目配置 #

• 打开原有VSTO插件所在的Visual Studio解决方案，右键解决方案节点选择「添加-新建项目」，在模板列表中选择Add-in Express Setup Project，自定义项目名称后添加到当前解决方案。
• 右键新建的安装项目，选择「Add-项目输出」，选中原有VSTO Add-in项目的「主输出」确认，插件核心编译文件会自动纳入打包范围。
• 手动补充插件依赖的非默认文件：包括第三方引用DLL、自定义资源文件、配置文件等，全部通过安装项目的添加文件入口纳入打包目录，避免安装后出现依赖缺失问题。
• 在安装项目属性面板填写基础产品信息：包括产品名、制造商、版本号、安装图标、用户许可协议等，这些内容会直接展示在MSI安装向导界面。
• 打开安装项目的必备组件配置页，勾选对应版本的.NET Framework、VSTO Runtime、Office主互操作程序集（PIA），设置为安装前自动检测，缺失时自动触发安装即可，无需手动编写启动条件判断逻辑。

不要手动修改Add-in Express自动生成的VSTO插件注册表配置，组件会根据导入的项目输出自动写入正确的LoadBehavior、Manifest路径、插件ProgID等必填注册表值，手动修改大概率会导致插件安装后Outlook无法识别。

安装包生成与验证 #

• 配置完成后右键安装项目选择「生成」，等待输出完成，生成的MSI文件默认存放在安装项目目录下对应编译配置（Release/x86/x64）的子文件夹中。
• 必须在无开发环境、无预装插件依赖的干净测试环境验证安装包：走完整安装流程后打开Outlook，在COM加载项列表确认插件正常加载、核心功能可用；同时验证卸载流程，确认卸载后无残留文件、无无效注册表项，避免Outlook启动时提示找不到加载项。
• 如需兼容32/64位双架构，分别切换安装项目的目标平台，引用对应平台编译的VSTO项目输出，分别生成两个架构的MSI安装包即可。
• 如需自定义安装逻辑（比如安装前检测Outlook版本、安装后写入自定义配置），可直接通过Add-in Express安装项目提供的自定义事件接口编写对应代码，无需额外编写自定义动作脚本。

内容的提问来源于stack exchange，提问作者lorenzo muscio