类库程序集绑定重定向：NuGet包适配多Visual Studio版本问题

嘿，这个场景我太熟悉了！既然目标VS程序集的API没有显著差异，用程序集绑定重定向来跨版本兼容完全可行，下面我给你拆解具体步骤：

1. 在配置文件中添加绑定重定向规则 #

首先，你需要在项目的app.config（如果是类库，最终生效的是加载它的宿主程序的配置文件）里添加重定向规则，把不同VS版本的目标程序集统一映射到当前环境的版本。

举个针对Microsoft.VisualStudio.TestTools.UITest.Extension的示例配置：

<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <!-- 针对UITest扩展程序集的重定向 -->
      <dependentAssembly>
        <assemblyIdentity name="Microsoft.VisualStudio.TestTools.UITest.Extension"
                          publicKeyToken="b03f5f7f11d50a3a"
                          culture="neutral" />
        <!-- 覆盖从VS2012(11.0)到VS2022(17.0)的所有版本 -->
        <bindingRedirect oldVersion="11.0.0.0-17.0.0.0"
                         newVersion="17.0.0.0" />
        <!-- 禁用微软的发布者策略，确保你的重定向优先生效 -->
        <publisherPolicy apply="no" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

• oldVersion：指定需要重定向的版本范围，覆盖你想兼容的所有VS版本对应的程序集版本
• newVersion：填写你希望统一使用的目标版本（通常是当前开发环境的VS对应版本，或者用户环境中普遍存在的最高版本）
• publisherPolicy：部分微软官方程序集会自带发布者策略，可能会覆盖你的自定义重定向，加上这一行可以确保你的规则优先生效

2. 将重定向配置打包进NuGet包 #

因为你的项目是发布为NuGet包的，要确保用户安装包后，重定向规则能自动合并到他们的项目配置中，不用手动复制：

1. 创建一个app.config.transform文件，只保留配置中的重定向核心部分（避免覆盖用户原有配置）：

<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="Microsoft.VisualStudio.TestTools.UITest.Extension"
                          publicKeyToken="b03f5f7f11d50a3a"
                          culture="neutral" />
        <bindingRedirect oldVersion="11.0.0.0-17.0.0.0"
                         newVersion="17.0.0.0" />
        <publisherPolicy apply="no" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

2. 在你的NuSpec文件中添加这个文件作为content项，指定transform动作：

<files>
  <file src="app.config.transform" target="content" />
</files>

这样用户安装你的NuGet包时，NuGet会自动把这段重定向规则合并到他们项目的app.config里，不会覆盖原有内容。

3. 关键注意事项 #

• 类库的配置依赖宿主程序：类库本身的app.config不会直接生效，重定向规则必须存在于加载类库的宿主程序（比如你的自动化测试项目）的配置文件中，这也是为什么要通过NuGet的transform功能把规则注入到用户的项目配置里。
• 验证公钥令牌：确保assemblyIdentity中的publicKeyToken和目标程序集的一致（VS相关程序集的公钥令牌通常是b03f5f7f11d50a3a，但最好自己通过反编译工具确认一下）。
• 多版本测试：在你需要兼容的各个VS版本环境下测试项目，确认程序集能正常加载，没有出现FileNotFoundException或版本不匹配的异常。

内容的提问来源于stack exchange，提问作者Arnon Axelrod