Version: 2021.1
언어: 한국어
전역 캐시
네트워크 문제 해결

설정

이 섹션에서는 패키지 관리자에 대해 다음을 설정하는 방법에 대한 정보를 제공합니다.

또한 설정 파일에서 패키지 관리자 설정 파일의 위치를 찾을 수 있습니다.

공유 캐시 위치 커스터마이즈

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

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

패키지 관리자의 전역 캐시 루트의 기본 위치를 오버라이드하려면 사용자 설정 파일cacheRoot 프로퍼티를 사용하거나 UPM_CACHE_ROOT 환경 변수를 설정할 수 있습니다.

참고: macOS 및 Linux 시스템에 대한 설정 파일 전략을 사용하는 것이 좋습니다. Windows가 아닌 경우 환경 변수로 Unity를 실행하기 어려울 수 있기 때문입니다.

또한 환경 변수 설정을 통해 레지스트리 데이터 캐시, 압축되지 않은 패키지 캐시, Git LFS 캐시를 오버라이드할 수도 있습니다. 하지만 환경 값과 설정 파일 프로퍼티는 동일하지 않으므로, 다른 방법으로 설정을 구성하면 예기치 않은 결과가 발생할 수 있습니다.

다음과 같이 레벨과 설정 방법이 함께 작동하는 방식에 영향을 주는 많은 요인이 있습니다.

  • 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 폴더를 위치로 사용합니다.

설정 파일 사용

다음 지침에 따라 전역 캐시 루트의 위치를 ​​오버라이드하십시오.

  1. .upmconfig.toml 사용자 설정 파일을 찾습니다. 파일이 존재하지 않는 경우 빈 텍스트 파일을 생성합니다.

  2. cacheRoot 프로퍼티를 절대 경로의 커스텀 위치로 설정합니다. 예를 들면 다음과 같습니다.

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

cacheRoot 프로퍼티를 업데이트한 후 Unity 에디터 또는 허브를 다시 시작하지 않아도 설정이 적용됩니다.

환경 변수 사용

환경 변수를 사용하면 패키지 관리자에 대한 여러 설정을 구성할 수 있습니다. 하지만 이러한 설정을 적용하기 위해서는 환경 변수가 매번 정의되고 익스포트된 터미널 또는 커맨드 프롬프트에서 Unity 또는 허브를 실행해야 합니다.

예를 들어 macOS 또는 Linux 터미널에서 다음 커맨드를 실행하여 레지스트리 데이터 캐시를 오버라이드하고 Git LFS 캐시를 활성화할 수 있습니다.

# macOS/Linux:
export UPM_NPM_CACHE_PATH=/dev/ssd/shared/Unity/cache/npm
export UPM_ENABLE_GIT_LFS_CACHE=true
echo "Launching Unity with the Git LFS cache enabled and using this global cache location: '$UPM_CACHE_ROOT'"
"/Applications/Unity Hub.app/Contents/MacOS/Unity Hub"

이 Windows 예시는 전역 캐시 루트와 Git LFS 캐시를 모두 설정합니다.

# On Windows:
@echo off
set UPM_CACHE_ROOT=%ALLUSERSPROFILE%\Unity\config
echo "Launching Unity with this global cache location: '%UPM_CACHE_ROOT%'"
"C:\Program Files\Unity Hub\Unity Hub.exe"

UPM_CACHE_ROOT 환경 변수를 사용하여 전역 캐시(레지스트리 데이터와 압축되지 않은 패키지 캐시가 포함된 루트 폴더)의 위치를 오버라이드할 수 있습니다.

다음 환경 변수를 사용할 수 있습니다.

환경 변수: 설명:
UPM_NPM_CACHE_PATH 패키지 관리자가 패키지 메타데이터 및 타르볼을 저장할 위치의 절대 경로를 지정합니다. 기본 위치는 전역 캐시 루트 아래의 npm 하위 폴더입니다.
UPM_CACHE_PATH 패키지 관리자가 패키지 타르볼의 압축되지 않은 콘텐츠를 저장할 위치의 절대 경로를 지정합니다. 기본 위치는 전역 캐시 루트 아래의 packages 하위 폴더입니다.
UPM_GIT_LFS_CACHE_PATH 패키지 관리자가 Git LFS 캐시를 저장할 위치의 절대 경로를 지정합니다. 이 경로를 설정하면 Git LFS 캐시가 자동으로 활성화됩니다.
UPM_ENABLE_GIT_LFS_CACHE Git LFS 캐시를 활성화하려면 비어 있는 값("")을 제외한 값을 지정합니다. 패키지 관리자는 전역 캐시 루트 아래의 git-lfs 하위 폴더를 사용합니다.

설정 파일

패키지 관리자는 두 가지 설정 파일, 즉 전역 설정 파일과 사용자 설정 파일을 지원합니다. 이 두 파일은 모두 TOML 포맷을 사용하며, 서로 다른 위치에 나타납니다.

  • 전역 설정 파일은 컴퓨터의 모든 사용자에게 적용됩니다. 예를 들어 전체 시스템에 대한 프록시 서버를 설정할 때 추가 SSL 인증서 권한을 정의할 수 있습니다.
  • 사용자 설정 파일은 단일 사용자에게 적용됩니다. 예를 들어 범위 지정 레지스트리로 액세스하는 커스텀 패키지 레지스트리 서버에 사용할 인증 토큰을 설정할 수 있습니다. 이 토큰은 특정 사용자 계정을 인증합니다.

전역 설정 파일 위치

패키지 관리자는 upmconfig.toml이라는 이름의 전역 설정 파일을 사용합니다. 이 파일은 다음 위치에서 찾을 수 있습니다.

환경: 위치:
Windows %ALLUSERSPROFILE%\Unity\config\upmconfig.toml
macOS 및 Linux /etc/upmconfig.toml

사용자 설정 파일 위치

패키지 관리자는 .upmconfig.toml이라는 이름의 사용자 설정 파일을 사용합니다. 이 파일은 다음 위치에서 찾을 수 있습니다.

환경: 위치:
Windows(사용자 계정) %USERPROFILE%\.upmconfig.toml (예: C:\Users\myusername\.upmconfig.toml)
Windows(시스템 사용자 계정) %ALLUSERSPROFILE%\Unity\config\ServiceAccounts\.upmconfig.toml (예: C:\Users\Public\Unity\config\ServiceAccounts\.upmconfig.toml)
macOS 및 Linux ~/.upmconfig.toml (예: /Users/myusername/.upmconfig.toml)



  • Unity 2021.2에서 패키지 관리자 설정 파일에서 지원되는 전역 캐시 루트 설정 NewIn20212
전역 캐시
네트워크 문제 해결