Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 5개 있습니다.)
(시리즈 글이 10개 있습니다.)
VS.NET IDE: 60. Output 경로에 매크로 상수 사용하는 방법
; https://www.sysnet.pe.kr/2/0/688

개발 환경 구성: 91. MSBuild를 이용한 닷넷 응용프로그램의 플랫폼(x86/x64)별 빌드
; https://www.sysnet.pe.kr/2/0/963

개발 환경 구성: 93. MSBuild를 이용한 닷넷 응용프로그램의 다중 어셈블리 출력 빌드
; https://www.sysnet.pe.kr/2/0/965

개발 환경 구성: 102. MSBuild - DefineConstants에 다중 전처리 값 설정
; https://www.sysnet.pe.kr/2/0/988

개발 환경 구성: 115. MSBuild - x86/x64, .NET 2/4, debug/release 빌드에 대한 배치 처리
; https://www.sysnet.pe.kr/2/0/1017

개발 환경 구성: 372. MSBuild - 빌드 전/후, 배포 전/후 실행하고 싶은 Task 정의
; https://www.sysnet.pe.kr/2/0/11507

개발 환경 구성: 452. msbuild - csproj에 환경 변수 조건 사용
; https://www.sysnet.pe.kr/2/0/11985

개발 환경 구성: 580. msbuild의 Exec Task에 robocopy를 사용하는 방법
; https://www.sysnet.pe.kr/2/0/12716

개발 환경 구성: 693. msbuild - .NET Core/5+ 프로젝트에서 resgen을 이용한 리소스 파일 생성 방법
; https://www.sysnet.pe.kr/2/0/13481

닷넷: 2235. MSBuild - AccelerateBuildsInVisualStudio 옵션
; https://www.sysnet.pe.kr/2/0/13593




MSBuild - 빌드 전/후, 배포 전/후 실행하고 싶은 Task 정의

msbuild도 다른 빌드 도구들처럼 사용자가 임의로 Task를 작성해 추가할 수 있습니다. 예를 들면서 설명해 보면!

예제를 위해 Console Application 프로젝트를 하나 만들고 .csproj 파일의 내용에 다음과 같이 추가해 줍니다.

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
...[생략]...

  <ItemGroup>
    <None Include="App.config" />
  </ItemGroup>
  <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />

  <Target Name="BeforeBuild">
       <Message Importance="high" Text="BeforeBuild(high) - Message Task $(MSBuildProjectFile)" /> 
       <Message Importance="normal" Text="BeforeBuild(normal) - Message Task $(MSBuildProjectFile)" /> 
  </Target>

  <Target Name="AfterBuild">
       <Message Importance="high" Text="AfterBuild - Message Task $(MSBuildProjectFile)" /> 
  </Target>

</Project>

이후 해당 프로젝트를 빌드하면 출력 창에 다음과 같은 내용을 확인할 수 있습니다.

1>------ Rebuild All started: Project: ConsoleApp1, Configuration: Debug Any CPU ------
1>  BeforeBuild(high) - Message Task ConsoleApp1.csproj
1>  ConsoleApp1 -> E:\ConsoleApp1\ConsoleApp1\bin\Debug\ConsoleApp1.exe
1>  AfterBuild - Message Task ConsoleApp1.csproj
========== Rebuild All: 1 succeeded, 0 failed, 0 skipped ==========

msbuild는 Microsoft.CSharp.targets 파일 내에서 빌드의 전/후에 각각 BeforeBuild와 AfterBuild에 대한 Target이 정의되어 있으면 이를 호출하도록 하고 있기 때문에 저렇게 Message Task가 동작하게 되는 것입니다.




msbuild 스크립트 파일(C# 프로젝트인 경우 .csproj 파일)도 C++의 #include와 유사하게 다른 스크립트 파일을 import 노드를 이용해 포함할 수 있습니다. 일반적으로 비주얼 스튜디오에서 만든 C# 프로젝트는 다음의 스크립트 파일을 포함합니다.

<!-- %ProgramFiles(x86)%\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\Microsoft.CSharp.targets --> 
<Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />

위의 Microsoft.CSharp.targets은 다시 .NET Framework이 설치된 폴더의 Microsoft.CSharp.targets을 import합니다.

<!-- C:\Windows\Microsoft.NET\Framework\v4.0.30319\Microsoft.CSharp.targets --> 
<CSharpTargetsPath>$(MSBuildFrameworkToolsPath)\Microsoft.CSharp.targets</CSharpTargetsPath>

.NET 설치 폴더에 있는 Microsoft.CSharp.targets은 동일 폴더의 Microsoft.Common.targets을 import하는데,

<!-- C:\Windows\Microsoft.NET\Framework\v4.0.30319\Microsoft.Common.targets --> 
<Import Project="Microsoft.Common.targets" />

(이 외에 프로젝트 유형에 따라 필요한 .targets 파일들이 import됩니다.)

바로 저 파일에 BeforeBuild와 AfterBuild가 이런 식으로 정의되어 있습니다.

  <PropertyGroup>
    <BuildDependsOn>
      BeforeBuild;
      CoreBuild;
      AfterBuild
    </BuildDependsOn>
  </PropertyGroup>

  <!--
    ============================================================
                                        BeforeBuild
    Redefine this target in your project in order to run tasks just before Build
    ============================================================
    -->
  <Target Name="BeforeBuild"/>

  <!--
    ============================================================
                                        AfterBuild
    Redefine this target in your project in order to run tasks just after Build
    ============================================================
    -->
  <Target Name="AfterBuild"/>

하지만, 저것은 로슬린 이전에 그랬고 Roslyn이 도입되면서 다음의 .targets 파일이 import 되고,

C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\Roslyn\Microsoft.CSharp.Core.targets

Microsoft.CSharp.Core.targets 파일에서 다시 import하는 아래의 파일에 BeforeBuild, AfterBuild가 정의되어 있습니다.

C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\Microsoft.Common.CurrentVersion.targets

로슬린 전/후에 상관없이 BeforeBuild/AfterBuild의 처리 방식은 본격적인 빌드 작업을 담당하는 CoreBuild의 전/후에 비어 있는 Target 작업을 하나씩 미리 정의해 둔 것으로 동일합니다. 그런데 여기서 주의할 점이 하나 있습니다. 주석에 써진 데로 이것은 "redefine"이기 때문에 동일한 Target Name을 갖는 작업이 2개 이상 정의되어 있으면 나중에 정의된 것이 덮어써서 동작하는 부작용이 있습니다. 가령, Microsoft.Common.CurrentVersion.targets 파일을 편집해 BeforeBuild를 다음과 같이 수정했다면,

<Target Name="BeforeBuild">
    <Message Importance="high" Text="===================" />
</Target>

이후 여러분들의 .csproj 파일에서 BeforeBuild Target을 재정의하지 않았다면 빌드 시 "===================" 메시지가 보이겠지만, 재정의하는 순간부터 저 메시지를 볼 수 없습니다.

이와 함께 또 다른 문제가 있는데요, msbuild의 모든 Target 작업들이 저런 식으로 Befoer, Core, After와 같은 식으로 정의된 것은 아니기 때문에 다른 작업의 전/후로 어떤 처리를 하고 싶다면 Core를 복사해서 Before/After를 처리하는 구조로 변경해야 하는 등의 번거로움이 있습니다.

그리고 바로 이런 2가지의 문제를 극복하기 위해 나온 것이 MSBuild 4.0 이후부터 제공되는 Target 노드의 BeforeTargets / AfterTargets 속성입니다. 이를 이용하면 기존 BeforeBuild와 AfterBuild를 다음과 같은 형식으로 정의할 수 있습니다.

<Target Name="MyBeforeBuild" BeforeTargets="CoreBuild">
    <Message Text="Project File Name: $(MSBuildProjectFile)" /> 
</Target>

<Target Name="MyAfterBuild" AfterTargets="CoreBuild">
    <Message Text="Project File Name: $(MSBuildProjectFile)" /> 
</Target>




CoreBuild가 BeforeBuild/AfterBuild를 제공하는 것처럼, Publish 작업 역시 BeforePublish, AfterPublish를 제공합니다. 따라서, 배포(Publish) 전/후에 Target Task를 추가하는 것은 .csproj 파일에 다음과 같이 추가만 해주면 됩니다.

<Target Name="BeforePublish">
    <Message Importance="high" Text="=BeforePublish=" />
</Target>

<Target Name="AfterPublish">
    <Message Importance="high" Text="=AfterPublish=" />
</Target>

그런데, BeforePublish, AfterPublish를 정의하기 보단 BeforeTargets/AfterTargets을 이용한 정의가 더 낫습니다. 왜냐하면 일부 (예: ASP.NET Core 웹 애플리케이션) 프로젝트의 경우 BeforePublish, AfterPublish를 정의하면 실행이 안되는 반면 BeforeTargets/AfterTargets으로 다음과 같이 정의하면 실행이 잘 됩니다.

<Target Name="MyBeforePublish" BeforeTargets="Publish">
    <Message Importance="high" Text="$(MSBuildProjectFile)" /> 
</Target>

<Target Name="MyAfterPublish" AfterTargets="Publish">
    <Message Importance="high" Text="$(MSBuildProjectFile)" /> 
</Target>

참고로, 여러분들의 빌드 작업에 어떤 target 작업들이 실행되고 있는지 보고 싶다면 비주얼 스튜디오의 "TOOLS" / "Options" 메뉴에서 "Projects and Solutions" / "Build and Run" 범주의 "MSBuild project build output verbosity" 항목을 "Minimal"에서 다른 세부 항목 값으로 설정하면 됩니다.

sysmon_test_2.png

또한, 이 글의 예제에서 Message Task의 Importance 설정을 high로 했는데, 기본 값인 normal(또는 low)로 설정한 경우 위의 verbosity 설정 수준에 따라 출력 유무가 결정됩니다. (즉, 기본 verbosity 설정인 Minimal에서는 high로 설정한 메시지들만 Output 창에 보입니다.)

그 외에, msbuild 스크립트에서 사용 가능한 변수들의 목록은 다음의 글을 참고할 수 있습니다.

MSBuildToolsPath: C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin
MSBuildFrameworkToolsPath: C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\

Team Build에 사용되는 각종 Property 값
; https://www.sysnet.pe.kr/2/0/508




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 2/21/2022]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




... 46  47  48  49  50  51  [52]  53  54  55  56  57  58  59  60  ...
NoWriterDateCnt.TitleFile(s)
12329정성태9/16/202012345오류 유형: 650. ASUS 메인보드 관련 소프트웨어 설치 후 ArmouryCrate.UserSessionHelper.exe 프로세스 무한 종료 현상
12328정성태9/16/202012531VS.NET IDE: 150. TFS의 이력에서 "Get This Version"과 같은 기능을 Git으로 처리한다면?
12327정성태9/12/202010145.NET Framework: 938. C# - ICS(Internet Connection Sharing) 제어파일 다운로드1
12326정성태9/12/20209642개발 환경 구성: 516. Azure VM의 Network Adapter를 실수로 비활성화한 경우
12325정성태9/12/20209219개발 환경 구성: 515. OpenVPN - 재부팅 후 ICS(Internet Connection Sharing) 기능이 동작 안하는 문제
12324정성태9/11/202010459개발 환경 구성: 514. smigdeploy.exe를 이용한 Windows Server 2016에서 2019로 마이그레이션 방법
12323정성태9/11/20209388오류 유형: 649. Copy Database Wizard - The job failed. Check the event log on the destination server for details.
12322정성태9/11/202010324개발 환경 구성: 513. Azure VM의 RDP 접속 위치 제한 [1]
12321정성태9/11/20208722오류 유형: 648. netsh http add urlacl - Error: 183 Cannot create a file when that file already exists.
12320정성태9/11/20209906개발 환경 구성: 512. RDP(원격 데스크톱) 접속 시 비밀 번호를 한 번 더 입력해야 하는 경우
12319정성태9/10/20209661오류 유형: 647. smigdeploy.exe를 Windows Server 2016에서 실행할 때 .NET Framework 미설치 오류 발생
12318정성태9/9/20209151오류 유형: 646. OpenVPN - "TAP-Windows Adapter V9" 어댑터의 "Network cable unplugged" 현상
12317정성태9/9/202011455개발 환경 구성: 511. Beats용 Kibana 기본 대시 보드 구성 방법
12316정성태9/8/20209890디버깅 기술: 170. WinDbg Preview 버전부터 닷넷 코어 3.0 이후의 메모리 덤프에 대해 sos.dll 자동 로드
12315정성태9/7/202012173개발 환경 구성: 510. Logstash - FileBeat을 이용한 IIS 로그 처리 [2]
12314정성태9/7/202010579오류 유형: 645. IIS HTTPERR - Timer_MinBytesPerSecond, Timer_ConnectionIdle 로그
12313정성태9/6/202011898개발 환경 구성: 509. Logstash - 사용자 정의 grok 패턴 추가를 이용한 IIS 로그 처리
12312정성태9/5/202015848개발 환경 구성: 508. Logstash 기본 사용법 [2]
12311정성태9/4/202011024.NET Framework: 937. C# - 간단하게 만들어 보는 리눅스의 nc(netcat), json_pp 프로그램 [1]
12310정성태9/3/202010274오류 유형: 644. Windows could not start the Elasticsearch 7.9.0 (elasticsearch-service-x64) service on Local Computer.
12309정성태9/3/202010028개발 환경 구성: 507. Elasticsearch 6.6부터 기본 추가된 한글 형태소 분석기 노리(nori) 사용법
12308정성태9/2/202011260개발 환경 구성: 506. Windows - 단일 머신에서 단일 바이너리로 여러 개의 ElasticSearch 노드를 실행하는 방법
12307정성태9/2/202012051오류 유형: 643. curl - json_parse_exception / Invalid UTF-8 start byte
12306정성태9/1/202010196오류 유형: 642. SQL Server 시작 오류 - error code 10013
12305정성태9/1/202011106Windows: 172. "Administered port exclusions"이 아닌 포트 범위 항목을 삭제하는 방법
12304정성태8/31/202010055개발 환경 구성: 505. 윈도우 - (네트워크 어댑터의 우선순위로 인한) 열거되는 IP 주소 순서를 조정하는 방법
... 46  47  48  49  50  51  [52]  53  54  55  56  57  58  59  60  ...