如何发布打包所有依赖DLL的Outlook VSTO外接程序

问题现象 #

• 基于Azure语音服务开发Outlook VSTO外接程序，Visual Studio调试模式运行全流程正常
• VS发布安装Release版本后功能失效，日志显示SpeechConfig.FromSubscription方法执行前日志正常输出，执行后无后续日志输出，判断为依赖缺失导致初始化阶段阻塞或异常退出

相关代码片段：

FormMainSettings.WriteLine($"Step #2: {ThisAddIn.VoiceName}, {YourSubscriptionKey}, {YourServiceRegion}");
var speechConfig = SpeechConfig.FromSubscription(YourSubscriptionKey, YourServiceRegion);
FormMainSettings.WriteLine("Step #2.1");

依赖DLL批量集成到安装包的操作方法 #

1. 配置项目引用自动复制依赖 #

• 在解决方案资源管理器中展开项目的「引用」节点，找到所有Microsoft.CognitiveServices.Speech相关的托管程序集引用
• 选中对应引用后在属性面板将「复制本地」设置为True，保证Release生成时所有托管DLL会被复制到输出目录
• 额外注意：Azure语音SDK通过NuGet安装时会附带对应平台的原生C++依赖DLL，默认存放在输出目录的runtimes子文件夹下，这部分文件是初始化必须的，不能删除

2. 发布配置中手动包含所有依赖文件 #

• 如果使用VS自带的ClickOnce发布：
  • 右键项目选择「属性」，切换到「发布」选项卡，打开「应用程序文件」列表
  • 在列表中找到所有Azure语音相关的托管DLL、以及runtimes目录下的所有原生DLL，将其发布状态设置为「包括」，下载组设置为「必需」
  • 保存配置后重新发布即可
• 如果使用第三方安装打包工具：
  • 直接将本地Release输出目录下的所有文件、包括子文件夹整体添加到安装包的应用程序安装目录，不要过滤任何DLL或子目录

3. 前置校验与异常排查 #

• 发布前先本地生成Release版本，检查输出目录是否存在Microsoft.CognitiveServices.Speech.dll，以及对应目标平台的原生DLL（x86对应runtimes\win-x86\native目录下的文件，x64对应runtimes\win-x64\native目录下的文件）
• 确认项目编译目标平台和安装的Outlook位数一致，64位Outlook不能用x86编译的外接程序，反之亦然
• 在初始化代码外层增加全局异常捕获，将异常信息写入日志，避免静默失败：

try
{
    FormMainSettings.WriteLine($"Step #2: {ThisAddIn.VoiceName}, {YourSubscriptionKey}, {YourServiceRegion}");
    var speechConfig = SpeechConfig.FromSubscription(YourSubscriptionKey, YourServiceRegion);
    FormMainSettings.WriteLine("Step #2.1");
}
catch (Exception ex)
{
    FormMainSettings.WriteLine($"语音SDK初始化失败：{ex.Message}\r\n堆栈信息：{ex.StackTrace}");
}

调试模式下VS会自动加载NuGet缓存中的所有依赖，不会出现文件缺失问题，这也是为什么调试正常但Release发布后失效的核心原因。

内容的提问来源于stack exchange，提问作者Davy Chen