Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

csproj의 내용을 공통 설정할 수 있는 Directory.Build.targets / Directory.Build.props 파일

다음과 같은 질문이 있군요.

C# 버전 설정 방법?
; https://forum.dotnetdev.kr/t/c/641

사실 예전에는 비주얼 스튜디오의 프로젝트 설정에서 다음과 같이 간단하게 C# 버전을 바꿀 수 있었습니다.

cs_71_1.png

하지만 근래에는 해당 옵션 설정이 막혔고,

cs8_in_netfr_1.png

프로젝트의 대상 프레임워크 별로 기본 C# 버전이 정해져 있습니다.

C# language versioning
; https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/configure-language-version

따라서 현재 .NET Framework 대상이라면 어떤 프로젝트를 생성해도 C# 7.0이 기본값이고, C# 9.0을 사용하려면 .NET 5 이상의 프로젝트를 생성해야 합니다.

물론, 기본 C# 버전을 csproj에 <LangVersion /> 설정을 이용해 재정의할 수 있습니다.

.NET Framework 프로젝트에서 C# 8.0/9.0 컴파일러를 사용하는 방법
; https://www.sysnet.pe.kr/2/0/12033#langver

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="15.0" ...[생략]... />
  <PropertyGroup>
    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
    <ProjectGuid>{4F3F253F-549E-42AD-B367-881973F0EEA4}</ProjectGuid>
    <OutputType>Exe</OutputType>
    <RootNamespace>ConsoleApp1</RootNamespace>
    <AssemblyName>ConsoleApp1</AssemblyName>
    <TargetFrameworkVersion>v4.8</TargetFrameworkVersion>
    <FileAlignment>512</FileAlignment>
    <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
    <Deterministic>true</Deterministic>
    <LangVersion>9.0</LangVersion>
  </PropertyGroup>
    // ...[생략]...
</Project>




그런데, 저 설정을 위해 매번 csproj 파일을 열어 LangVersion을 설정하는 것도 은근히 귀찮은 일입니다. 바로 이런 식의, 그러니까 생성하는 프로젝트마다 공통으로 적용되어야 할 설정이 있다면 그때 사용할 수 있는 것이 "Directory.Build.targets / Directory.Build.props"입니다.

Customize your build
; https://docs.microsoft.com/en-us/visualstudio/msbuild/customize-your-build

실제로 msbuild로 csproj를 빌드하면 현재 프로젝트의 디렉터리 위치에서 시작해 상위로 거슬러 올라가면서 "Directory.Build.targets / Directory.Build.props" 파일을 찾는 작업이 이뤄집니다. 만약 그 과정에서 해당 파일이 있으면 그 안의 설정을 csproj에 병합해 컴파일을 하게 됩니다.

따라서 여러분이 "C:\test\console_sample"이라는 디렉터리에 생성하는 모든 C# 프로젝트의 버전을 C# 9.0으로 적용하고 싶다면 다음과 같은 내용의,

<Project>
  <PropertyGroup>
    <LangVersion>9.0</LangVersion>
  </PropertyGroup>
</Project>

"Directory.Build.targets / Directory.Build.props" 파일을 만들어 "C:\" 또는 "C:\test" 또는 "C:\test\console_sample" 디렉터리에 놓으면 됩니다. 그럼 비주얼 스튜디오는 해당 디렉터리의 하위에 있는 모든 (LangVersion 설정이 없는) C# 프로젝트에 대해 C# 9.0 컴파일러를 사용해 빌드를 하게 됩니다. (상위 디렉터리 탐색 중 targets/props 파일이 발견되면 더 이상의 탐색은 하지 않습니다.)




참고로, Directory.Build.targets / Directory.Build.props 설정 후 프로젝트 빌드는 곧바로 반영이 됩니다. 반면, 편집기에서의 실시간 코드 빌드를 담당하는 프로세스는 "Directory.Build.targets / Directory.Build.props" 파일에 대한 설정을 비주얼 스튜디오의 재시작으로는 반영하지 않습니다. 예를 들어, 다음과 같이 targets (또는 props) 파일을 구성한 상태에서,

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <LangVersion>9.0</LangVersion>
  </PropertyGroup>
</Project>

C# 프로젝트를 "생성"하면 정상적으로 targets / props 설정이 반영돼 C# 9.0 문법을 사용할 수 있습니다. 하지만, 이후 targets / props에 추가 속성을 설정하면,

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <LangVersion>9.0</LangVersion>
    <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
  </PropertyGroup>
</Project>

비주얼 스튜디오를 재시작해도 기존 설정(LangVersion)은 적용돼면서, 새로운 설정(AllowUnsafeBlocks)은 반영이 안 되는 것을 볼 수 있습니다.

directory_build_target_0.png
CS0227 Unsafe code may only appear if compiling with /unsafe

테스트를 해보면, 솔루션 파일(.sln)이 있는 디렉터리에 생성된 ".vs" 폴더를 삭제 후 다시 프로젝트를 로드하는 경우 정상적으로 모든 설정이 반영되었습니다.




마지막으로, 저 설정은 로컬 컴퓨터에 상에 존재하므로 혹시나 협업을 하는 프로젝트가 있다면 targets / props 설정에 영향을 받아 동료 PC에서의 빌드 결과가 달라질 수 있다는 특별한 주의가 필요합니다.

그런 문제를 제외한다면 다른 일반적인 설정에 대해서라면 그런대로 쓸만한 해법입니다. 가령 다음과 같은 문제가 그랬습니다.

.NET Core 프로젝트를 Visual Studio에서 실행 시 System.BadImageFormatException 발생하는 경우
; https://www.sysnet.pe.kr/2/0/11545




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



donaricano-btn



[최초 등록일: ]
[최종 수정일: 6/28/2021]

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

비밀번호

댓글 쓴 사람
 




1  2  3  4  5  6  7  8  9  10  [11]  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
12618정성태4/27/2021956사물인터넷: 58. NodeMCU v1 ESP8266 CP2102 Module을 이용한 WiFi UDP 통신파일 다운로드1
12617정성태4/26/2021755.NET Framework: 1050. C# - ETW EventListener의 Keywords별 EventId에 따른 필터링 방법파일 다운로드1
12616정성태4/26/2021811.NET Framework: 1049. C# - ETW EventListener를 상속받았을 때 초기화 순서파일 다운로드1
12615정성태4/26/2021763오류 유형: 712. Microsoft Live 로그인 - 계정을 선택하는(Pick an account) 화면에서 진행이 안 되는 문제
12614정성태4/24/20211111개발 환경 구성: 570. C# - Azure AD 인증을 지원하는 ASP.NET Core/5+ 웹 애플리케이션 예제 구성 [3]파일 다운로드1
12613정성태4/23/2021842.NET Framework: 1048. C# - ETW 이벤트의 Keywords에 속한 EventId 구하는 방법 (2) 관리 코드파일 다운로드1
12612정성태4/23/2021816.NET Framework: 1047. C# - ETW 이벤트의 Keywords에 속한 EventId 구하는 방법 (1) PInvoke파일 다운로드1
12611정성태4/22/2021741오류 유형: 711. 닷넷 EXE 실행 오류 - Mixed mode assembly is build against version 'v2.0.50727' of the runtime
12610정성태4/22/2021849.NET Framework: 1046. C# - 컴파일 시점에 참조할 수 없는 타입을 포함한 이벤트 핸들러를 Reflection을 이용해 구독하는 방법파일 다운로드1
12609정성태4/22/20211051.NET Framework: 1045. C# - 런타임 시점에 이벤트 핸들러를 만들어 Reflection을 이용해 구독하는 방법파일 다운로드1
12608정성태4/21/20211224.NET Framework: 1044. C# - Generic Host를 이용해 .NET 5로 리눅스 daemon 프로그램 만드는 방법 [7]파일 다운로드1
12607정성태4/21/2021989.NET Framework: 1043. C# - 실행 시점에 동적으로 Delegate 타입을 만드는 방법파일 다운로드1
12606정성태4/21/20211020.NET Framework: 1042. C# - enum 값을 int로 암시적(implicit) 형변환하는 방법? [2]파일 다운로드1
12605정성태4/18/2021840.NET Framework: 1041. C# - AssemblyID, ModuleID를 관리 코드에서 구하는 방법파일 다운로드1
12604정성태4/18/2021811VS.NET IDE: 163. 비주얼 스튜디오 속성 창의 "Build(빌드)" / "Configuration(구성)"에서의 "활성" 의미
12603정성태4/16/2021848VS.NET IDE: 162. 비주얼 스튜디오 - 상속받은 컨트롤이 디자인 창에서 지원되지 않는 문제
12602정성태4/16/20211158VS.NET IDE: 161. x64 DLL 프로젝트의 컨트롤이 Visual Studio의 Designer에서 보이지 않는 문제
12601정성태4/15/2021874.NET Framework: 1040. C# - REST API 대신 github 클라이언트 라이브러리를 통해 프로그래밍으로 접근
12600정성태4/15/2021907.NET Framework: 1039. C# - Kubeconfig의 token 설정 및 인증서 구성을 자동화하는 프로그램
12599정성태4/14/2021846.NET Framework: 1038. C# - 인증서 및 키 파일로부터 pfx/p12 파일을 생성하는 방법파일 다운로드1
12598정성태4/14/2021848.NET Framework: 1037. openssl의 PEM 개인키 파일을 .NET RSACryptoServiceProvider에서 사용하는 방법 (2)파일 다운로드1
12597정성태4/13/2021806개발 환경 구성: 569. csproj의 내용을 공통 설정할 수 있는 Directory.Build.targets / Directory.Build.props 파일
12596정성태4/12/2021958개발 환경 구성: 568. Windows의 80 포트 점유를 해제하는 방법
12595정성태4/12/2021780.NET Framework: 1036. SQL 서버 - varbinary 타입에 대한 문자열의 CAST, CONVERT 변환을 C# 코드로 구현
12594정성태4/11/2021903.NET Framework: 1035. C# - kubectl 명령어 또는 REST API 대신 Kubernetes 클라이언트 라이브러리를 통해 프로그래밍으로 접근 [1]파일 다운로드1
12593정성태4/10/2021917개발 환경 구성: 567. Docker Desktop for Windows - kubectl proxy 없이 k8s 대시보드 접근 방법
1  2  3  4  5  6  7  8  9  10  [11]  12  13  14  15  ...