팀 프로젝트 중 발생한 문제와 해결

내가 팀장이라고..?

 

 

팀 프로젝트 중 발생한 문제와 해결

1. 프로젝트 초기 Git 설정 문제 ( 근본 원인 )

 

문제 :

• 프로젝트 시작 시 main 브랜치에 .gitignore 를 제대로 설정하지 않았다.
• Unity 자동 생성 파일들이 그대로 커밋되면서 문제가 발생

영향 :

• 이후 develop 브랜치에서 새 브랜치를 생성하여 작업을 진행
• main 과 develop 병합 시 / develop 과 개인브랜치 병합 시 지속적인 Conflicted 충돌 발생

대표적으로 충돌났던 파일들 :

• Library/
• .plastic/
• ProjectSettings/ProjectSettings.asset
• packages-lock.json

해결 : 

1. 일단 Conflicted 를 먼저 수정 ( 가장 최신인 파일을 살려두고 병합을 진행 )
   프로젝트 초기화를 새로 하는 것이 깔끔하고 좋은 방법이지만
   강사님께서 이것도 경험이니 기존 파일을 수정하는 것을 권장
   Conflited 를 수정하기로 결정
2. .gitignore 를 Unity 기준으로 제대로 추가 / 수정
   Library/ , UserSettings/ 등 Unity 캐시류 무시
   문제였던 .plastic/ 같은 것도 무시 목록에 포함
3. .gitignore 에 추가했다고 해서 이미 올라간 캐시파일들이 자동으로 사라지지 않는 문제
   그래서 repository 에서 캐시 / 불필요 파일을 직접 제거하는 방식으로 정리하려고 시도

 

 

2. 브랜치 구조와 병합 혼선

 

문제 : 

• 구조 : main → develop → 개인 branch ( enemy, animation 등 )
• 그런데 main 은 초기 세팅부터 잘못 설정한, 첫 단추를 잘못 멘 파일
• develop 이 실제 최신 작업 branch

영향 :

• main 과 develop 을 병합 시도하려고 할때마다 지속적으로 Conflicted 문제 발생

혼란 :

• main 과 develop 을 병합할 때 어느 쪽을 살려야 하는지 헷갈림

• Merge 이후에도 충돌이 남았다고 표시되는 상황
• 이 과정에서 develop을 살리고 싶은데 왜 이렇게 복잡하지? 라는 스트레스가 컸다

해결 : 

• develop 이 최신이므로 develop 을 기준 브랜치 (Default repository)로 유지
• 충돌이 날 때 선택 기준을 통일 :
  최신 작업이 있는 쪽 ( develop ) 을 살린다
  GitHub Desktop 충돌 화면에서 develop 쪽 변경을 유지하는 선택을 반복
• main 을 삭제할지 말지 고민했는데, main 은 초기화 이후로 커밋한 내용이 하나도 없어 삭제를 진행

 

 

3. Github admin 설정 문제

 

문제 : 

• 앞서 작성한 문제점인 gitignore 설정을 제대로 하지 않아 첫 단추부터 잘못멘 main 때문에 지속적으로 충돌 발생
  그래서 최신인 develop 을 default repository 로 설정하려고 시도
  Github 관리자 권한이 없어서 변경이 불가능한 문제
• 프로젝트를 시작하기 전 깃 관리를 희망하고자 하는 작업자를 선정

• 깃 관리자가 admin 권한을 설정해줘야 하는데 목록에서 보이지 않는 문제점 발생 

해결 :

• admin 문제점을 해결하고자 공식 문서나 여러 커뮤니티를 검색하고 찾아봤는데 해결하지 못했다.
• admin 권한이 필요했던 이유는 현재 문제있는 main repository 를 포기하고
  최신인 develop 을 default repository 로 바꾸려는 목적이었다
• 굳이 admin 권한을 받을 필요없이 최고관리자인 팀원이 바꾸면 해결

해결 2 :

 

• 권한 변경은 Repository 를 public 이 아닌 Organization 으로 설정되어 있어야 가능하다

 

 

4. Unity 특성으로 인한 추가 충돌

 

문제 : 

• Unity 는 폴더 구조 + .meta 파일이 강하게 연결된다
• 폴더를 Unity 밖에서 삭제 / 이동하면서 .meta 는 남고 실제 폴더는 없는 상태 발생

결과 : 

• Merge 후 Missing script, Inspector 에서 컴포넌트 연결 안됨
• 컴파일 에러는 없는데 실행이 안되는 상태
• GameManager, BoardManager 참조 끊김
• 프리팹 / 스크립트 일부 Missing
• Merge 는 끝났는데 일이 끝난 게 아닌 상황
• 코드 + 에디터 상태를 동시에 봐야 하는 부담 발생

해결 :

• Git merge 후에 Unity 에서 다음을 점검 / 복구
  Missing Script 의 오브젝트 / 프리팹 확인
  Inspector 에서 스크립트 / 프리팹 재연결
  컴파일 에러는 없는데 연결이 끊긴 상태를 별도로 처리

 

 

5. 팀원의 최신화 / 커밋 비활성화 같은 운영 문제

 

문제 : 

• 작업할때 최신화를 하고 작업해야 하는데 몇몇 팀원들은 최신화를 하지 않고 작업하는 문제
• 팀원 중 한 작업자는 깃에 연동을 하지 않고 작업을 진행

해결 :

• 팀원들이 pull / fetch 해서 최신을 받아야 함을 전달함
• 깃에 연동을 하고 작업해야 하는 것을 전달함

• 잘 모르는 것이 있으면 고민하지말고 언제든지 질문해달라고 전달
• 작업자가 모르는 부분에 대해 아는 부분까지 상세히 답변