Version: 2023.2
언어: 한국어
종속성 및 해결
설정

전역 캐시

Unity 패키지 관리자는 레지스트리에서 패키지 콘텐츠와 메타데이터를 다운로드할 때 전역 캐시를 저장 장소로 사용합니다. 이렇게 하면 패키지를 더욱 효율적으로 재사용하거나 공유할 수 있고, 오프라인에서도 저장된 패키지를 설치하고 업데이트할 수 있습니다.

참고: 전역 캐시는 에셋 스토어에서 제공하는 .unitypackage 포맷의 패키지를 포함하지 않습니다. 패키지 관리자는 이러한 타입의 패키지를 별도의 캐시에 저장합니다. 자세한 내용은 에셋 스토어 패키지를 참조하십시오.

위치

기본적으로 Unity는 전역 캐시를 운영체제(및 Windows의 사용자 계정 타입)에 기반하는 루트 디렉토리에 저장합니다.

운영체제 기본 루트 디렉토리 예제
Windows(사용자 계정) %LOCALAPPDATA%\Unity\cache\upm C:\Users\yourname\AppData\Local\Unity\cache\upm
Windows(시스템 사용자 계정) %ALLUSERSPROFILE%\Unity\cache\upm C:\ProgramData\Unity\cache\upm
macOS $HOME/Library/Caches/Unity/upm /Users/yourname/Library/Caches/Unity/upm
Linux $HOME/.cache/Unity/upm /home/yourname/.cache/Unity/upm

: 루트 디렉토리의 위치를 오버라이드할 수 있습니다. 자세한 내용은 전역 캐시 커스터마이즈를 참조하십시오.

구조

패키지 관리자 전역 캐시는 하위 캐시를 사용하며, 이러한 하위 캐시는 각각 다른 용도로 쓰입니다. 패키지 관리자는 전역 캐시 폴더 아래의 하위 폴더에 이러한 하위 캐시를 저장합니다.

하위 폴더 설명
db 패키지 콘텐츠 및 메타데이터를 저장하는 데 사용되는 레지스트리 데이터 캐시입니다.
packages 레지스트리에서 가져온 패키지 타르볼의 비압축 콘텐츠가 들어 있습니다.
git-lfs Git LFS를 활성화한 경우 다운로드된 Git LFS(Large File Storage) 파일이 들어 있습니다.

이러한 각 하위 폴더 내에서 각 레지스트리는 다른 레지스트리에서 호스트되는 패키지들이 섞이지 않도록 고유한 경로를 사용합니다.

: 이러한 폴더의 위치를 오버라이드할 수 있습니다. 자세한 내용은 전역 캐시 커스터마이즈를 참조하십시오.

크기

Unity 에디터 2023.2.0f1 버전부터 레지스트리 데이터 캐시(db 하위 폴더)의 크기가 10GB로 제한됩니다. 이러한 제한에 도달하면 패키지 관리자는 가장 이전에 사용된 콘텐츠(프로젝트에 패키지를 설치한 가장 오래된 날짜 기준)를 제거하여 레지스트리 데이터 캐시를 정리합니다. 즉, 패키지 관리자가 가장 먼저 제거하는 패키지는 가장 오래 전에 프로젝트에 추가한 패키지입니다. 그러나 패키지 관리자가 캐시에서 이러한 패키지를 제거하더라도 해당 패키지를 설치한 모든 프로젝트에는 패키지가 남아 있습니다. 다음에 다른 프로젝트에 이러한 패키지를 추가할 경우, 패키지 관리자는 캐시가 아닌 적절한 레지스트리에서 해당 패키지를 가져옵니다.

레지스트리 데이터 캐시 제한 크기는 오버라이드할 수 있습니다. 자세한 내용은 전역 캐시 커스터마이즈를 참조하십시오.

요구 사항

Unity 에디터 프로세스를 실행하는 사용자 계정은 루트 디렉토리와 해당 콘텐츠에 대한 완전한 쓰기 권한을 보유해야 합니다. 이러한 권한이 없으면 패키지 관리자가 패키지 메타데이터 및 콘텐츠를 캐시에 다운로드하거나 저장할 수 없습니다.

종속성 및 해결
설정