如何在MSBuild中编译TypeLite T4模板

Question

我希望能够使用TypeLite在构建过程中自动为所有C# DTO创建.d.ts文件。我的Contract.tt是安装TypeLite Nuget包时略微压缩的原始文件：

    <#@ template debug="true" hostspecific="True" language="C#" #> 
    <#@ assembly name="TypeLite.dll" #>
    <#@ assembly name="TypeLite.Net4.dll" #>
    <#@ assembly name="My.Contract.dll" #>

    <#@ import namespace="TypeLite" #> 
    <#@ import namespace="TypeLite.Net4" #> 
    <#@output extension=".d.ts"#>

    <#@include file="Manager.ttinclude"#>
    <#
    var manager = Manager.Create(Host, GenerationEnvironment);
    var ts = TypeScript.Definitions()
        .WithReference("Enums.ts")
        .ForLoadedAssemblies();
    #>
    <#= ts.Generate(TsGeneratorOutput.Properties) #>

    <# manager.StartNewFile("Enums.ts"); #>
    <#= ts.Generate(TsGeneratorOutput.Enums) #>
    <# manager.EndBlock(); #>
    <# manager.Process(true); #>

根据MS Guide和这篇文章的建议，我已将以下代码添加到我的MSbuild过程中：

<PropertyGroup>
  <VisualStudioVersion Condition="'$(VisualStudioVersion)' == ''">12.0</VisualStudioVersion>
  <VSToolsPath Condition="'$(VSToolsPath)' == ''">$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)</VSToolsPath>
  <TransformOnBuild>true</TransformOnBuild>
</PropertyGroup>
<ItemGroup>
  <T4ReferencePath Include="$(SolutionDir)\My.Contract\bin\$(Configuration)">
    <InProject>False</InProject>
  </T4ReferencePath>

  <None Include="$(SolutionDir)\Scripts\Contract.tt">
    <Generator>TextTemplatingFileGenerator</Generator>
    <OutputFilePath>$(SolutionDir)\Scripts</OutputFilePath>
  </None>
</ItemGroup>

<Import Project="$(VSToolsPath)\TextTemplating\Microsoft.TextTemplating.targets" />

但不幸的是，我收到了这个错误：

Error   14  Running transformation: System.ArgumentNullException: Value cannot be null.
Parameter name: Could not obtain DTE from host
   at Microsoft.VisualStudio.TextTemplating<cut>.GeneratedTextTransformation.Manager.VSManager..ctor

看起来 T4 模板只能在 VisualStudio 中执行。是否有一种方法可以使用 MSBuild 运行 TypeLite 编译？

- 2ooom

---

获取在生成中运行 T4 模板的唯一方法是安装 VS SDK，然后再安装 Modeling SDK，对吧？我有什么遗漏的吗？ - Santhos

我遇到了这个错误：“编译转换：找不到元数据文件 '$(TargetDir)TypeLite.dll'。行=0，列=0”。有什么想法吗？我认为我可能设置了T4ReferencePath错误？ - Santhos

Answer 1

问题出在Manager.ttinclude中，该文件负责将T4输出拆分为多个文件并自动将它们添加到项目中。这需要 DTE，而 DTE 不是Visual Studio 建模 SDK中 MSBuild 目标的一部分。

所以我只需删除manager并创建两个单独的模板。不再使用Contract.tt，而是使用：

Enums.tt：

    <#@ template debug="false" hostspecific="True" language="C#" #>
    <#@ assembly name="TypeLite.dll" #>
    <#@ assembly name="TypeLite.Net4.dll" #>
    <#@ assembly name="CC.Business.Contract.dll" #>

    <#@ import namespace="TypeLite" #> 
    <#@ import namespace="TypeLite.Net4" #> 
    <#@output extension=".ts"#>

    <#
        var ts = TypeScript.Definitions()
            .ForLoadedAssemblies();
    #>
    <#= ts.Generate(TsGeneratorOutput.Enums) #>

还有 Models.tts：

    <#@ template debug="false" hostspecific="True" language="C#" #>
    <#@ assembly name="TypeLite.dll" #>
    <#@ assembly name="TypeLite.Net4.dll" #>
    <#@ assembly name="CC.Business.Contract.dll" #>

    <#@ import namespace="TypeLite" #> 
    <#@ import namespace="TypeLite.Net4" #> 
    <#@output extension=".d.ts"#>

    <#
        var ts = TypeScript.Definitions()
            .WithReference("Enums.ts")
            .ForLoadedAssemblies();
    #>
    <#= ts.Generate(TsGeneratorOutput.Properties) #>

- 2ooom