[Unity] Custom Unity Package in Git 맹들기

회사에서 프로젝트 개발시 필요한 공통모듈을 각각 다운받을 수 있는 Editor 화면을 하나 만들고 있다.

 

다행히 Unity 에서 Git 저장소 정보를 package.json 파일 안에 담아서 그 파일을 기반으로 정보를 가져오는 기능을 제공한다.

(Unity Package Manager 에서 Github 에 있는 오픈 소스를 Git Url 로  다운받아본 적이 있을 것이다).

 

Unity 에서 권장하는 Custom Package 모양은 다음과 같다.

Unity - Manual: Package layout

---

1. Unity Custom Package 를 만들기 위한 Unity 프로젝트와 Git Repository를 만든다.

나중에 캡처해서 내용이 차있는데, 빈 Unity gitignore 를 포함한 Repository 를 만들면 된다.

 

 

2. Asset 폴더 안에 위에서 만든 GIt Repository를 다운받는다.

 

3. 아래와 같이 폴더 및 package.json 파일을 만든다.

다운 받은 custom package 경로에 package.json 파일을 만든다.

(UPM(Unity PackageManager)은 package.json 파일을 읽어와서 Unity Package Manger 에 표시한다.)

Runtime 폴더를 만든다.

Runtime 폴더에는 SampleToolKit(가칭) 스크립트를 만든다. Runtime 시에 수행할 내용을 적는 Script.

Editor Script 는 Editor 폴더에, Play Script 는 Runtime 폴더에 넣는다.

 

4. package.json 파일을 작성한다.

name, version 내용은 Project Settings > Player 화면에서 확인 및 수정할 수 있다.

각 Key 값에 따른 UI, Function이 UPM(Untiy Package Manger) 에 정의되어 있고 이를 활용하는 것.

 

 

5. 만든 & 수정한 내용을 Git에 Commit & Push 한다.

 

6. Unity Package Manger 에서 다운받아본다.

git URL 로 package 를 추가해보면 정상적으로 추가되는 것을 확인할 수 있다.

 

package.json 폴더에 적은 내용 대로 UPM(Unity Package Manager)에  정보가 표시된다.

수정할 내용이 있으면 Git 에 Commit&Push 하고 Update 버튼으로 편리하게 업데이트가 가능하다.

 

P.S)

We can't assign a new GUID because the asset is in an immutable folder. The asset will be ignored.

참고로 위 에러가 뜨면 unity package가 중복되어서 생긴 오류이다. 작업완료 후 sample-unity-package 는 Packages 폴더에 있을테니 sample-unity-package 폴더를 지우면 된다.

---

참고) Unity Custom Package 생성 Document

https://docs.unity3d.com/kr/2021.3/Manual/CustomPackages.html#EmbedMe

커스텀 패키지 생성 - Unity 매뉴얼

 

참고) Unity Tutorial: Creating Your Own Custom Unity Package in Git

https://www.youtube.com/watch?v=31D46795veE