내장 종속성

프로젝트의 Packages 폴더에 표시되는 모든 패키지는 해당 프로젝트에 내장됩니다. 다음의 여러 방법으로 내장된 패키지를 생성할 수 있습니다.

• 프로젝트의 Packages 폴더에서 직접 새 패키지를 생성합니다.
• 프로젝트의 패키지 캐시에서 프로젝트의 Packages 폴더로 Unity 패키지를 수동으로 복사합니다.
• C# 스크립트를 사용하여 이미 설치된 패키지 버전을 내장합니다.

내장된 패키지는 프로젝트 매니페스트에 종속성으로 표시할 필요가 없습니다. 하지만 설치된 패키지의 버전을 내장한 경우 프로젝트 매니페스트에는 여전히 원래 설치된 버전에 대한 종속성이 나열됩니다. 이 경우 디스크의 패키지는 종속성으로 나열된 패키지 버전보다 우선권을 갖기 때문에 프로젝트 매니페스트에서 제거할 필요가 없습니다. 예를 들어 프로젝트 매니페스트에서 com.unity.example 패키지의 버전 1.3.1에 대한 종속성을 지정하지만 프로젝트에 해당 이름의 내장 패키지가 있는 경우, 패키지 관리자는 레지스트리에서 버전 1.3.1을 다운로드하는 대신 표시되는 버전에 관계없이 내장 패키지를 사용합니다.

내장된 패키지의 콘텐츠와 변경 사항을 추적해야 합니다. Unity 프로젝트가 소스 컨트롤 대상인 경우 해당 프로젝트에 내장된 모든 패키지를 동일한 소스 컨트롤에 추가합니다.

새로운 커스텀 패키지 만들기

새 패키지를 내장하려면 Packages 폴더에 있는 폴더 안에 새 패키지 콘텐츠를 생성합니다. 자세한 내용은 자체 커스텀 패키지 생성 지침을 참조하십시오.

일반적으로 새 패키지는 다른 사용자와 공유하고 다른 프로젝트에서 테스트할 준비가 될 때까지 프로젝트에 내장된 상태로 유지됩니다. 그런 다음 범위 지정 패키지 레지스트리에 퍼블리시할 수 있습니다.

캐시에서 Unity 패키지 복사

레지스트리에서 설치된 패키지는 변경할 수 없으므로 편집할 수 없습니다. 패키지를 편집하려면 Projects 폴더에 복사하여 변경 가능하도록 만들면됩니다. 이 패키지 유형을 내장 패키지라고 하며, 패키지 캐시에 있는 항목을 오버라이드합니다. 나중에 Project 폴더에서 내장 패키지의 폴더를 삭제하면 패키지 관리자가 변경 불가능한 캐시된 패키지로 자동 변경합니다.

캐시에서 패키지 폴더를 찾는 가장 효과적인 방법은 다음 단계에 따라 Unity 에디터에서 설치된 버전을 직접 찾는 것입니다.

1. Window > General > Project를 선택하여 프로젝트 창을 엽니다.

2. 프로젝트 창에서 내장하려는 설치된 패키지를 찾습니다.

3. 선택한 패키지의 폴더를 오른쪽 클릭하고 Show in Explorer(Windows) 또는 Reveal in Finder(macOS)를 선택합니다. 해당 패키지의 폴더는 파일 브라우저에서 바로 열리며 <package-name> 명명 규칙을 사용합니다.

   참고: 임베드하려는 패키지가 프로젝트에 없는 경우 파일 브라우저나 커맨드 라인을 사용해 올바른 폴더로 이동하여 프로젝트의 패키지 캐시(<project>/Library/PackageCache)에서 직접 가져오면 됩니다. 그러나 에디터가 프로젝트 캐시에서 패키지를 찾을 뿐만 아니라 로컬 폴더나 타르볼에서 설치된 패키지와 이미 내장된 패키지를 찾기 때문에 에디터가 대신 찾도록 하는 것이 더 좋습니다.

   

4. 패키지 폴더를 복사하여 프로젝트의 Packages 폴더에 바로 붙여 넣습니다. 패키지 관리자는 패키지를 Assets 폴더에서 스캔하지 않으므로 해당 폴더 안에 넣지 마십시오.

5. 프로젝트에 소스 컨트롤이 이미 적용되는 경우 새로운 내장 패키지를 소스 컨트롤에 추가합니다.

내장된 패키지를 삭제하려면 파일 브라우저 또는 커맨드 라인을 사용하여 해당 패키지를 Packages 폴더에서 찾으십시오. 내장된 패키지의 폴더를 백업하는 것이 좋습니다. 그렇지 않으면 패키지에 적용한 모든 변경 사항이 손실됩니다. 그런 다음 해당 패키지의 폴더를 Packages 폴더에서 삭제합니다. 패키지 관리자는 변경 불가능한 캐시된 패키지로 자동으로 되돌아갑니다.

추가 리소스

• 스크립트를 사용하여 프로젝트에 패키지 내장