Microsoft MVP성태의 닷넷 이야기
VS.NET IDE: 156. Visual Studio - "Migrate packages.config to PackageReference" [링크 복사], [링크+제목 복사]
조회: 2366
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

Visual Studio - "Migrate packages.config to PackageReference"

예전에 packages.config 대신 PackageReference를 쓰는 것이 왜 좋은지에 대한 이유를 설명한 적이 있습니다.

Visual Studio 2017 - NuGet 패키지를 직접 참조하는 PackageReference 지원
; https://www.sysnet.pe.kr/2/0/11281

Migrate from packages.config to PackageReference
; https://docs.microsoft.com/en-us/nuget/consume-packages/migrate-packages-config-to-package-reference#benefits-of-using-packagereference

  • 별도 파일인 packages.config을 필요로 하지 않고 project 파일 내에 참조 관리를 통합
  • packages.config 파일을 열어 보면, (예를 들어, Newtonsoft.Json을 참조한 경우) 다른 여러 <package />들이 함께 보이는 반면, PackageReference로 하면 프로젝트가 직접적으로 참조한 패키지를 쉽게 구분
  • packages.config으로 관리하는 경우 설치한 패키지들이 비주얼 스튜디오의 솔루션이 위치한 하위 packages 폴더에 위치하지만, PackageReference로 하면 시스템 전역의 NuGet 패키지 저장소에 있으므로 디스크 공간도 절약
  • packages.config의 경우 제한된 구문의 <package /> 항목인 반면, msbuild는 project 파일의 좀 더 다양한 컴파일 조건을 적용할 수 있음
  • 이후 PackageReference의 기능은 계속 개발을 하지만, packages.config은 개발 중지 상태됨

저 글을 쓸 때만 해도 .NET Core와 UWP 프로젝트에서만 PackageReference를 지원했는데, 어느 순간 제한적이지만 .NET Framework 프로젝트에도 적용이 되었습니다.

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

By default, PackageReference is used for .NET Core projects, .NET Standard projects, and UWP projects targeting Windows 10 Build 15063 (Creators Update) and later, with the exception of C++ UWP projects. .NET Framework projects support PackageReference, but currently default to packages.config. To use PackageReference, migrate the dependencies from packages.config into your project file, then remove packages.config.


하지만 기본값은 packages.config을 사용하는 것이기 때문에, 개발자가 직접 "Migrate packages.config to PackageReference..." 메뉴를 선택해 PackageReference로 변경해야 합니다.

vs_package_ref_1.png

혹은, 비주얼 스튜디오의 옵션 설정("Package Management" / "Default package management format")을 통해,

vs_package_ref_2.png

기본 참조 모드를 변경할 수 있습니다.




그런데 ASP.NET 프로젝트의 경우 "Migrate packages.config to PackageReference..." 메뉴를 이용하면 이런 오류가 발생합니다.

Operation failed

Project is not eligible for migration. Either the project is not packages.config based or doesn't support PackageReference yet. Visit https://docs.microsoft.com/en-us/nuget/reference/migrate-packages-config-to-package-reference for more information.

이에 대해서는 이미 문서에서 잘 설명하고 있습니다.

  • Visual Studio 2015를 포함한 이전 버전에서는 PackageReference 미지원
  • ASP.NET 프로젝트의 경우 migration 지원이 안 됨.
  • 몇몇 패키지들은 PackageReference와 호환이 안 됨

그렇다고 해서 ASP.NET 프로젝트가 PackageReference를 아예 사용할 수 없는 것은 아닙니다. 가령, packages.config에 다음과 같이 log4net을 참조하고 있는 경우,

<?xml version="1.0" encoding="utf-8"?>
<packages>
  <package id="log4net" version="2.0.12" targetFramework="net48" />
</packages>

1) 수작업으로 그냥 저 항목을 삭제하고 2) csproj 파일 내의 Reference 노드를 PackageReference 노드로 교체하면 됩니다.

<!--Reference Include="log4net, Version=1.2.11.0, Culture=neutral, PublicKeyToken=669e0ddf0bb1aa2a, processorArchitecture=MSIL">
    <HintPath>..\..\..\packages\log4net.2.0.0\lib\net40-full\log4net.dll</HintPath>
</Reference-->

<PackageReference Include="log4net" Version="1.2.11" />

(물론, PackageReference와 호환되지 않은 패키지는 바꿔서는 안 됩니다.)




참고로, packages.config을 사용하면 해당 프로젝트를 다른 PC에 복사해 명령행으로 빌드하는 경우 반드시 "packages" 폴더가 존재해야 합니다.

예를 들어, 간단하게 log4net 2.0.5 버전을 packages.config에 포함한 프로젝트가 있는 경우,

<?xml version="1.0" encoding="utf-8"?>
<packages>
  <package id="log4net" version="2.0.5" targetFramework="net40" />
</packages>

단순히 프로젝트 파일(csproj)과 소스 코드, packages.config 파일만 다른 PC에 복사해 "msbuild ConsoleApp1.csproj /target:Rebuild"를 수행하면 다음과 같은 식의 오류가 발생합니다.

Program.cs(1,7): error CS0246: The type or namespace name 'log4net' could not be found (are you missing a using directive or an assembly reference?) [C:\temp\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj]

Build FAILED.

"C:\temp\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj" (Rebuild target) (1) ->
(ResolveAssemblyReferences target) ->
  C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\MSBuild\Current\Bin\Microsoft.Common.CurrentVersion.targets(2081,5): warning MSB3245: Could not resolve this reference. Could not locate the assembly "log4net, Version=1.2.15.0, Culture=neutral, PublicKeyToken=669e0ddf0bb1aa2a, processorArchitecture=MSIL". Check to make sure the assembly exists on disk. If this reference is required by your code, you may get compilation errors. [C:\temp\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj]

"C:\temp\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj" (Rebuild target) (1) ->
(CoreCompile target) ->
  Program.cs(1,7): error CS0246: The type or namespace name 'log4net' could not be found (are you missing a using directive or an assembly reference?) [C:\temp\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj]

    1 Warning(s)
    1 Error(s)

따라서 "nuget restore"처럼 참조 패키지를 복원하는 과정이 필요하며 msbuild로는 이렇게 처리할 수 있습니다.

C:\temp\ConsoleApp1\ConsoleApp1> msbuild ConsoleApp1.csproj -t:restore -p:RestorePackagesConfig=true /p:SolutionDir=C:\temp\ConsoleApp1

혹은 그냥 속 편하게 개발자 PC의 "packages" 폴더까지 모두 복사해도 됩니다.




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







[최초 등록일: ]
[최종 수정일: 12/15/2020]

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)
12615정성태4/26/20211344오류 유형: 712. Microsoft Live 로그인 - 계정을 선택하는(Pick an account) 화면에서 진행이 안 되는 문제
12614정성태4/24/20211843개발 환경 구성: 570. C# - Azure AD 인증을 지원하는 ASP.NET Core/5+ 웹 애플리케이션 예제 구성 [3]파일 다운로드1
12613정성태4/23/20211608.NET Framework: 1048. C# - ETW 이벤트의 Keywords에 속한 EventId 구하는 방법 (2) 관리 코드파일 다운로드1
12612정성태4/23/20211580.NET Framework: 1047. C# - ETW 이벤트의 Keywords에 속한 EventId 구하는 방법 (1) PInvoke파일 다운로드1
12611정성태4/22/20211229오류 유형: 711. 닷넷 EXE 실행 오류 - Mixed mode assembly is build against version 'v2.0.50727' of the runtime
12610정성태4/22/20211474.NET Framework: 1046. C# - 컴파일 시점에 참조할 수 없는 타입을 포함한 이벤트 핸들러를 Reflection을 이용해 구독하는 방법파일 다운로드1
12609정성태4/22/20211722.NET Framework: 1045. C# - 런타임 시점에 이벤트 핸들러를 만들어 Reflection을 이용해 구독하는 방법파일 다운로드1
12608정성태4/21/20212015.NET Framework: 1044. C# - Generic Host를 이용해 .NET 5로 리눅스 daemon 프로그램 만드는 방법 [7]파일 다운로드1
12607정성태4/21/20211640.NET Framework: 1043. C# - 실행 시점에 동적으로 Delegate 타입을 만드는 방법파일 다운로드1
12606정성태4/21/20212050.NET Framework: 1042. C# - enum 값을 int로 암시적(implicit) 형변환하는 방법? [2]파일 다운로드1
12605정성태4/18/20211705.NET Framework: 1041. C# - AssemblyID, ModuleID를 관리 코드에서 구하는 방법파일 다운로드1
12604정성태4/18/20211505VS.NET IDE: 163. 비주얼 스튜디오 속성 창의 "Build(빌드)" / "Configuration(구성)"에서의 "활성" 의미
12603정성태4/16/20211497VS.NET IDE: 162. 비주얼 스튜디오 - 상속받은 컨트롤이 디자인 창에서 지원되지 않는 문제
12602정성태4/16/20211978VS.NET IDE: 161. x64 DLL 프로젝트의 컨트롤이 Visual Studio의 Designer에서 보이지 않는 문제
12601정성태4/15/20211559.NET Framework: 1040. C# - REST API 대신 github 클라이언트 라이브러리를 통해 프로그래밍으로 접근
12600정성태4/15/20211659.NET Framework: 1039. C# - Kubeconfig의 token 설정 및 인증서 구성을 자동화하는 프로그램
12599정성태4/14/20211663.NET Framework: 1038. C# - 인증서 및 키 파일로부터 pfx/p12 파일을 생성하는 방법파일 다운로드1
12598정성태4/14/20211756.NET Framework: 1037. openssl의 PEM 개인키 파일을 .NET RSACryptoServiceProvider에서 사용하는 방법 (2)파일 다운로드1
12597정성태4/13/20211731개발 환경 구성: 569. csproj의 내용을 공통 설정할 수 있는 Directory.Build.targets / Directory.Build.props 파일
12596정성태4/12/20211689개발 환경 구성: 568. Windows의 80 포트 점유를 해제하는 방법
12595정성태4/12/20211481.NET Framework: 1036. SQL 서버 - varbinary 타입에 대한 문자열의 CAST, CONVERT 변환을 C# 코드로 구현
12594정성태4/11/20211557.NET Framework: 1035. C# - kubectl 명령어 또는 REST API 대신 Kubernetes 클라이언트 라이브러리를 통해 프로그래밍으로 접근 [1]파일 다운로드1
12593정성태4/10/20211687개발 환경 구성: 567. Docker Desktop for Windows - kubectl proxy 없이 k8s 대시보드 접근 방법
12592정성태4/10/20211629개발 환경 구성: 566. Docker Desktop for Windows - k8s dashboard의 Kubeconfig 로그인 및 Skip 방법
12591정성태4/9/20212829.NET Framework: 1034. C# - byte 배열을 Hex(16진수) 문자열로 고속 변환하는 방법파일 다운로드1
12590정성태4/9/20211467.NET Framework: 1033. C# - .NET 4.0 이하에서 Console.IsInputRedirected 구현
... 16  17  18  [19]  20  21  22  23  24  25  26  27  28  29  30  ...