Version: 2022.2
언어: 한국어
범위 지정 레지스트리 인증
에셋 스토어 캐시 위치 커스터마이즈

전역 캐시 위치 커스터마이즈

패키지 관리자는 레지스트리 데이터와 압축되지 않은 패키지에 대해 전역 캐시를 유지 관리합니다.전역 캐시에는 각각 다른 용도로 사용되는 보조 캐시가 포함되어 있습니다.패키지 관리자는 오버라이드할 수 있는 기본 위치에 전역 캐시를 저장합니다.

다음과 같은 다양한 이유로 캐시 위치를 오버라이드하려고 할 수 있습니다.

  • 내부 드라이브의 공간을 절약하려고 함
  • 다른 사람들이 액세스할 수 있는 공유 드라이브에 캐시를 저장하려고 함
  • 시스템 디렉토리가 아닌 폴더에 캐시를 저장하려고 함

기본적으로 패키지 관리자는 전역 캐시에 대해 다음의 폴더 구조를 사용합니다.

<global-cache-root>
  ├── npm
  │   └── <레지스트리 데이터(패키지 메타데이터 및 타르볼)>
  ├── 패키지
  │   └── <패키지 tarball의 압축되지 않은 콘텐츠>
  └── git-lfs(활성화된 경우)
       └── <다운로드한 Git LFS 파일>

For information on the default location of the global cache root, see global cache.

Note: The Package Manager maintains separate caches for the global cache and the Asset Store package cache. For information on overriding the default location for the Asset Store cache, see Customize the Asset Store cache location.

전역 캐시 루트의 기본 위치를 오버라이드하기 위해 다음 방법을 사용할 수 있습니다.

  • Preferences 창은 쉽고 영구적이므로 권장되는 방법입니다.이 방법을 사용하여 패키지 캐시 위치를 변경하면 Unity는 현재 세션과 향후 세션에 대한 환경 설정을 저장합니다.
    • Note: Using the Preferences window sets the cacheRoot property in a user configuration file. If you want to set the configuration file manually, see Using a configuration file.
  • 환경 변수 메서드는 영구적이지 않지만, 고급 사용자는 특정 사용 사례에 이를 선호할 수 있습니다.

시작하기 전 중요한 참조 사항

  • 어떤 방법을 선택하든 캐시 위치를 변경하면 패키지 관리자가 앞으로 해당 위치를 사용하도록 지시합니다.패키지 관리자가 원래 위치에 저장한 기존 패키지는 해당 폴더 구조에 유지됩니다.
  • You can use environment variables to override the location of the global cache root or its subsidiary caches (registry data cache, uncompressed packages cache, and the Git LFS cache). However, environment variables and configuration file properties aren’t equivalent, so using different methods to configure settings can produce unexpected results.
  • 서로 다른 방법으로 여러 값을 설정하는 방식에는 다음과 같은 다양한 요인이 영향을 미칩니다.
    • 환경 변수 메서드를 사용하여 캐시 위치를 변경한 경우 Preferences 창을 사용하여 위치를 변경할 수 없습니다.
    • 사용자 설정 파일을 사용하면 현재 사용자 계정에 변경 사항이 적용됩니다.
    • UPM_CACHE_ROOT 환경 변수와 cacheRoot 프로퍼티를 모두 사용하여 전역 캐시 루트에 다른 값을 설정하면 패키지 관리자는 UPM_CACHE_ROOT 환경 변수의 위치를 ​​사용합니다.
    • 레지스트리 데이터 캐시(UPM_NPM_CACHE_PATH), 압축되지 않은 패키지 캐시(UPM_CACHE_PATH) 또는 Git LFS 캐시(UPM_GIT_LFS_CACHE_PATH)에 대한 환경 변수를 설정하면 패키지 관리자는 전역 캐시 루트의 위치에 관계없이 환경 변수에서 지정하는 위치를 사용합니다.
    • 경로(UPM_GIT_LFS_CACHE_PATH)를 명시적으로 설정하지 않고 Git LFS 캐시(UPM_ENABLE_GIT_LFS_CACHE)를 활성화하면 패키지 관리자는 전역 캐시 루트 아래의 git-lfs 폴더를 위치로 사용합니다.

Preferences 창 사용

To use the Preferences window to override the default location of the global cache, follow these steps.

  1. 다음 방법 중 하나를 사용하여 Preferences 창을 엽니다.

    • Unity 메뉴(macOS) 또는 Edit 메뉴(Windows 및 Linux)를 열고 Preferences를 선택합니다.
    • Package Manager 창을 열고 Advanced 메뉴를 연 다음 Preferences를 선택합니다.
  2. Package Manager 카테고리를 선택합니다.

  3. Packages에서 Cache Location 옆에 있는 메뉴를 엽니다.

  4. Change Location을 선택합니다.

  5. 전역 캐시의 새 위치를 선택합니다.

Package Manager 카테고리가 선택된 Preferences 창
Package Manager 카테고리가 선택된 Preferences 창

설정 파일 사용

You can manually edit the same configuration file that the Preferences window sets to override the location of the global cache root:

  1. Locate the .upmconfig.toml user configuration file. To find the file location, see Configuration files. If the file doesn’t exist, create an empty text file.

  2. cacheRoot 키를 추가하고 해당 값을 커스텀 위치에 대한 절대 경로로 설정합니다.중요:TOML 파일에서 Windows 경로를 설정할 때는 슬래시(/) 또는 더블 슬래시(\\)를 사용하십시오.백슬래시(\)는 이스케이프 시퀀스를 표시하는 특수 문자이므로 TOML 구문 분석 오류를 발생시킬 수 있는 백슬래시를 사용하지 마십시오.

    Windows 예시

    cacheRoot = "E:\\Unity\\cache"
    

    macOS 및 Linux 예시

    cacheRoot = "/dev/external/shared/Unity/cache"
    

cacheRoot 키를 설정한 후 Unity 에디터 또는 Unity Hub를 다시 시작하지 않아도 변경 사항이 적용됩니다.

환경 변수 사용

In scenarios that involve automation or continuous integration, it’s less practical and more error prone to configure settings in a configuration file or a preferences window. In such scenarios, you might consider using environment variables to configure settings for the global cache and its subsidiary caches. The following environment variables are available:

환경 변수: 설명:
UPM_CACHE_ROOT 전역 캐시(레지스트리 데이터와 압축되지 않은 패키지 캐시가 포함된 루트 폴더)의 위치를 ​​지정합니다.
UPM_NPM_CACHE_PATH 패키지 관리자가 패키지 메타데이터와 타르볼을 저장하기 원하는 위치에 대한 절대 경로를 지정합니다.기본적으로 전역 캐시 루트의 npm 하위 디렉토리입니다.
UPM_CACHE_PATH 패키지 관리자가 패키지 타르볼의 압축되지 않은 콘텐츠를 저장하기 원하는 위치에 대한 절대 경로를 지정합니다.기본적으로 전역 캐시 루트의 packages 하위 디렉토리입니다.
UPM_ENABLE_GIT_LFS_CACHE 공백("")을 제외한 모든 값을 지정하여 Git LFS 캐시를 활성화합니다.기본적으로 패키지 관리자는 전역 캐시 루트의 git-lfs 하위 디렉토리를 사용합니다. 단, UPM_GIT_LFS_CACHE_PATH 환경 변수를 사용하여 다른 경로를 지정하는 경우는 예외입니다.
UPM_GIT_LFS_CACHE_PATH 패키지 관리자가 Git LFS 캐시를 저장할 위치의 절대 경로를 지정합니다. 이 경로를 설정하면 Git LFS 캐시가 자동으로 활성화됩니다.

중요:이 방법을 사용할 때는 다음 가이드라인을 따르십시오.

  • 환경 변수를 설정하기 전에 Unity 에디터와 Unity Hub가 이미 실행 중인 경우 이를 닫으십시오.
  • 환경 변수를 설정한 것과 동일한 커맨드 프롬프트나 터미널 세션에서 Unity 에디터 또는 Unity Hub를 실행하십시오.
  • Any environment variables you set in the table above must be set every time you launch Unity.

환경 변수 설정에 대한 내용은 운영체제의 문서를 참조하십시오.환경 변수에 대한 소개는 https://en.wikipedia.org/wiki/Environment_variable을 참조하십시오.



  • Unity 2021.2에서 패키지 관리자 설정 파일에서 지원되는 전역 캐시 루트 설정 NewIn20212
범위 지정 레지스트리 인증
에셋 스토어 캐시 위치 커스터마이즈