본문 바로가기

C#

[C#] .props 파일로 NuGet 패키지 자동 설치 설정하기

.props 파일로 NuGet 패키지 자동 설치 설정하기

C# 프로젝트를 개발하면서 여러 NuGet 패키지를 사용하다 보면, 프로젝트마다 개별적으로 패키지를 추가하는 것이 번거로울 때가 있습니다. 특히 여러 프로젝트에서 공통적으로 사용하는 패키지를 일괄적으로 관리하고 싶을 때 유용한 방법이 바로 .props 파일을 활용하는 것입니다. 이 글에서는 .props 파일을 통해 NuGet 패키지를 자동으로 관리하는 방법을 알아보겠습니다.

1. .props 파일이란?

.props 파일은 MSBuild에서 사용하는 설정 파일로, 프로젝트 파일에 특정 설정을 적용할 때 사용됩니다. 이 파일을 통해 프로젝트가 빌드될 때 자동으로 필요한 NuGet 패키지를 설치하도록 설정할 수 있습니다. 특히 공통된 패키지 목록을 한 곳에서 관리할 수 있어 편리합니다.

2. .props 파일 생성하기

먼저, 루트 디렉토리 또는 공유할 경로에 .props 파일을 생성합니다. 여러 프로젝트에서 공통적으로 사용하려면 Directory.Build.props 파일명을 사용하는 것이 좋습니다. 이렇게 하면, 해당 디렉토리 하위의 모든 프로젝트에 자동으로 적용됩니다.

예시

예를 들어, Directory.Build.props 파일을 다음과 같이 설정합니다:

<Project>
  <ItemGroup>
    <!-- 설치할 NuGet 패키지 목록 -->
    <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
    <PackageReference Include="Serilog" Version="2.10.0" />
  </ItemGroup>
</Project>​

위 코드에서는 Newtonsoft.Json과 Serilog 패키지를 프로젝트가 빌드될 때 자동으로 설치하도록 설정했습니다.

3. 프로젝트에서 .props 파일 참조하기

Directory.Build.props 파일을 사용할 경우, 프로젝트마다 별도로 참조할 필요가 없습니다. 하지만, 특정 경로에 저장된 .props 파일을 특정 프로젝트에서만 참조하고 싶다면, .csproj 파일에서 <Import> 태그를 사용해 직접 참조할 수 있습니다.

<Project Sdk="Microsoft.NET.Sdk">
  <Import Project="..\path\to\your.props" />
  <!-- 기타 프로젝트 설정 -->
</Project>
 

4. 빌드하고 NuGet 패키지 자동 설치하기

설정이 완료되면, Visual Studio 또는 dotnet build 명령어를 통해 프로젝트를 빌드해보세요.

빌드 시 .props 파일에 정의된 NuGet 패키지가 자동으로 다운로드되고 설치됩니다.

이를 통해 패키지 관리가 간편해지고, 중복 설정을 줄일 수 있습니다.

5. 마무리

.props 파일을 사용하면 NuGet 패키지를 중앙에서 관리할 수 있어 개발 환경을 보다 효율적으로 관리할 수 있습니다. 여러 프로젝트에서 공통으로 사용하는 패키지를 일괄적으로 적용할 수 있어 코드베이스 관리가 한결 수월해집니다. 여러분도 .props 파일을 활용해 프로젝트를 더 효율적으로 관리해보세요!