패키지 사용 중단

아티클
08/10/2023

더 이상 패키지를 유지 관리하지 않거나 패키지 소비자에게 다른 패키지로 이동하도록 권장하려는 경우 패키지를 사용 중단할 수 있습니다.

패키지 사용 중단은 아래 설명대로 패키지를 제외하는 것과 다릅니다.

패키지를 제외하면 패키지는 검색 결과에서 숨겨지므로 검색되지 않습니다.
패키지를 사용 중단하면 기존 소비자는 패키지가 설치되어 있는지 또는 프로젝트에 사용되고 있는지 여부를 확인할 수 있습니다. 또한 사용 중단 이유 및 패키지 게시자가 지정한 대체 권장 패키지를 알 수 있습니다. 패키지를 사용 중단하는 것은 패키지를 제외하는 것이 아닙니다.

게시자는 패키지 제외와 사용 중단을 둘 다 선택할 수 있습니다.

사용 중단 워크플로

패키지를 사용 중단하려면 패키지 관리로 이동하여 사용 중단을 선택합니다.
사용 중단할 버전을 선택합니다. 모든 버전을 사용 중단하려면 모든 버전 선택 옵션을 선택합니다.
사용 중단 이유를 선택합니다. 패키지가 더 이상 유지 관리되지 않으면 레거시 옵션을 선택합니다. 특정 버전에 중요한 버그가 있는 경우 중요한 버그 있음 옵션을 선택합니다. 다른 이유인 경우에는 기타를 선택합니다. 언제든지 대체 권장 패키지(및 버전) 및 소유자에 대한 사용자 지정 메시지를 지정할 수 있습니다.

참고

사용자 지정 메시지는 nuget.org에만 표시되고 클라이언트에서는 표시되지 않습니다. 현재 dotnet.exe 및 NuGet 패키지 관리자와 같은 클라이언트는 사용자 지정 메시지를 표시하지 않습니다.

사용 중단된 패키지에 대한 클라이언트 환경

패키지가 사용 중단된 경우 해당 고객에게는 사용된 클라이언트에 따라 다음과 같은 방법으로 이에 대한 알림이 표시됩니다.

Visual Studio

Visual Studio 2019 버전 16.3부터 사용 가능

Visual Studio는 Installed 탭에서 사용되지 않는 패키지의 사용에 대해 경고합니다. 패키지와 사용 중단 정보(사용되지 않는 이유 및 대신 사용할 대체 패키지(있는 경우) 포함)에 대한 경고를 표시합니다.

Deprecated packages on Visual Studio installed tab of package manager

dotnet.exe

.NET SDK 3.0부터 사용 가능

dotnet.exe를 사용하는 경우 솔루션 또는 프로젝트 폴더에 대해 dotnet list package --deprecated 명령을 실행하여 사용 중단 정보와 함께 사용되지 않는 패키지의 목록을 가져올 수 있습니다.

> dotnet list package --deprecated

The following sources were used:
   https://api.nuget.org/v3/index.json

Project `My.Test.Project` has the following deprecated packages
   [netcoreapp3.0]:
   Top-level Package      Resolved   Reason(s)   Alternative
   > My.Sample.Lib        6.0.0      Legacy      My.Awesome.Package

최신 패키지로 인기도 이전

레거시 패키지가 사용 중단되도록 한 패키지 작성자는 “인기도”를 최신 패키지로 이전하여 최신 패키지의 검색 순위를 높일 수 있습니다. 그러면 고객은 사용되지 않는 패키지 대신 최신 패키지를 검색할 수 있습니다.

예를 들어 다음과 같은 두 개의 패키지가 있다고 가정합니다.

3백만 번 다운로드된 사용되지 않는 레거시 패키지 Contoso.Legacy
5번 다운로드된 최신 패키지 Contoso.Latest

NuGet.org는 다운로드 횟수/인기도가 더 높은 검색 결과를 선호합니다. 검색 쿼리 “Contoso”가 사용된 경우 검색 결과에서 사용되지 않는 패키지 Contoso.Legacy가 최신 패키지 Contoso.Latest보다 높은 순위에 위치합니다.

이 문제를 해결하기 위해 사용되지 않는 레거시 패키지의 인기도가 최신 패키지로 이전되도록 신청할 수 있습니다. 그러면 검색 결과에서 Contoso.Latest의 순위가 높아지고 Contoso.Legacy의 순위는 낮아집니다. 패키지의 내부 인기도 점수에만 영향이 있고 각 패키지의 실제 다운로드 횟수에는 영향이 없습니다.

참고

인기도 이전을 사용하면 소비자가 레거시 패키지를 찾기가 훨씬 더 어렵게 할 수 있습니다.

인기도 이전이 “Contoso” 쿼리의 검색 순위에 영향을 미치는 방식을 구체적으로 파악하려면 아래 표를 참조하세요.

검색 순위	인기도 이전 전	인기도 이전 후
1	Contoso.Legacy, 3백만 번 다운로드됨	Contoso.Latest, 5번 다운로드됨
2	Contoso.Scanner, 2백만 번 다운로드됨	Contoso.Scanner, 2백만 번 다운로드됨
3	Contoso.Core, 150만 번 다운로드됨	Contoso.Core, 150만 번 다운로드됨
4	Contoso.UI, 1백만 번 다운로드됨	Contoso.UI, 1백만 번 다운로드됨
...	...	...
20	Contoso.Latest, 5번 다운로드됨	Contoso.Legacy, 3백만 번 다운로드됨

사용되지 않는 여러 패키지의 인기도를 단일 새 패키지로 이전할 수 있습니다. 예를 들어 다음과 같은 3개의 패키지가 있다고 가정합니다.

사용되지 않는 첫 번째 레거시 패키지 Contoso.Legacy1
사용되지 않는 두 번째 레거시 패키지 Contoso.Legacy2
새 통합 패키지 Contoso.Latest

Contoso.Legacy1과 Contoso.Legacy2를 사용 중단되도록 한 후 Contoso.Latest로 인기도가 이전되도록 신청할 수 있습니다.

패키지 분할

사용되지 않는 패키지의 인기도는 최대 5개의 최신 패키지로 이전 및 분할할 수 있습니다. 이 기능은 사용되지 않는 패키지의 기능이 여러 새 패키지 간에 분할된 경우에 유용합니다. 예를 들어 다음과 같은 3개의 패키지가 있다고 가정합니다.

사용되지 않는 레거시 패키지 Contoso.Legacy
첫 번째 새 패키지 Contoso.Web
두 번째 새 패키지 Contoso.Cloud

Contoso.Legacy에는 웹 기능과 클라우드 기능이 모두 포함되어 있지만, 차세대의 경우 해당 기능을 여러 패키지로 분리하기로 했습니다. Contoso.Legacy를 사용 중단되도록 한 후 해당 인기도가 Contoso.Web과 Contoso.Cloud 둘 다에 이전되도록 신청할 수 있습니다.

경고

이전된 인기도는 모든 새 패키지 간에 균등하게 분할됩니다. 따라서 사용되지 않는 패키지의 인기도를 가능한 한 적은 수의 패키지로 이전하는 것이 좋습니다.

다음을 통해 공유

패키지 사용 중단

사용 중단 워크플로

사용 중단된 패키지에 대한 클라이언트 환경

Visual Studio

dotnet.exe

최신 패키지로 인기도 이전

인기도 이전 신청 프로세스

인기도 이전 요구 사항

고급 인기도 이전 시나리오

패키지 통합

패키지 분할

인기도 이전 체인

피드백

추가 리소스