NRWConf2013_T4CodeGeneration

1. T4 Code Generation
Christian Giesswein
1

2. About Me
• Christian Giesswein
ChristianG@ppedv.at
• Development Trainer bei ppedv AG
• Die bunte Welt von C#/.NET
– C#, WCF, WPF, XAML, Blend, ADO.NET,..
• Open-Source: osm2mssql
• www.giesswein-web.at
• Twitter: @GiessweinWeb
2

3. Die ppedv AG
• IT-Schulungsunternehmen für
Microsofttechnologien in Deutschland/Österreich
• 11 Standorte 12 Standorte (NEU: Düsseldorf)
• (Entwickler-)Konferenzen
– VSOne (www.vsone.de)
– Advanced Developer Conference (www.adc10.msd)
– GUI & Design (www.guianddesign.com)
• Eigene Fachzeitschrift: Visual Studio One
3

4. Agenda
• Was werden Sie nun hören?
• T4 Templating
– Microsoft ist super
• Einsatzzwecke
– Apple nicht so super
• Der Prozess
– Linux – naja..
• Hello World mit T4
– T4 – Syntax für 4 – Bier, Wein, Schnaps und Milch
• Die Tanken
• Tooling
• Architektur
• Self-Hosting
4

5. T4 – Was ist das ?!
T4
=
Code der anderen Code schreibt
damit der Code funktioniert…

6. T4 Templating
• Text Template Transformation Toolkit
• Beliebige (Text-)Dateitransformationen
durchführen
• Dateiendung: *.tt
• Visual Studio „Unterstützung“
• C# oder VB.NET
6

7. Verwendungszweck
• Entity Framework
• Compile-Informationen ablegen
– Uhzeit/Pfad/Benutzer/etc.
•
•
•
•
Serialisierung mit T4
XML/JSON zu Klassen transformieren
ASP.NET – Templates erzeugen
…
7

8. Der T4-Prozess
Entwickler
Template
„Visual Studio“
Compiled
Template
Output
Entwickler
8

9. Action !!!
T4 Code Generation
Hello World 

10. Was ist passiert ?
Template
Compiled
Template
Output
10

11. Compiled Template?
• Ausgangsdatei „HelloWorld.tt“ wird
eingelesen und „kompiliert“

12. Compiled Template?
• Ein „Host“ (Visual Studio“) führt die
kompilierte Klasse aus und „Transformiert“
somit das Template

13. Syntax
• <#
– Eine Anweisung folgt
• <#=
– Eine Ausgabe folgt
• <#+
– Eine Klassenerweiterung folgt

14. Action !!!
T4 Code Generation
Klassenerweiterungen

15. T4-Anweisungen
• <#@ template
[language="VB"]
[hostspecific="true|TrueFromBase"]
[debug="true"]
[inherits="templateBaseClass"]
[culture="code"]
[compilerOptions="options"]
[visibility="internal"]
[linePragmas="false"]
#>
15

16. T4-Parameter
• <#@ output
extension=".fileNameExtension"
[encoding="encoding"]
#>
16

17. T4-Assembly / T4-Import
• <#@ assembly
name="[file name]"
#>
• <#@ import
namespace="namespace"
#>
17

18. Xml2Classes
• Einfaches, typisches Beispiel Xml2Classes
– Transformierung einer einfaches XML-Datei in eine
Klasse
Action !!!

19. Problemfindung
• T4-Templates unterstützen Breakpoints
• Ausführen per Kontextmenü „Debug T4
Template“
Action !!!

20. T4 Toolbox
• T4 Toolbox
– Syntax Highlighting
– Gratis
– http://www.olegsych.com/t4toolbox
20

21. DevArt
•
•
•
•
•
Unterstützt VS 2008/2010/2012
IntelliSense
Syntax Highlighting
Gratis!
http://www.devart.com/t4editor/download.html

22. T4 – Advanced
• T4 kann auch das eigene Projekt erweitern
• Eigene Assembly mit:
– <#@ Assembly name="$(TargetPath)" #>
• Achtung! Letzter Buildstand!
Action !!!
22

23. Action !!!
T4 Code Generation
MVVM
Automatische ViewModel-Erzeugung

24. T4 - Advanced
• T4 Unterstützt Out-Of-The-Box nur eine
Ausgabedatei pro T4-Vorlage
– Kann modifiziert werden
Action !!!

25. T4 – Deep Dive
25

26. T4 – Eigener Host
• Visual Studio SDK
– Microsoft.VisualStudio.TextTemplating.11.0
– Microsoft.VisualStudio.TextTemplating.Interfaces.1
1.0
• Engine aus dem SDK  Transformation
• Host kann selber geschrieben werden:
ITextTemplatingEngineHost
Action !!!
26

27. T4 „Automatic Run“
• T4 Templates werden beim Speichern
(STRG+S) automatisch ausgeführt.
• TextTransformer.exe ist der Standardhost
– Möglichkeit 1: Per PRE-Build Ereignis
– C:Program Files (x86)Common FilesMicrosoft
SharedTextTemplating12.0TextTransform.exe

28. T4 „Automatic Run“
• Seit VS2012 auch „Out-Of-The-Box“:
– Möglichkeit 2: MSBuild
• Projekt (*.csproj) bearbeiten
• Erfordert Visual Studio 2012 Data Visualization
SDK
<PropertyGroup>
<TransformOnBuild>true
</TransformOnBuild>
</PropertyGroup>
<Import
Action !!!
Project="$(MSBuildExtensionsPath)MicrosoftVisualStudiov11.
0TextTemplatingMicrosoft.TextTemplating.targets" />

29. Entity Framework
• Entity Framework mit T4 (=DbContext
Generator)
• T4 Templates generieren aus *.EDMX die
POCO-Klassen
– C:Program Files (x86)Microsoft Visual Studio
11.0Common7IDEExtensionsMicrosoftEntity
Framework ToolsTemplatesIncludes
Action !!!
29

30. FRAGEN
?