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

비밀번호

댓글 작성자
 




1  2  3  4  5  6  7  8  9  10  11  12  13  [14]  15  ...
NoWriterDateCnt.TitleFile(s)
12740정성태7/29/20211047오류 유형: 747. SharePoint - InvalidOperationException 0x80131509
12739정성태7/28/20211015오류 유형: 746. Azure Active Directory - IDW10106: The 'ClientId' option must be provided.
12738정성태7/28/20211278오류 유형: 745. Azure Active Directory - Client credential flows must have a scope value with /.default suffixed to the resource identifier (application ID URI).
12737정성태7/28/2021850오류 유형: 744. Azure Active Directory - The resource principal named api://...[client_id]... was not found in the tenant
12736정성태7/28/2021845오류 유형: 743. Active Azure Directory에서 "API permissions"의 권한 설정이 "Not granted for ..."로 나오는 문제
12735정성태7/27/20211097.NET Framework: 1081. C# - Azure AD 인증을 지원하는 데스크톱 애플리케이션 예제(Windows Forms)파일 다운로드1
12734정성태7/26/20215476스크립트: 20. 특정 단어로 시작하거나/끝나는 문자열을 포함/제외하는 정규 표현식 - Look-around
12733정성태7/23/20211081.NET Framework: 1081. Self-Contained/SingleFile 유형의 .NET Core/5+ 실행 파일을 임베딩한다면? [1]파일 다운로드2
12732정성태7/23/2021739오류 유형: 742. SharePoint - The super user account utilized by the cache is not configured.
12731정성태7/23/2021730개발 환경 구성: 584. Add Internal URLs 화면에서 "Save" 버튼이 비활성화 된 경우
12730정성태7/23/20211194개발 환경 구성: 583. Visual Studio Code - Go 코드에서 입력을 받는 경우
12729정성태7/22/2021918.NET Framework: 1080. xUnit 단위 테스트에 메서드/클래스 수준의 문맥 제공 - Fixture
12728정성태7/22/2021755.NET Framework: 1079. MSTestv2 단위 테스트에 메서드/클래스/어셈블리 수준의 문맥 제공
12727정성태7/21/20211168.NET Framework: 1078. C# 단위 테스트 - MSTestv2/NUnit의 Assert.Inconclusive 사용법(?)
12726정성태7/21/2021981VS.NET IDE: 169. 비주얼 스튜디오 - 단위 테스트 선택 시 MSTestv2 외의 xUnit, NUnit 사용법
12725정성태7/21/20211185오류 유형: 741. Failed to find the "go" binary in either GOROOT() or PATH
12724정성태7/21/20211991개발 환경 구성: 582. 윈도우 환경에서 Visual Studio Code + Go (Zip) 개발 환경 [1]
12723정성태7/21/2021915오류 유형: 740. SharePoint - Alternate access mappings have not been configured 경고
12722정성태7/20/2021872오류 유형: 739. MSVCR110.dll이 없어 exe 실행이 안 되는 경우
12721정성태7/20/2021964오류 유형: 738. The trust relationship between this workstation and the primary domain failed. - 세 번째 이야기
12720정성태7/19/2021789Linux: 43. .NET Core/5+ 응용 프로그램의 Ubuntu (Debian) 패키지 준비
12719정성태7/19/2021828오류 유형: 737. SharePoint 설치 시 "0x800710D8 The object identifier does not represent a valid object." 오류 발생
12718정성태7/19/2021843개발 환경 구성: 581. Windows에서 WSL로 파일 복사 시 root 소유권으로 적용되는 문제파일 다운로드1
12717정성태7/18/2021962Windows: 195. robocopy에서 파일의 ADS(Alternate Data Stream) 정보 복사를 제외하는 방법
12716정성태7/17/20211076개발 환경 구성: 580. msbuild의 Exec Task에 robocopy를 사용하는 방법파일 다운로드1
12715정성태7/17/20211901오류 유형: 736. Windows - MySQL zip 파일 버전의 "mysqld --skip-grant-tables" 실행 시 비정상 종료
1  2  3  4  5  6  7  8  9  10  11  12  13  [14]  15  ...