[Git] Git 설치하고 유니티(Unity) 프로젝트와 연결하기

Git 설치하고 유니티 프로젝트와 연결하기

Git은 프로젝트의 버전을 관리할 수 있는 도구이다.
협업을 진행한다면 각자의 작업물을 합칠 때 주로 사용되고, 개인으로 사용하더라도 신규 기능을 개발하던 도중 이슈가 생겨 스크립트를 롤백해야 하는 등의 상황에 유용하게 쓰일 수 있다.

오늘은 Git을 설치하고, 유니티 프로젝트와 연결하는 법을 살펴보자.

 

1. Git 설치하기

Git 설치하기

▶ Git 설치 링크: https://git-scm.com/downloads

Git - Downloads

Git은 위의 사이트에 들어가 설치할 수 있다.
운영체제에 맞는 Standalone 파일을 다운로드하면 된다.

git 설치 과정

다운로드된 실행 파일을 실행시켜주면 이렇게 설치 프로세스가 진행된다.
Next를 눌러주면 다음 단계로 넘어가게 된다. 다음 단계인 설치 경로도 적절히 지정해주면 된다.

git 설치 옵션 설정

이 페이지에서는 각종 옵션을 설정할 수 있다.
나는 아래와 같이 체크해주었다. (NEW!) 기능은 취향에 따라 설정해주면 될 것 같다.

항목 이름	설명
Additional icons (On the Desktop)	바탕화면에 바로가기 추가 (대부분 아래의 Git Bash here을 사용하기 때문에, 체크해주지 않았다.)
☑️Windows Explorer integration	윈도우 폴더에서 우클릭 시 바로 Git에 접속할 수 있는 Git Bash here, Git GUI here 옵션을 추가
☑️Git LFS (Large File Support)	대용량 파일 지원
☑️Associate .git* configuration files with the default text editor	.git* 구성 파일을 기본 텍스트 편집기와 연결
☑️Associate .sh files to be run with Bash	실행할 .sh 파일을 Bash와 연결
Check daily for Git for Windows updates	윈도우 업데이트에 대한 git의 업데이트를 매일 확인
(NEW!) Add a Git Bash Profile to Windows Terminal	윈도우 터미널(명령 프롬프트)에 Git Bash 프로파일 추가
☑️(NEW!) Scalar (Git add-on to manage large-scale repositories)	Scalar 애드온 추가 (큰 repository 관리)

 

Git 에디터 선택

다음으로 쭉쭉 넘어가서 이 화면은 Git을 실행할 에디터를 선택하는 화면이다.
여러 선택지가 있지만 Bash를 통해 Git을 사용하는 경우엔 보통 디폴트인 Vim을 많이 사용하는 것 같다.

Git 디폴트 브랜치 이름 정의

깃에서 새로운 프로젝트를 생성(Init)할 때 보통 "master" 이라는 이름의 디폴트 브랜치가 생성된다.
다만 일부 프로젝트의 규칙에서는 "main"처럼 다른 이름을 사용하기도 하는데, Init을 했을 때 브랜치 이름을 어떻게 설정해야 하는지 선택할 수 있는 옵션이다.

나는 기본인 ☑️ `Let Git decide` 옵션을 선택해주었지만 필요에 따라 기본 브랜치 이름 변경 기능을 사용하면 될 것 같다.

HTTPS 연결 시 인증서 발급 방식

이후로는 아직 기능도 잘 모르는데 선택하라고 하는 것들이 잔뜩 뜨지만 쭉쭉 Next를 눌러 진행해주면 된다.

예외적으로 개인 사용자라면, 위의 선택지만 기본이 아래 것으로 되어 있는데, `Use the OpenSSL library`를 선택해주면 된다.
조직에서 인증서로 관리하는 경우 보안 채널을 사용해야 하고, 그럴 때에 아래 옵션 `Use the native Windows Secure Channel library` 을 선택해야 한다고 한다.

 

---

2. Git 초기 설정하기

Git Bash

Git을 처음 실행하면, 사용자 정보를 먼저 설정해주어야 한다.
우선 아무 폴더나 누르고, `Git Bash Here` 옵션을 눌러준다. (윈도우의 경우 '추가 옵션 표시' 내에 숨어 있다.)

이름과 이메일 설정하기

그러면 이렇게 Git 화면이 뜬다.
기초 설정에서는 계정 정보만 설정하고 넘어갈 것인데, 작업물을 표시될 정보라고 보면 된다.

이름 설정

git config --global user.name [이름]

이메일 설정

git config --global user.email [이메일주소]

 

 

3. 유니티 프로젝트 연결하기

유니티 프로젝트 폴더 열기

이제는 유니티 프로젝트 폴더에서 다시 Git Bash를 해보자.
유니티 프로젝트 폴더는 Unity Hub에서 경로를 확인하고 진입하거나, 메뉴 버튼 속에 있는 `Show in Explorer` 를 눌러서 폴더를 열어준다.
열어준 폴더에서 위에서와 마찬가지로 [우클릭 - 추가 옵션 표시 - Git Bash Here] 을 눌러주면 된다.

1. git init

git init

 

git init

이제 우리는 '이 폴더에서 git 기능을 사용할 것이다' 라는 의미의 `git init`을 해줄 것이다.
성공적으로 init이 되었다면 위처럼 폴더 경로 옆에 (master) 라는 표시가 생긴다.

2. git status

git status

 

git status

`git status` 명령어는 현재 상태를 보여준다.
현재는 커밋을 한 적이 없기 때문에 No commits yet 이라는 텍스트가 보이고 있다.

그리고 유니티 프로젝트 폴더에서 init을 했을 경우, 폴더에 기본적으로 존재하는 파일들이 Untracked files로 잡히게 된다.
이제 이 파일들을 커밋까지 해보도록 하겠다.

선행) .gitignore 다운로드하기

gitignore

그런데 유니티 폴더에는 꼭 git에 커밋해야 하는 폴더도 있지만 그렇지 않은 폴더도 있다.
불필요한 파일을 git에 업로드할 경우 용량을 낭비하게 되고, 성능 저하로 이어지기 때문에 꼭 필요한 파일만 업로드하는 것이 필요하다.

하지만 우리가 매번 커밋을 해줄 때 이 점을 신경쓸 순 없기 때문에 필요한 것이 .gitignore 파일이다.
이 파일을 폴더 안에 넣어주면, git에서 add, commit을 진행할 때 해당 파일들을 무시하게 된다.

▶ gitignore 다운로드: https://github.com/github/gitignore

GitHub - github/gitignore: A collection of useful .gitignore templates

 

폴더에 .gitignore 넣기

위 링크에서 Unity.gitignore 파일을 받아주고, 이름에서 'Unity'를 제거해 `.gitignore` 로 변경해주어야 한다.
그리고 프로젝트 폴더 안에 붙여넣어 주면 된다.

3. git add

git add

 

git add [파일 경로, 이름]
git add .

커밋을 하기 전, 이 커밋에 어떤 작업들을 포함시킬지 추가해주는 것이 `add` 명령어이다.
개별 파일을 지정해줄 수도 있지만, `git add .` 명령어를 사용하면 현재 변경점이 있는 모든 파일을 add할 수 있게 된다.

git status로 확인하기

그 다음 다시 `git status` 명령어를 사용하면 아까는 빨간 색으로 표시됐던 파일들이 이제는 초록색으로 표시되며 성공적으로 add된 것을 확인할 수 있다.

4. git commit

git commit

 

git commit -m "message"

커밋을 할 때에는 위의 명령어를 사용해주면 되고, 따옴표 안에는 커밋 메세지를 적어주면 된다.
커밋 메세지는 이번 커밋에서 어떤 변경점이 발생했는지 기록하는 역할이기 때문에, 히스토리 추적 및 공유를 위해서 구체적으로 작성하는 게 좋다.

따옴표를 닫지 않고 엔터를 치면 커밋 메세지를 여러 줄 작성할 수 있게 되니 참고하자. (마지막에 따옴표를 닫아주면 된다.)

5. git log

git log

 

git log

커밋한 내역을 확인하기 위해 `git log` 명령어를 사용해준다.
그러면 이렇게 작성자(위에서 설정한 이름, 이메일), 날짜, 그리고 커밋 메세지를 확인할 수 있다.

 

6. GitHub repository 연결하기 (git remote)

커밋 내용을 깃헙에 올리기 위해서는 GitHub Repository를 연결해주어야 한다.
우선 GitHub에서 레포지토리를 생성하는 것부터 시작하자.

GitHub에서 새로운 Repo 만들기

▶ GitHub 바로가기: https://github.com/

GitHub · Build and ship software on a single, collaborative platform

GitHub 계정이 없다면 회원가입을 해주고, 메인 페이지에서 'New' 버튼을 눌러 새로운 레포지토리를 생성해주면 된다.

Create repository

저장소의 이름, 설명, 공개 설정 등을 설정해주면 된다.
.gitignore을 위에서 소개한 방식으로 세팅할 수도 있지만 이렇게 프로젝트를 만들 때 .gitignore 파일을 추가한 상태로 저장소를 생성할 수도 있다.

저장소의 주소

생성된 저장소에서 저장소의 주소를 복사할 수 있다. 우리는 이걸 이용해 Git에서 저장소를 연결해볼 것이다.

 

git remote

git remote add [저장소 이름] [저장소 주소]
git remote -v

`git remote add` 명령어로 저장소를 연결할 수 있다.
복사한 주소는 [Shift + Insert] 키를 눌러 붙여 넣을 수 있다.

저장소를 연결한 뒤에 `git remote -v` 명령어를 사용하면 현재 연결된 저장소 목록을 확인할 수 있다.

7. git push

git push

 

git push origin master

원래 푸시 명령어는 이걸 입력하면 되는데,
Git을 처음 설치했다면 `remote: Invalid username or password. fatal: Authentication failed` 와 같은 에러가 나며 푸시에 실패할 것이다.

git push --set-upstream origin master

그럴 땐 이 명령어를 통해 푸시해주면, 자동으로 로그인 창이 뜨게 된다.
성공적으로 로그인을 한 뒤에는 푸시가 자동으로 진행된다.

git log로 결과 확인하기

git log로 결과를 확인해보면 이렇게 master 브랜치에 성공적으로 푸시된 것을 확인할 수 있다.
가장 우측의 `origin/master` 표시가 현재 커밋 중 저장소에 업로드된 마스터 브랜치의 상태임을 알려준다.

웹페이지에서도 확인하기

이렇게 정상적으로 푸시가 완료되었다면 이제 GitHub 홈페이지에서도 프로젝트 파일들이 정상적으로 업로드된 것을 확인할 수 있게 된다.