유니티(Unity) 깃허브 Github 배포 시 문제점
Unity로 프로젝트를 진행하다 보면, 많은 파일과 디렉터리가 함께 생성됩니다. 하지만 프로젝트를 배포하거나 협업을 위해 GitHub에 업로드하려고 할 때, 몇 가지 문제가 있습니다.
- 용량 문제: Unity 프로젝트의 용량이 너무 커서 업로드가 어려운 경우가 발생합니다.
- 불필요한 파일: 모든 파일과 폴더를 업로드하면 실제로 필요하지 않은 파일까지 공유되어 프로젝트가 불필요하게 무거워집니다.
이를 해결하기 위해 GitHub의 .gitignore 파일을 활용하면 효율적으로 프로젝트를 관리할 수 있습니다.
.gitignore를 사용하는 이유
.gitignore는 Git에서 특정 파일이나 디렉터리를 무시하도록 설정하는 파일입니다. Unity 프로젝트에는 빌드 결과물, 캐시 파일, 시스템이 생성하는 임시 파일 등이 포함되는데, 이 파일들은 프로젝트를 실행하거나 협업하는 데 필요하지 않습니다. 따라서 .gitignore를 설정하여 이런 파일들을 업로드 대상에서 제외할 수 있습니다.
유니티(Unity) 전용 .gitignore 파일 사용하기
GitHub에서는 공식적으로 프로그래밍 언어별로 권장 .gitignore 파일을 제공하고 있습니다. Unity 프로젝트를 위한 .gitignore 파일도 제공되며, 이를 사용하면 불필요한 파일을 간단히 제외할 수 있습니다.
Unity .gitignore 파일 다운로드
Unity.gitinore 에 접속한 뒤 Unity.gitignore파일을 다운로드합니다.
Github에서 제공하고있는 .gitignore 파일에는 다음과 같은 파일 및 디렉터리가 포함됩니다.
- 라이브러리 폴더 (Library/): Unity가 자동으로 생성하는 파일로, 용량이 크고 필요하지 않습니다.
- 로그 파일 및 캐시 (Logs/, Temp/): 디버깅용 파일로, 공유할 필요가 없습니다.
- 빌드 결과물 (Build/): 최종 실행 파일로, 소스 코드와 별도로 관리됩니다.
.gitignore 파일 적용하기
다운받은 .gitignore 파일을 프로젝트 루트 디렉터리에 옮기거나, 루트 디렉터리에서 .gitignore 라는 이름의 새 파일을 생성하여 전체 코드를 복사하여 붙여 넣어 적용할 수 있습니다.
Git에 반영하기 위해서는 git add . 명령어를 사용해 변경 사항을 추가하고 git comit -m "Add .gitignore"로 커밋합니다.
업로드된 프로젝트 파일들을 확인해 보면 불필요한 파일들은 제거하고 협업에 필요한 파일들만 업로드됩니다.
Unity에서 파일 불러오기
git저장소에 업로드된 파일을 로컬저장소에 복사한 뒤 UnityHub에서 Add - Add project form disk로 디렉터리를 지정하여 프로젝트를 불러올 수 있습니다.