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




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







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

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

비밀번호

댓글 작성자
 




... 16  17  18  [19]  20  21  22  23  24  25  26  27  28  29  30  ...
NoWriterDateCnt.TitleFile(s)
12639정성태5/12/20211729오류 유형: 715. Arduino: Open Serial Monitor - The module '...\detection.node' was compiled against a different Node.js version using NODE_MODULE_VERSION
12638정성태5/12/20212071사물인터넷: 63. NodeMCU v1 ESP8266 - 펌웨어 내 파일 시스템(SPIFFS, LittleFS) 및 EEPROM 활용
12637정성태5/10/20211915사물인터넷: 62. NodeMCU v1 ESP8266 보드의 A0 핀에 다중 아날로그 센서 연결 [1]
12636정성태5/10/20212284사물인터넷: 61. NodeMCU v1 ESP8266 보드의 A0 핀 사용법 - FSR-402 아날로그 압력 센서 연동파일 다운로드1
12635정성태5/9/20212032기타: 81. OpenTabletDriver를 (관리자 권한으로 실행하지 않고도) 관리자 권한의 프로그램에서 동작하게 만드는 방법
12634정성태5/9/20212087개발 환경 구성: 572. .NET에서의 신뢰도 등급 조정 - 외부 Manifest 파일을 두는 방법파일 다운로드1
12633정성태5/7/20212213개발 환경 구성: 571. UAC - 관리자 권한 없이 UIPI 제약을 없애는 방법
12632정성태5/7/20212039기타: 80. (WACOM도 지원하는) Tablet 공통 디바이스 드라이버 - OpenTabletDriver
12631정성태5/5/20211920사물인터넷: 60. ThingSpeak 사물인터넷 플랫폼에 ESP8266 NodeMCU v1 + 조도 센서 장비 연동파일 다운로드1
12630정성태5/5/20211967사물인터넷: 59. NodeMCU v1 ESP8266 보드의 A0 핀 사용법 - CdS Cell(GL3526) 조도 센서 연동파일 다운로드1
12629정성태5/5/20212375.NET Framework: 1057. C# - CoAP 서버 및 클라이언트 제작 (UDP 소켓 통신)파일 다운로드1
12628정성태5/4/20211849Linux: 39. Eclipse 원격 디버깅 - Cannot run program "gdb": Launching failed
12627정성태5/4/20212155Linux: 38. 라즈베리 파이 제로 용 프로그램 개발을 위한 Eclipse C/C++ 윈도우 환경 설정
12626정성태5/3/20212300.NET Framework: 1056. C# - Thread.Suspend 호출 시 응용 프로그램 hang 현상 (2)파일 다운로드1
12625정성태5/3/20211955오류 유형: 714. error CS5001: Program does not contain a static 'Main' method suitable for an entry point
12624정성태5/2/20212750.NET Framework: 1055. C# - struct/class가 스택/힙에 할당되는 사례 정리 [6]파일 다운로드1
12623정성태5/2/20212145.NET Framework: 1054. C# 9 최상위 문에 STAThread 사용 [1]파일 다운로드1
12622정성태5/2/20211674오류 유형: 713. XSD 파일을 포함한 프로젝트 - The type or namespace name 'TypedTableBase<>' does not exist in the namespace 'System.Data'
12621정성태5/1/20212245.NET Framework: 1053. C# - 특정 레지스트리 변경 시 알림을 받는 방법파일 다운로드1
12620정성태4/29/20212832.NET Framework: 1052. C# - 왜 구조체는 16 바이트의 크기가 적합한가? [1]파일 다운로드1
12619정성태4/28/20212725.NET Framework: 1051. C# - 구조체의 크기가 16바이트가 넘어가면 힙에 할당된다? [1]파일 다운로드1
12618정성태4/27/20212083사물인터넷: 58. NodeMCU v1 ESP8266 CP2102 Module을 이용한 WiFi UDP 통신파일 다운로드1
12617정성태4/26/20211793.NET Framework: 1050. C# - ETW EventListener의 Keywords별 EventId에 따른 필터링 방법파일 다운로드1
12616정성태4/26/20211786.NET Framework: 1049. C# - ETW EventListener를 상속받았을 때 초기화 순서파일 다운로드1
12615정성태4/26/20211495오류 유형: 712. Microsoft Live 로그인 - 계정을 선택하는(Pick an account) 화면에서 진행이 안 되는 문제
12614정성태4/24/20212124개발 환경 구성: 570. C# - Azure AD 인증을 지원하는 ASP.NET Core/5+ 웹 애플리케이션 예제 구성 [4]파일 다운로드1
... 16  17  18  [19]  20  21  22  23  24  25  26  27  28  29  30  ...