소스 제어 시스템에서 NuGet 패키지 생략

아티클
08/10/2023

일반적으로 개발자는 해당 소스 제어 리포지토리에서 NuGet 패키지를 생략하고 대신 패키지 복원을 사용하여 빌드 전에 프로젝트의 종속성을 다시 설치합니다.

패키지 복원을 사용하는 이유는 다음과 같습니다.

Git과 같은 분산 버전 제어 시스템은 리포지토리 내에서 모든 버전의 모든 파일의 전체 복사본을 포함합니다. 이진 파일이 자주 업데이트되면 리포지토리를 복제하는 데 상당한 블로트가 발생하고 걸리는 시간이 길어집니다.
패키지가 리포지토리에 포함될 때 개발자는 NuGet을 통해 패키지를 참조하지 않고 디스크에서 직접 패키지 내용에 대한 참조를 추가할 수 있습니다. 그러면 프로젝트에서 하드 코딩된 경로 이름으로 이어질 수 있습니다.
사용 중인 모든 패키지 폴더를 삭제하지 않았는지 확인해야 하는 경우 사용하지 않는 패키지 폴더의 솔루션을 정리하기가 더 어려워집니다.
패키지를 생략하여 코드와 종속된 다른 사용자의 패키지 간에 소유권 경계를 명확하게 유지합니다. 많은 NuGet 패키지는 고유한 소스 제어 리포지토리에서 유지되고 있습니다.

이 문서에 설명된 대로 패키지 복원이 NuGet의 기본 동작이지만 수작업으로 패키지(즉, 소스 제어의 프로젝트에 있는 packages 폴더)를 생략해야 합니다.

Git를 사용하여 패키지 생략

.gitignore 파일을 사용하여 NuGet 패키지(.nupkg), packages 폴더 및 project.assets.json을 무시합니다. 참조는 Visual Studio 프로젝트에 대한 샘플 .gitignore를 참조하세요.

.gitignore 파일의 중요한 부분은 다음과 같습니다.

# Ignore NuGet Packages
*.nupkg

# The packages folder can be ignored because of Package Restore
**/[Pp]ackages/*

# except build/, which is used as an MSBuild target.
!**/[Pp]ackages/build/

# Uncomment if necessary however generally it will be regenerated when needed
#!**/[Pp]ackages/repositories.config

# NuGet v3's project.json files produces more ignorable files
*.nuget.props
*.nuget.targets

# Ignore other intermediate files that NuGet might create. project.lock.json is used in conjunction
# with project.json (NuGet v3); project.assets.json is used in conjunction with the PackageReference
# format (NuGet v4 and .NET Core).
project.lock.json
project.assets.json

Team Foundation 버전 제어를 사용하여 패키지 생략

참고 항목

가능한 경우 프로젝트를 소스 제어에 추가하기 전에 이러한 지침에 따릅니다. 그렇지 않으면 리포지토리에서 packages 폴더를 수동으로 삭제하고 계속하기 전에 해당 변경 내용을 체크 인합니다.

선택한 파일에서 TFVC를 사용하여 소스 제어 통합을 사용하지 않으려면:

(.sln 파일이 있는)솔루션 폴더에서 .nuget라는 폴더를 만듭니다.
- 팁: Windows의 Windows 탐색기에서 이 폴더를 만들려면 후행 점을 ‘포함한’ .nuget.이라는 이름을 사용합니다.
해당 폴더에서 NuGet.Config라는 파일을 만들고 편집하기 위해 엽니다.
최소한 다음 텍스트를 추가합니다. 여기서 disableSourceControlIntegration 설정을 통해 Visual Studio에서 packages 폴더에 있는 모든 항목을 건너뜁니다.
```
<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <solution>
        <add key="disableSourceControlIntegration" value="true" />
    </solution>
</configuration>
```
TFS 2010 이전 버전을 사용하는 경우 매핑 작업 영역에서 packages 폴더를 숨깁니다.
서버에 파일 추가에 설명된 대로 TFS 2012 이상 또는 Visual Studio Team Services를 사용하여 .tfignore 파일을 만듭니다. 해당 파일에서 리포지토리 수준의 \packages 폴더 및 다른 몇 가지 중간 파일에 대한 수정을 명시적으로 무시하려면 아래 내용을 포함합니다. (후행 점이 있는 .tfignore.라는 이름을 사용하여 Windows 탐색기에서 파일을 만들 수 있지만 먼저 "알려진 파일 확장명 숨기기" 옵션을 비활성화해야 합니다.)
```
# Ignore NuGet Packages
*.nupkg

# Ignore the NuGet packages folder in the root of the repository. If needed, prefix 'packages'
# with additional folder names if it's not in the same folder as .tfignore.   
packages

# Omit temporary files
project.lock.json
project.assets.json
*.nuget.props
```
NuGet.Config 및 .tfignore를 소스 제어에 추가하여 변경 내용을 체크 인합니다.

다음을 통해 공유

소스 제어 시스템에서 NuGet 패키지 생략

Git를 사용하여 패키지 생략

Team Foundation 버전 제어를 사용하여 패키지 생략

피드백

추가 리소스