visual-studio-2013 - VS2013 和 VS2015 中的 T4 文本转换

Question

我们公司有严重依赖 T4 的遗留系统，而构建它的员工已经走了。它对我们来说运行良好，但是最近一些开发人员升级到了 VS2015。 T4 转换停止为它们工作(错误如下所示)。它看起来虽然有对 Microsoft.VisualStudio.TextTemplating.12.0.dll 的引用.他们将引用更改为“14”并且都为他们工作。但是，其他开发人员在 VS2013 上共享的同一个项目不再出现错误:

Compiling transformation: The type 'Microsoft.VisualStudio.TextTemplating.TextTransformation' is defined in an assembly that is not referenced. You must add a reference to assembly 'Microsoft.VisualStudio.TextTemplating.14.0, Version=14.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'.

你能在 VS2013 和 VS2015 中打开的同一个项目上运行 T4 吗？附带说明一下，老员工制作了一个依赖程序集，所有 TextTransformations 都来自该程序集(它还提供了在 *.tt 文件中使用的帮助程序)。不幸的是，它使用了一个只存在于 Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll 中的接口(interface)。 ，所以旧的引用被拖来拖去Î。不确定这是否有贡献。但基本上这是底线:

当所有开发人员都在 VS2013 上时，一切正常，引用资料是:

Microsoft.VisualStudio.TextTemplating.12.0.dll
Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll
Microsoft.VisualStudio.TextTemplating.VSHost.12.0.dll

然后当一些人转到 vs2015 时，让它工作的唯一方法是用 14.0 更改 12.0* dll，但随后 vs2013 开发人员停止工作。

更新

我可能没有澄清我们的完整设置。我们在一个单独的项目中有 20-30 个 *.tt 文件，该项目包含在解决方案中，该项目将应用文本转换。

我们有一个助手 Extensibility.CodeGeneration.dll(这也引用了 Microsoft.VisualStudio.TextTemplating.N.dll 文件)，它有几个静态助手以及派生自 Microsoft.VisualStudio.TextTemplating.TextTransformation 的基类。

包含所有 *.tt 文件的"template"项目，每个 .tt 文件都使用我们帮助程序 dll 中的静态方法。它还引用了所有相同的 Microsoft.VisualStudio。 dll。

在每个 *.tt 文件中，我们都有类似这样的内容，其中 AreaTemplate 是在 *.tt 文件本身中定义的一个类，它派生自 Microsoft.VisualStudio.TextTemplating.TextTransformation 或我们的帮助程序 dll 中公开的基类之一.

var template = new AreaTemplate { Settings = settings, Area = area, Layouts = layouts };
写(模板。TransformText())；

有人在评论中询问我如何获得/使用“主机”。在搜索代码时，我们有一些常见的场景(都在帮助程序 dll 中完成)。在每个实例中，主机的类型为 ITextTemplatingEngineHost .

情况1:

var dte = (EnvDTE.DTE)( (IServiceProvider)host ).GetService( typeof( EnvDTE.DTE ) );

案例二:

var hostServiceProvider = (IServiceProvider)host;

鉴于上面的＃3，我认为由于使用/公开 TextTransformation 类，我必须引用 Microsoft.TextTemplating dll(而不仅仅是 Interfaces dll)。

此外，如果我将我的“帮助”和"template"项目中的引用更改为 12.0...在 vs2015 中，我会收到有关“您必须添加对 12.0 的引用”的错误...我在两个适用的(在我眼中)项目......不知道为什么VS告诉我添加它。我尝试使用在 *.tt 文件中添加显式引用

<#@ assembly Name="$(ProjectDir)..\..\Assemblies\Microsoft.VisualStudio.TextTemplating.12.0.dll" #>

但后来我得到了错误

The type 'Microsoft.VisualStudio.TextTemplating.TextTransformation' exists in both 'c:\BTR\Source\Assemblies\Microsoft.VisualStudio.TextTemplating.12.0.dll' and 'c:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.VisualStudio.TextTemplating.14.0\v4.0_14.0.0.0__b03f5f7f11d50a3a\Microsoft.VisualStudio.TextTemplating.14.0.dll'

几乎就像对 VS 中已内置的最新 Texttemplate 的隐藏/隐式引用？

不确定我们的设置是否是实现我们最初目标的更复杂的方式，但我认为如果我们以不正确的方式进行操作，我将无法放松和改变。

鉴于我们的设置，让我知道您是否认为我被卡住了。我试图找出 MSBuild 中的“条件”以帮助支持这两个 Visual Studio，但未能成功。

提前致谢。

Answer 1

尝试将引用从“Microsoft.VisualStudio.TextTemplating.12.0.dll”更改为“Microsoft.VisualStudio.TextTemplating.Interfaces.12.0.dll”。每个新版本的 Visual Studio 服务都将有一个新的实现程序集，该程序集将实现以前版本的接口(interface)。为了保持向后兼容性，您应该只引用接口(interface)程序集而不是实现程序集。如果模板引用了界面中没有的任何内容，您可能必须更改模板。

更新

哇，所以你有一个非常复杂的设置，我不知道你是否能够在两个版本中使用它，而无需像你一样更改代码。

我认为主要问题出在您的助手类中，在#3 中您说 AreaTemplate 类派生自 TextTransformation。 TextTransformation 在实现 dll 中，因此它将存在于每个版本的 Visual Studio 中。如果您的助手 dll 被遵守从 2013 年开始引用它，然后您在 2015 年使用该 dll，它将无法正常工作。

当 T4 模板被转换时，文件中的文本被解析为一个类，该类被加载到一个应用程序域中(独立于一个正在运行的 Visual Studio)并调用该类的 TransformText 方法。由于您的模板引用了您的帮助程序类，因此帮助程序程序集将被加载到新的应用程序域中，进而尝试在其中加载 TextTemplating 12，应用程序域将无法解析 12 引用，因为您使用的是 VS 2015 年。

在另一个方向，当您引用 2015 年的文本模板 14 并尝试在 VS 2013 中使用它时，您将遇到同样的问题，应用程序域将无法找到 TextTemplating 14，因为您在 VS 2013 中并且 14 dll 没有存在。

在最后一个场景中，当您在 VS 2015 中并在 tt 文件中添加指向 TextTemplating 12 的链接时，它失败了，因为为运行模板而创建的应用程序域已经加载了 TextTemplating 14 dll，然后您还告诉它加载 TextTemplating 12个DLL。当我谈到 VS 向后兼容性时，这可以追溯到我在评论中的帖子，TextTemplating 12 和 14 在同一命名空间中具有相同的 TextTransformation 类，并且运行时无法同时加载它们，因此您会收到该错误。

您可以尝试的几件事:

1)将TextTemplating 12 dll放在VS 2015机器上的GAC中。理论上，这将让 T4 AppDomain 加载 TextTemplating 的两个副本，然后 VS 2015 将能够使用 14 版本，而您的 tt 文件和帮助程序 dll 使用 12 版本。让 VS 2013 机器保持不变。

2) 与 1 相同，但反过来，将项目设置为目标 2015 并引用 14 dll，然后在 vs 2013 机器上 GAC 14 dll，不确定这是否可行，因为 14 dll 可能对较新的 vs 有其他依赖关系组件。

3) 在 vs 2015 机器上找到一种方法为 T4 应用程序域进行绑定(bind)重定向，以便将查找 TextTemplating 12 的调用解析为 TextTemplating 14。通常绑定(bind)重定向在 app/web.config 文件中完成，但不确定您将如何为 T4 执行这些操作，可能需要查看代码并查看应用程序域是如何创建和加载的。