Unity 패키지 관리자

Unity는 꽤 오랫동안 존재해 왔으며 끊임없이 발전하고 있는 플랫폼입니다. 그러나 동시에 여러 프로젝트로 작업할 때 공통 소스(.cs), 라이브러리(.dll) 및 기타 자산(이미지, 사운드, 모델, 프리팹)을 사용하는 데 여전히 어려움을 겪을 수 있습니다. 이 글에서는 Unity의 이러한 문제에 대한 기본 솔루션 경험에 대해 이야기하겠습니다.

공유 자원 분배 방법

다양한 프로젝트에 공유 리소스를 사용하는 방법은 여러 가지가 있지만 각 접근 방식에는 장단점이 있습니다.

1. 복제 - 프로젝트 간 리소스를 "수동으로" 복제합니다.

장점 :

• 모든 유형의 자원에 적합합니다.
• 의존성 문제가 없습니다.
• 자산 GUID에는 문제가 없습니다.

단점 :

• 거대한 저장소.
• 버전 관리가 불가능합니다.
• 공유 리소스의 변경 사항을 추적하는 데 어려움이 있습니다.
• 공유 리소스를 업데이트하는 데 어려움이 있습니다.

2. Git 하위 모듈 — 외부 하위 모듈을 통한 공유 리소스 배포.

장점 :

• 소스로 작업할 수 있습니다.
• 자산을 분배할 수 있습니다.
• 의존성 문제가 없습니다.

단점 :

• Git 경험이 필요합니다.
• Git은 바이너리 파일에 그다지 친숙하지 않습니다. LFS를 연결해야 합니다.
• 저장소에 대한 액세스 제어.
• 버전 업그레이드 및 다운그레이드가 어렵습니다.
• GUID 충돌이 발생할 수 있으며 이를 해결하기 위한 Unity 측의 명확한 동작은 없습니다.

3. NuGet - NuGet 패키지를 통한 공유 라이브러리 배포입니다.

장점 :

• Unity에 의존하지 않는 프로젝트로 편리하게 작업할 수 있습니다.
• 편리한 버전 관리 및 종속성 해결.

단점 :

• Unity는 기본적으로 NuGet 패키지를 사용할 수 없습니다. GitHub에서 이 문제를 해결하는 Unity용 NuGet 패키지 관리자를 찾을 수 있지만 약간의 차이가 있습니다.
• 다른 유형의 자산을 배포하는 데 어려움이 있습니다.

4. Unity 패키지 관리자 - Unity용 기본 솔루션을 통해 공유 리소스를 배포합니다.

장점 :

• 패키지 작업을 위한 기본 인터페이스입니다.
• GUID 충돌로 인해 패키지의 .meta 파일을 덮어쓰는 것을 방지합니다.
• 버전 관리 가능성.
• Unity를 위한 모든 유형의 리소스를 배포할 수 있는 능력.

단점 :

• GUID 충돌은 여전히 ​​발생할 수 있습니다.
• 구현에 대한 문서가 없습니다.

후자의 방법은 단점보다 장점이 더 많습니다. 그러나 현재는 문서가 부족하여 그다지 인기가 없으므로 자세히 설명하겠습니다.

Unity 패키지 관리자

UPM(Unity Package Manager)은 패키지 관리 도구입니다. Unity 2018.1에 추가되었으며 Unity Technologies에서 개발한 패키지에만 사용되었습니다. 하지만 2018.3 버전부터 커스텀 패키지 추가가 가능해졌습니다.

Unity 패키지 관리자 인터페이스

패키지는 프로젝트 소스(Assets 디렉터리)에 포함되지 않습니다. 그들은 별도의 디렉토리에 있습니다 %projectFolder%/Library/PackageCache 어떤 식으로든 프로젝트에 영향을 미치지 않습니다. 소스 코드에서 언급된 유일한 내용은 파일에 있습니다. packages/manifest.json.

프로젝트 파일 시스템의 패키지

패키지 소스

UPM은 여러 패키지 소스를 사용할 수 있습니다.

1. 파일 시스템.

장점 :

• 구현 속도.
• 타사 도구가 필요하지 않습니다.

단점 :

• 버전 관리가 어렵습니다.
• 프로젝트에 참여하는 모든 사람은 파일 시스템에 대한 공유 액세스가 필요합니다.

2. Git 저장소.

장점 :

• 필요한 것은 Git 저장소뿐입니다.

단점 :

• UPM 창을 통해 버전 간에 전환할 수 없습니다.
• 모든 Git 리포지토리에서는 작동하지 않습니다.

3. npm 저장소.

장점 :

• UPM 기능을 완벽하게 지원하며 공식 Unity 패키지를 배포하는 데 사용됩니다.

단점 :

• 현재 "-preview"를 제외한 패키지의 모든 문자열 버전을 무시합니다.

아래에서는 UPM + npm 구현을 살펴보겠습니다. 이 번들은 모든 유형의 리소스로 작업하고 패키지 버전을 관리할 수 있으며 기본 UPM 인터페이스도 완벽하게 지원하므로 편리합니다.

npm 저장소로 사용할 수 있습니다 베르다치오. 상세한 내용이 있습니다 문서, 이를 실행하려면 몇 가지 명령만 필요합니다.

환경 설정

먼저 설치해야합니다 node.js.

패키지 만들기

패키지를 생성하려면 파일을 배치해야 합니다. package.json, 이 패키지의 내용이 포함된 디렉터리로 이동합니다. 다음을 수행해야 합니다.

패키지를 만들려는 프로젝트 디렉터리로 이동합니다.

npm init 명령을 실행하고 대화 상자에서 필요한 값을 입력하십시오. 이름에는 역방향 도메인 형식(예: com.plarium.somepackage)으로 이름을 지정합니다.
패키지 이름을 편리하게 표시하려면 package.json에 displayName 속성을 추가하고 채워주세요.

npm은 js 지향이므로 파일에는 Unity에서 사용하지 않는 필요하지 않은 기본 및 스크립트 속성이 포함되어 있습니다. 패키지 설명이 복잡해지지 않도록 제거하는 것이 좋습니다. 파일은 다음과 같아야 합니다.

1. 패키지를 만들려는 프로젝트 디렉터리로 이동합니다.
2. npm init 명령을 실행하고 대화 상자에서 필요한 값을 입력하십시오. 이름에는 역방향 도메인 형식(예: com.plarium.somepackage)으로 이름을 지정합니다.
3. 패키지 이름을 편리하게 표시하려면 package.json에 displayName 속성을 추가하고 채워주세요.
4. npm은 js 지향이므로 파일에는 Unity에서 사용하지 않는 필요하지 않은 기본 및 스크립트 속성이 포함되어 있습니다. 패키지 설명이 복잡해지지 않도록 제거하는 것이 좋습니다. 파일은 다음과 같아야 합니다.

   {
    "name": "com.plarium.somepackage",
    "displayName": "Some Package",
    "version": "1.0.0",
    "description": "Some Package Description",
    "keywords": [
      "Unity",
      "UPM"
    ],
    "author": "AUTHOR",
    "license": "UNLICENSED"
   }

5. Unity를 열고 package.json에 대한 .meta 파일을 생성합니다(Unity는 .meta 파일이 없는 자산을 볼 수 없으며 Unity용 패키지는 읽기 전용으로 열립니다).

패키지 보내기

패키지를 보내려면 다음 명령을 실행해야 합니다. npm publish --registry *адрес до хранилища пакетов*.

Unity Package Manager를 통해 패키지 설치 및 업데이트

Unity 프로젝트에 패키지를 추가하려면 다음이 필요합니다.

1. 파일에 추가 manifest.json 패키지 소스에 대한 정보. 이렇게 하려면 속성을 추가해야 합니다. scopedRegistries 특정 범위를 검색할 범위와 소스 주소를 나타냅니다.

   
   "scopedRegistries": [
      {
        "name": "Main",
        "url": "адрес до хранилища пакетов",
        "scopes": [
          "com.plarium"
        ]
      }
    ]
   

2. Unity로 이동하여 패키지 관리자 창을 엽니다(커스텀 패키지 작업은 내장 패키지 작업과 다르지 않습니다).
3. 모든 패키지를 선택합니다.
4. 필요한 패키지를 찾아서 추가하세요.

소스 작업 및 디버깅

소스를 프로젝트에 연결하려면 다음을 생성해야 합니다. 어셈블리 정의 패키지를 위해.

패키지를 사용해도 디버깅 옵션이 제한되지 않습니다. 하지만 Unity에서 패키지 작업 시 패키지에 오류가 발생한 경우 콘솔에서 해당 오류를 클릭하여 IDE로 이동할 수 없습니다. 이는 어셈블리 정의를 사용할 때 스크립트가 라이브러리에 수집되어 프로젝트에 포함되기 때문에 Unity가 스크립트를 별도의 파일로 보지 않기 때문입니다. 프로젝트의 소스로 작업할 때 IDE를 클릭하는 것이 가능합니다.

연결된 패키지가 있는 프로젝트의 스크립트:

작동 중단점이 있는 패키지의 스크립트:

패키지에 대한 긴급 수정

프로젝트에 추가된 Unity 패키지는 읽기 전용이지만 패키지 캐시에서 편집할 수 있습니다. 이렇게 하려면 다음이 필요합니다.

1. 패키지 캐시의 패키지로 이동합니다.

   

2. 필요한 사항을 변경합니다.
3. 파일의 버전 업데이트 package.json.
4. 패키지 보내기 npm publish --registry *адрес до хранилища пакетов*.
5. UPM 인터페이스를 통해 패키지 버전을 수정된 버전으로 업데이트하세요.

패키지 가져오기 충돌

패키지를 가져올 때 다음과 같은 GUID 충돌이 발생할 수 있습니다.

1. 패키지 - 패키지. 패키지를 가져올 때 이미 추가된 패키지에 동일한 GUID를 가진 자산이 포함되어 있는 것이 발견되면 가져온 패키지의 GUID가 일치하는 자산이 프로젝트에 추가되지 않습니다.
2. 패키지는 프로젝트입니다. 패키지를 가져올 때 프로젝트에 일치하는 GUID가 있는 자산이 포함되어 있는 것으로 발견되면 패키지의 자산이 프로젝트에 추가되지 않습니다. 그러나 이에 의존하는 자산은 프로젝트의 자산을 사용하기 시작합니다.

프로젝트에서 패키지로 에셋 전송

Unity가 열려 있는 동안 프로젝트에서 패키지로 에셋을 전송하면 해당 기능은 유지되고 종속 에셋의 링크는 패키지의 에셋을 사용하기 시작합니다.

중요한 일이야: 프로젝트에서 패키지로 에셋을 복사할 때 위 섹션에서 설명한 "패키지 - 프로젝트" 충돌이 발생합니다.

갈등에 대한 가능한 해결책

1. 충돌을 제거하기 위해 모든 자산을 가져올 때 자체 알고리즘을 사용하여 GUID를 다시 할당합니다.
2. 모든 에셋을 하나의 프로젝트에 추가한 다음 패키지로 나눕니다.
3. 모든 자산의 GUID를 포함하는 데이터베이스를 생성하고 패키지를 보낼 때 유효성 검사를 수행합니다.

결론

UPM은 Unity에서 공유 리소스를 배포하기 위한 새로운 솔루션으로, 기존 방식에 대한 가치 있는 대안이 될 수 있습니다. 기사에 설명된 권장 사항은 실제 사례를 기반으로 했습니다. 이 정보가 도움이 되기를 바랍니다.

출처 : habr.com