Unity Git 종속성 관리

Unity에서 Git 종속성을 관리하는 방법에 대한 간단한 가이드입니다. 이 문서에서는 Git URL을 사용하여 패키지를 설치하는 방법과 관련된 필수 요구 사항 및 다양한 프로토콜을 설명합니다.

1. 요구 사항

Git 종속성을 사용하기 위해서는 다음을 준비해야 합니다: - Git 클라이언트 (최소 2.14.0 버전). - Git 실행 파일 경로가 시스템 PATH에 추가되어야 합니다. - Git LFS를 사용하는 경우, Git LFS 클라이언트도 설치해야 합니다.

2. Git URL 및 사용법

패키지 관리자는 로컬 경로를 제외한 모든 Git 프로토콜을 지원합니다. 아래는 Git URL의 기본 형식입니다:

• .git 확장자가 필요할 수도 있고, 경우에 따라 생략할 수 있습니다.
• 기본적으로 URL이 Git 종속성으로 인식되려면 패키지 매니페스트에 Git URL을 추가해야 합니다.

3. 프로토콜 사용

HTTP/HTTPS 프로토콜

HTTPS 프로토콜을 사용하는 경우 다음과 같이 작성합니다:

{
  "dependencies": {
    "com.mycompany.mypackage": "https://github.example.com/myuser/myrepository.git"
  }
}

SSH 프로토콜

SSH 프로토콜을 사용하는 경우 다음과 같이 작성할 수 있습니다:

{
  "dependencies": {
    "com.mycompany.mypackage": "ssh://git@mycompany.github.com/gitproject/com.mycompany.mypackage.git"
  }
}

4. 특정 리비전 타게팅

패키지 관리자가 특정 리비전을 로드하도록 하려면 Git URL 뒤에 # 리비전을 추가하세요. 예를 들어:

{
  "dependencies": {
    "com.mycompany.mypackage": "https://github.example.com/myuser/myrepository.git#v2.0.0"
  }
}

리비전은 태그나 브랜치 또는 전체 커밋 해시로 설정할 수 있습니다.

5. 하위 폴더에 패키지 지정

패키지가 저장소의 루트에 없을 경우, 비공식적 패키지 구조를 가진 저장소에서 라이브러리를 설치할 수 있습니다. 다음과 같이 path 쿼리 파라미터를 사용합니다:

{
  "dependencies": {
    "com.mycompany.mypackage": "https://github.example.com/myuser/myrepository.git?path=/subfolder"
  }
}

6. 잠긴 Git 종속성

지원 받기 위해 잠금 파일을 사용하여 특정 Git 종속성의 커밋 해시를 저장할 수 있습니다. 이는 프로젝트를 다른 사용자와 공유할 때 일관성을 유지하는 데 중요합니다.

7. Git LFS 지원

Git LFS를 사용할 경우, 패키지 관리자는 Git LFS를 지원하는 저장소에서 Git 종속성을 가져올 수 있습니다. 패키지 관리자는 추가적인 구성 없이 LFS 파일을 자동으로 관리합니다.

8. 예제

아래는 여러 Git 종속성을 포함한 예제입니다:

{
  "dependencies": {
    "com.mycompany.package1": "https://github.example.com/myuser/package1.git",
    "com.mycompany.package2": "ssh://git@github.example.com/myuser/package2.git?path=/subfolder",
    "com.mycompany.package3": "https://github.example.com/myuser/package3.git#v1.0.0"
  }
}

결론

이 문서에서는 Unity에서 Git 종속성을 관리하는 방법과 다양한 활용 방안에 대해 설명했습니다. Git URL을 사용하는 것에서부터 안전한 인증 방법까지 다루었으므로, 필요에 따라 적절히 활용하시면 됩니다. 추가적인 정보나 문의 사항이 있다면, Unity의 공식 문서나 커뮤니티 포럼을 참조하시기 바랍니다.