Git URL을 통한 설치

패키지 관리자는 원격 서버의 Git 저장소에서 패키지를 로드할 수 있습니다.

Unity 패키지 관리자에서 Git URL을 사용하는 자세한 방법은 프로젝트 매니페스트에 Git URL 사용에 대한 문서를 참조하십시오.

Git URL에서 패키지를 로드하려면 다음 절차를 따르십시오.

1. 상태 표시줄의 추가 버튼을 클릭합니다.

2. 패키지 추가 옵션이 나타납니다.

   

3. 추가 메뉴에서 Add package from git URL을 선택하면 텍스트 상자와 Add 버튼이 나타납니다.

4. 텍스트 상자에 유효한 Git URL을 입력하고 Add를 클릭합니다.

Unity가 지원하는 프로토콜에 대한 자세한 내용은 Git 종속성을 참조하십시오.

Unity가 패키지를 성공적으로 설치하면 패키지가 git 태그와 함께 패키지 리스트에 표시됩니다.

Unity가 패키지를 설치하지 못하면 Unity 콘솔에 오류 메시지가 표시됩니다. 자세한 내용은 아래의 오류 메시지 리스트의 메시지를 참조하십시오.

오류 메시지

• 저장소를 찾을 수 없음
• 사용자 이름을 읽을 수 없음: 터미널 프롬프트가 비활성화됨

저장소를 찾을 수 없음

존재하지 않는 위치를 지정하면 다음과 유사한 메시지가 Unity 콘솔에 나타납니다.

Cannot perform upm operation: Unable to add package [https://mycompany.github.com/gitproject/com.mycompany.mypackage.git]:
  Error when executing git command. fatal: repository 'https://mycompany.github.com/gitproject/com.mycompany.mypackage.git/' not found
 [NotFound]
UnityEditor.EditorApplication:Internal_CallUpdateFunctions() (at /Users/builduser/buildslave/unity/build/Editor/Mono/EditorApplication.cs:310)

철자를 확인하십시오. 정확한 URL을 사용하려면 저장소의 페이지로 이동한 후 Clone 버튼으로 URL을 복사하십시오.

GitHub (A) 또는 GitLab (B)에서 URL 오른쪽에 있는 버튼을 클릭하면 URL을 클립보드에 복사합니다.

사용자 이름을 읽을 수 없음: 터미널 프롬프트가 비활성화됨

인증이 필요한 프라이빗 저장소에서 패키지를 설치하려고 하면 다음과 유사한 메시지가 Unity 콘솔에 나타납니다.

Cannot perform upm operation: Unable to add package [https://mycompany.github.com/gitproject/com.mycompany.mypackage.git]:
  Error when executing git command. fatal: could not read Username for 'https://mycompany.github.com': terminal prompts disabled
 [NotFound]
UnityEditor.EditorApplication:Internal_CallUpdateFunctions() (at /Users/builduser/buildslave/unity/build/Editor/Mono/EditorApplication.cs:310)

Git 저장소를 복제하거나 가져올 때 가장 자주 사용하는 두 가지 인증용 프로토콜은 HTTP(S)와 SSH(공용 및 프라이빗 SSH 키 페어)입니다.

• HTTP(S)를 사용하면 GitHub 또는 GitLab에 로그인할 때마다 터미널이나 다이얼로그에 사용자 이름과 비밀번호를 입력해야 합니다.

• SSH를 사용하면 공용 SSH 키를 GitHub 또는 GitLab에 추가한 후 사용자 이름과 비밀번호를 입력하지 않고도 저장소에 액세스할 수 있습니다.

  하지만 SSH 키를 안전하게 유지하기 위해 패스프레이즈를 설정한 경우 키를 인증하려면 터미널이나 다이얼로그에 해당 패스프레이즈를 입력해야 합니다.

Git이 사용하는 두 프로토콜 간의 차이에 대한 개요는 프로토콜 사용에 관한 Git 문서를 참조하십시오.

패키지 관리자는 HTTP에 대한 사용자 이름과 비밀번호를 입력하거나 SSH 키를 잠금 해제하기 패스프레이즈를 입력할 수 있는 양방향 터미널 또는 다이얼로그를 제공하지 않습니다. 이를 바이패스하려면 다음 중 한 가지를 사용하십시오.

• 자격 증명 관리자(Windows용 Git 자격 증명 관리자 또는 OSXKeyChain)를 사용합니다.
• 터미널 또는 커맨드 프롬프트에서 Git 자격 증명을 사용합니다. 그런 다음 Unity가 캐싱되거나 저장된 자격 증명에 액세스할 수 있도록 동일한 터미널에서 Hub를 실행합니다.
• 터미널 또는 커맨드 프롬프트에서 백그라운드에서 실행 중인 SSH 에이전트를 사용하여 프로세스 ID를 GitHub 또는 GitLab에 제공합니다.