빌드 프로세스의 코드 생성
텍스트 변환은 Visual Studio 솔루션의 빌드 프로세스 중에 호출될 수 있습니다. 이는 텍스트 변환에 대해 특수화된 빌드 작업입니다. T4 빌드 작업은 디자인 타임 텍스트 템플릿을 실행하고 전처리된 런타임 텍스트 템플릿을 컴파일합니다.
사용하는 빌드 엔진에 따라 빌드 작업에서 수행할 수 있는 몇 가지 작업이 다를 수 있습니다. Visual Studio에서 솔루션을 빌드할 때, hostspecific = "true" 특성이 설정되어 있으면 텍스트 템플릿이 Visual Studio API(EnvDTE)에 액세스할 수 있습니다. 그러나 Visual Studio를 통해 서버 빌드를 시작하거나 명령줄에서 솔루션을 빌드할 때는 액세스할 수 없습니다. 이러한 경우에는 MSBuild에서 빌드가 수행되고 다른 T4 호스트가 사용됩니다.
즉, MSBuild에서 텍스트 템플릿을 빌드하는 경우와 같은 방법으로 프로젝트 파일 이름과 같은 항목에 액세스할 수 없습니다. 그러나 빌드 매개 변수를 사용하여 환경 정보를 텍스트 템플릿 및 명령 프로세서에 전달할 수 있습니다.
컴퓨터 구성
개발 컴퓨터에서 빌드 작업을 사용하도록 설정하려면 Modeling SDK for Visual Studio를 설치하세요.
Visual Studio가 설치되어 있지 않은 컴퓨터에서 빌드 서버를 실행하는 경우 개발 컴퓨터에서 빌드 컴퓨터로 다음 파일을 복사합니다. 여기서 '*'는 가장 최신 버전 번호로 대체합니다.
$(ProgramFiles)\MSBuild\Microsoft\VisualStudio\v*.0\TextTemplating
Microsoft.VisualStudio.TextTemplating.Sdk.Host.*.0.dll
Microsoft.TextTemplating.Build.Tasks.dll
Microsoft.TextTemplating.targets
$(ProgramFiles)\Microsoft Visual Studio *.0\VSSDK\VisualStudioIntegration\Common\Assemblies\v4.0
Microsoft.VisualStudio.TextTemplating.*.0.dll
Microsoft.VisualStudio.TextTemplating.Interfaces.*.0.dll(여러 파일)
Microsoft.VisualStudio.TextTemplating.VSHost.*.0.dll
$(ProgramFiles)\Microsoft Visual Studio *.0\Common7\IDE\PublicAssemblies\
- Microsoft.VisualStudio.TextTemplating.Modeling.*.0.dll
프로젝트 파일을 편집하려면
MSBuild에서 일부 특성을 구성하기 위해 프로젝트 파일을 편집해야 합니다.
솔루션 탐색기에서 프로젝트의 컨텍스트 메뉴의 언로드를 선택합니다. 이렇게 하면 XML 편집기에서 .csproj 또는 .vbproj 파일을 편집할 수 있습니다.
편집을 마치면 다시 로드를 선택합니다.
텍스트 변환 대상 가져오기
.vbproj 또는 .csproj 파일에서 다음과 같은 줄을 찾습니다.
<Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
또는
<Import Project="$(MSBuildToolsPath)\Microsoft.VisualBasic.targets" />
이 코드 뒤에 텍스트 템플릿 가져오기를 삽입합니다.
<!-- Optionally make the import portable across VS versions -->
<PropertyGroup>
<!-- Get the Visual Studio version – defaults to 10: -->
<VisualStudioVersion Condition="'$(VisualStudioVersion)' == ''">10.0</VisualStudioVersion>
<!-- Keep the next element all on one line: -->
<VSToolsPath Condition="'$(VSToolsPath)' == ''">$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)</VSToolsPath>
</PropertyGroup>
<!-- This is the important line: -->
<Import Project="$(VSToolsPath)\TextTemplating\Microsoft.TextTemplating.targets" />
빌드에서 템플릿 변환
변환 작업을 제어하기 위해 프로젝트 파일에 삽입할 수 있는 몇 가지 속성이 있습니다.
모든 빌드를 시작할 때 변환 작업을 실행합니다.
<PropertyGroup> <TransformOnBuild>true</TransformOnBuild> </PropertyGroup>예를 들어, 읽기 전용 파일은 체크 아웃되지 않기 때문에 파일을 덮어씁니다.
<PropertyGroup> <OverwriteReadOnlyOutputFiles>true</OverwriteReadOnlyOutputFiles> </PropertyGroup>항상 모든 템플릿 변환:
<PropertyGroup> <TransformOutOfDateOnly>false</TransformOutOfDateOnly> </PropertyGroup>기본적으로 T4 MSBuild 작업은 출력 파일이 명령 프로세서나 템플릿에 의해 이전에 읽혀진 파일이나 포함된 모든 파일 또는 해당 템플릿 파일보다 오래되었을 경우 출력 파일을 재생성합니다. 이는 템플릿과 출력 파일의 날짜만 비교하는 Visual Studio의 모든 템플릿 변환 명령을 사용하는 것보다 훨씬 더 강력한 종속성 테스트입니다.
프로젝트에서 텍스트 변환만 수행하려면 TransformAll 작업을 호출합니다.
msbuild myProject.csproj /t:TransformAll
특정한 텍스트 템플릿을 변환하려면 다음을 수행합니다.
msbuild myProject.csproj /t:Transform /p:TransformFile="Template1.tt"
변환 파일에서 와일드카드를 사용할 수 있습니다.
msbuild dsl.csproj /t:Transform /p:TransformFile="GeneratedCode\**\*.tt"
소스 제어
소스 제어 시스템과의 특정 기본 제공 통합은 없습니다. 그러나 예를 들어 생성된 파일을 체크 아웃하고 체크 인하기 위해 확장을 추가할 수 있습니다. 기본적으로 텍스트 변환 작업은 읽기 전용으로 표시된 파일을 덮어쓰지 않으며, 이러한 파일에 오류가 발생하면 해당 오류가 Visual Studio의 오류 목록에 로깅되고 작업은 실패합니다.
읽기 전용 파일을 덮어쓰도록 지정하려면 다음 속성을 삽입합니다.
<OverwriteReadOnlyOuputFiles>true</OverwriteReadOnlyOuputFiles>
후처리 단계를 사용자 지정하지 않는 한 파일을 덮어쓸 때 경고가 오류 목록에 기록됩니다.
빌드 프로세스 사용자 지정
빌드 프로세스에서 다른 작업을 수행하기 전에 텍스트 변환이 수행됩니다. $(BeforeTransform) 및 $(AfterTransform) 속성을 설정하여 변환 전과 후에 호출되는 작업을 정의할 수 있습니다.
<PropertyGroup>
<BeforeTransform>CustomPreTransform</BeforeTransform>
<AfterTransform>CustomPostTransform</AfterTransform>
</PropertyGroup>
<Target Name="CustomPreTransform">
<Message Text="In CustomPreTransform..." Importance="High" />
</Target>
<Target Name="CustomPostTransform">
<Message Text="In CustomPostTransform..." Importance="High" />
</Target>
AfterTransform에서 파일 목록을 참조할 수 있습니다.
GeneratedFiles - 프로세스에서 쓴 파일의 목록입니다. 기존 읽기 전용 파일을 덮어쓴 파일의 경우 %(GeneratedFiles.ReadOnlyFileOverwritten)이 true입니다. 이러한 파일은 소스 제어에서 체크 아웃할 수 있습니다.
NonGeneratedFiles - 덮어쓰지 않은 읽기 전용 파일의 목록입니다.
예를 들어, 생성된 파일을 체크 아웃하는 작업을 정의합니다.
OutputFilePath 및 OutputFileName
MSBuild에서만 이러한 속성을 사용합니다. Visual Studio의 코드 생성에는 영향을 주지 않습니다. 이러한 속성은 생성된 출력 파일을 다른 폴더 또는 파일로 리디렉션합니다. 대상 폴더가 이미 있어야 합니다.
<ItemGroup>
<None Include="MyTemplate.tt">
<Generator>TextTemplatingFileGenerator</Generator>
<OutputFilePath>MyFolder</OutputFilePath>
<LastGenOutput>MyTemplate.cs</LastGenOutput>
</None>
</ItemGroup>
리디렉션하기 유용한 폴더는 $(IntermediateOutputPath).입니다.
파일 이름을 지정하고 출력하는 경우 템플릿의 출력 지시문에 지정된 확장명보다 해당 이름이 우선적으로 적용됩니다.
<ItemGroup>
<None Include="MyTemplate.tt">
<Generator>TextTemplatingFileGenerator</Generator>
<OutputFileName>MyOutputFileName.cs</OutputFileName>
<LastGenOutput>MyTemplate.cs</LastGenOutput>
</None>
</ItemGroup>
VS에서 개별 파일 생성기를 실행하거나 모두 변환을 사용하여 템플릿을 변환하는 경우 OutputFileName이나 OutputFilePath를 지정하는 것은 권장되지 않습니다. 변환을 실행하는 방법에 따라 서로 다른 파일 경로가 지정됩니다. 이는 매우 복잡할 수 있습니다.
참조 및 포함 경로 추가
템플릿에 참조된 어셈블리를 검색할 때 호스트에 기본 경로 집합이 있습니다. 이 집합에 추가하려면 다음을 수행합니다.
<ItemGroup>
<T4ReferencePath Include="$(VsIdePath)PublicAssemblies\" />
<!-- Add more T4ReferencePath items here -->
</ItemGroup>
포함 파일을 검색할 폴더를 설정하려면 세미콜론 구분 목록을 제공합니다. 일반적으로 기존 폴더 목록에 추가합니다.
<PropertyGroup>
<IncludeFolders>
$(IncludeFolders);$(MSBuildProjectDirectory)\Include;AnotherFolder;And\Another</IncludeFolders>
</PropertyGroup>
템플릿으로 빌드 컨텍스트 데이터 전달
프로젝트 파일에서 매개 변수 값을 설정할 수 있습니다. 예를 들어, 빌드 속성 및 환경 변수를 전달할 수 있습니다.
<ItemGroup>
<T4ParameterValues Include="ProjectFolder">
<Value>$(ProjectDir)</Value>
<Visible>false</Visible>
</T4ParameterValues>
</ItemGroup>
텍스트 템플릿에서 hostspecific를 템플릿 지시문에 설정하십시오. 매개 변수 지시문을 사용하여 값을 가져 옵니다.
<#@template language="c#" hostspecific="true"#>
<#@ parameter type="System.String" name="ProjectFolder" #>
The project folder is: <#= ProjectFolder #>
지시문 프로세서에서 ResolveParameterValue를 호출할 수 있습니다.
string value = Host.ResolveParameterValue("-", "-", "parameterName");
Dim value = Host.ResolveParameterValue("-", "-", "parameterName")
참고
MSBuild를 사용하는 경우에만 ResolveParameterValue이 T4ParameterValues에서 데이터를 가져옵니다.Visual Studio를 사용하여 템플릿을 변환하는 경우 매개 변수에 기본값이 사용됩니다.
assembly 및 Include 지시문에서 프로젝트 속성 사용
$(SolutionDir)과 같은 Visual Studio 매크로는 MSBuild에서 작동하지 않습니다. 대신 적절한 프로젝트 속성을 사용할 수 있습니다.
프로젝트 속성을 정의하기 위해 .csproj 또는 .vbproj 파일을 편집합니다. 이 예제에서는 myLibFolder라는 속성을 정의합니다.
<!-- Define a project property, myLibFolder: -->
<PropertyGroup>
<myLibFolder>$(MSBuildProjectDirectory)\..\libs</myLibFolder>
</PropertyGroup>
<!-- Tell the MSBuild T4 task to make the property available: -->
<ItemGroup>
<T4ParameterValues Include="myLibFolder">
<Value>$(myLibFolder)</Value>
</T4ParameterValues>
</ItemGroup>
이제 assembly 및 Include 지시문에서 프로젝트 속성을 사용할 수 있습니다.
<#@ assembly name="$(myLibFolder)\MyLib.dll" #>
<#@ include file="$(myLibFolder)\MyIncludeFile.t4" #>
이러한 지시문은 MSBuild와 Visual Studio 호스트에서 모두 T4parameterValues의 값을 가져옵니다.
Q & A
왜 빌드 서버에서 템플릿을 변환해야 합니까? 내 코드를 체크 인하기 전에 이미 Visual Studio에서 템플릿을 변환했습니다.
포함 파일을 업데이트하거나 템플릿에서 다른 파일을 읽은 경우 Visual Studio가 파일을 자동으로 변환하지 않습니다. 빌드 중에 템플릿이 변환되면 모두 최신 상태임을 나타냅니다.
텍스트 템플릿 변환에 사용할 수 있는 다른 옵션은 무엇이 있습니까?
명령 스크립트에서 TextTransform 유틸리티를 사용할 수 있습니다. 대부분의 경우 MSBuild를 사용하는 것이 더 쉽습니다.
디자인 타임 텍스트 템플릿은 Visual Studio에 의해 변환됩니다.
런타임 텍스트 템플릿은 응용 프로그램에서 런타임에 변환됩니다.
자세히 보기
T4 MSbuild 템플릿, $(VSToolsPath)\TextTemplating\Microsoft.TextTemplating.targets의 유용한 안내서