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

Visual Studio 2017 - NuGet 패키지를 직접 참조하는 PackageReference 지원

일반적으로 DLL 어셈블리를 참조할 때 Visual Studio에서 프로젝트나 파일 참조를 하게 되는데요. Visual Studio 2017부터는 NuGet에 등록된 패키지를 직접 참조할 수 있는 PackageReference 유형을 새롭게 지원하기 시작했습니다.

Package references (PackageReference) in project files
; https://docs.microsoft.com/en-us/nuget/consume-packages/package-references-in-project-files

(아쉽게도) .NET Framework 응용 프로그램에서는 아직 지원하지 않고 ".NET Core", ".NET Standard"와 (윈도우 10 빌드 15063 이상의) UWP 프로젝트에서만 제공됩니다.




예를 들어, AutoMapper를 NuGet을 통해 설치해 볼까요? .NET Framework 용 Console 프로젝트의 경우 설치를 하면 .sln 파일이 있는 폴더에 /packages 하위 폴더가 생성되고 그 안에 AutoMapper 관련 어셈블리들이 NuGet을 통해 구성됩니다. 이와 함께 대상 프로젝트 폴더에 생성된 packages.config 파일은 프로젝트에 포함한 /packages 폴더의 구성 요소를 지정합니다.

<?xml version="1.0" encoding="utf-8"?>
<packages>
  <package id="AutoMapper" version="6.1.1" targetFramework="net47" />
</packages>

이때의 .csproj 파일을 보면 /packages 하위의 어셈블리에 대한 경로를 참조로 포함하고 있습니다.

<ItemGroup>
    <Reference Include="AutoMapper, Version=6.1.1.0, Culture=neutral, PublicKeyToken=be96cd2c38ef1005, processorArchitecture=MSIL">
        <HintPath>..\packages\AutoMapper.6.1.1\lib\net45\AutoMapper.dll</HintPath>
    </Reference>
</ItemGroup>

당연히 빌드하면 /bin/Debug 하위에 ConsoleApp1.exe 파일과 함께 AutoMapper.dll이 함께 배포됩니다.

그렇다면 PackageReference는 어떤 차이점이 있을까요?

.NET Core 프로젝트를 만들고 NuGet으로부터 AutoMapper를 추가하면 /packages 폴더가 생성되지 않습니다. 게다가 .csproj 파일의 참조 구성은 다음과 같습니다.

<ItemGroup>
    <PackageReference Include="AutoMapper" Version="6.1.1" />
</ItemGroup>

빌드를 하면 \bin\Debug\netcoreapp2.0 폴더에 ConsoleApp1.dll 파일이 생성되지만 AutoMapper.dll은 없습니다. Viausl Studio는 실행 시 exec 옵션을 주고,

"C:\Program Files (x86)\dotnet\dotnet.exe"  exec "D:\ConsoleApp1\bin\Debug\netcoreapp2.0\ConsoleApp1.dll" 

실행에 필요한 AutoMapper.dll은 다음의 경로에서 구합니다.

%USERPROFILE%\.nuget\packages\automapper\6.1.1\lib\netstandard1.3\AutoMapper.dll

즉, 로컬 PC에 구성된 NuGet repository로부터 PackageReference 참조된 어셈블리를 구해 로드하는 것입니다. 물론 이 정보는 ConsoleApp1.dll에 들어있는 것이 아니고 dotnet.exe가 그렇게 로딩을 해주는 것입니다. 그럼 배포는 어떻게 될까요? 비주얼 스튜디오에서 PackageReference를 포함한 프로젝트를 배포(Publish)하면 관련 DLL들을 모두 출력해 주니 다른 컴퓨터에 복사해서 실행할 수 있는 완전한 바이너리들을 얻는데 문제가 없습니다.




보통 프로젝트를 하다 보면 NuGet으로부터 받은 다양한 패키지들 때문에 /packages 폴더가 비대해지기 마련입니다. 개발자 PC에 프로젝트가 많아질수록 쓸데없이 /packages로 인한 용량도 늘어납니다. PackageReference는 이런 지저분한 문제들을 아주 깔끔하게 처리해 줍니다. ^^

지금까지... 다소 신기능인 듯 PackageReference를 소개했지만, 따지고 보면 별 의미가 없는 지원이기도 합니다. 왜냐하면 이미 이전부터 .NET Core, UWP 프로젝트는 NuGet 참조를 하는 경우 PackageReference와 동일하게 /packages 폴더가 생성되지 않고 단지 project.json에 다음과 같이 참조된 항목만 기록되었기 때문입니다.

{
  "version": "1.0.0-*",

    "dependencies": {
        "AutoMapper": "6.1.1",
        "NETStandard.Library": "1.6.0"
    },

  "frameworks": {
    "netstandard1.6": {
      "imports": "dnxcore50"
    }
  }
}

그렇긴 하지만, .csproj에 PackageReference라는 노드가 추가되었기 때문에 아마도 나중에는 윈도우 용 닷넷 프레임워크에도 도입되지 않을까 하는 기대감을 갖게 만듭니다. ^^

참고로, PackageReference는 IncludeAssets, ExcludeAssets, PrivateAssets 하위 노드를 포함할 수 있고 그중에 PrivateAssets은 project.json에 있던 suppressParent 옵션과 같은 역할을 합니다. suppressParent은 다음의 글에서 찾아볼 수 있습니다.

[Spec] Managing dependency package assets
; https://github.com/NuGet/Home/wiki/%5BSpec%5D-Managing-dependency-package-assets




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

[연관 글]


donaricano-btn



[최초 등록일: ]
[최종 수정일: 8/26/2017 ]

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

비밀번호

댓글 쓴 사람
 



2021-04-16 11시24분
AutoMapper/AutoMapper - A convention-based object-object mapper in .NET.
; https://github.com/AutoMapper/AutoMapper
정성태

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
12645정성태5/14/20213사물인터넷: 64. NodeMCU v1 ESP8266 - LittleFS를 이용한 와이파이 접속 정보 업데이트파일 다운로드1
12644정성태5/14/20211오류 유형: 719. 윈도우 - 제어판의 "프로그램 및 기능" / "Windows 기능 켜기/끄기" 오류 0x800736B3
12643정성태5/14/20212오류 유형: 718. 서버 유형의 COM+ 사용 시 0x80080005(Server execution failed) 오류 발생
12642정성태5/14/20212오류 유형: 717. The 'Microsoft.ACE.OLEDB.12.0' provider is not registered on the local machine.
12641정성태5/13/202143디버깅 기술: 179. 윈도우 용 .NET Core 3 이상에서 Windbg의 sos 사용법
12640정성태5/13/202118오류 유형: 716. RDP 연결 - Because of a protocol error (code: 0x112f), the remote session will be disconnected.
12639정성태5/12/202115오류 유형: 715. Arduino: Open Serial Monitor - The module '...\detection.node' was compiled against a different Node.js version using NODE_MODULE_VERSION
12638정성태5/12/202135사물인터넷: 63. NodeMCU v1 ESP8266 - 펌웨어 내 파일 시스템(SPIFFS, LittleFS) 및 EEPROM 활용
12637정성태5/10/202140사물인터넷: 62. NodeMCU v1 ESP8266 보드의 A0 핀에 다중 아날로그 센서 연결
12636정성태5/10/202147사물인터넷: 61. NodeMCU v1 ESP8266 보드의 A0 핀 사용법 - FSR-402 아날로그 압력 센서 연동파일 다운로드1
12635정성태5/9/202160기타: 81. OpenTabletDriver를 (관리자 권한으로 실행하지 않고도) 관리자 권한의 프로그램에서 동작하게 만드는 방법
12634정성태5/9/202162개발 환경 구성: 572. .NET에서의 신뢰도 등급 조정 - 외부 Manifest 파일을 두는 방법파일 다운로드1
12633정성태5/7/202193개발 환경 구성: 571. UAC - 관리자 권한 없이 UIPI 제약을 없애는 방법
12632정성태5/8/202198기타: 80. (WACOM도 지원하는) Tablet 공통 디바이스 드라이버 - OpenTabletDriver
12631정성태5/7/2021107사물인터넷: 60. ThingSpeak 사물인터넷 플랫폼에 ESP8266 NodeMCU v1 + 조도 센서 장비 연동파일 다운로드1
12630정성태5/12/202179사물인터넷: 59. NodeMCU v1 ESP8266 보드의 A0 핀 사용법 - CdS Cell(GL3526) 조도 센서 연동파일 다운로드1
12629정성태5/5/2021167.NET Framework: 1057. C# - CoAP 서버 및 클라이언트 제작 (UDP 소켓 통신)파일 다운로드1
12628정성태5/4/202146Linux: 39. Eclipse 원격 디버깅 - Cannot run program "gdb": Launching failed
12627정성태5/4/202155Linux: 38. 라즈베리 파이 제로 용 프로그램 개발을 위한 Eclipse C/C++ 윈도우 환경 설정
12626정성태5/14/202173.NET Framework: 1056. C# - Thread.Suspend 호출 시 응용 프로그램 hang 현상 (2)파일 다운로드1
12625정성태5/3/202142오류 유형: 714. error CS5001: Program does not contain a static 'Main' method suitable for an entry point
12624정성태5/3/2021264.NET Framework: 1055. C# - struct/class가 스택/힙에 할당되는 사례 정리 [6]파일 다운로드1
12623정성태5/2/2021130.NET Framework: 1054. C# 9 최상위 문에 STAThread 사용파일 다운로드1
12622정성태5/3/202146오류 유형: 713. XSD 파일을 포함한 프로젝트 - The type or namespace name 'TypedTableBase<>' does not exist in the namespace 'System.Data'
12621정성태5/1/2021158.NET Framework: 1053. C# - 특정 레지스트리 변경 시 알림을 받는 방법파일 다운로드1
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...