Android Studio에서 Github에 프로젝트 올리기

로컬환경에서 안드로이드 스튜디오를 이용해서 앱 제작 프로젝트를 진행했다.

하지만 원활한 코드관리, 공유와 배포를 위해서 내 개인 노트북 디렉터리가 아닌 깃허브에 프로젝트를 올리기로 했다.

안드로이드 스튜디오에서 개인 레포지토리로 코드를 올리는 방법을 알아보자.

Android Studio의 VCS 메뉴

Android Studio에서 Git은 외부 프로그램에 속해 VCS라는 버전 관리 시스템을 이용해 관리해야 한다.

VCS 하위 메뉴

이미 Github에 연결된 사람이 라면 Git이라고 쓰여있는, 현재는 VCS라는 메뉴를 상단 내비게이션바에서 선택한다.

그럼 하위 메뉴들이 많이 나오는데 우린 여기서 딱 봐도 Git과 Github와 관련이 있을 것 같은

Create Git Repository와 Share Project on Github 메뉴를 활용해 Github에 프로젝트를 올릴 것이다.

1. Share Project on Github

뭔가 옆에 우리가 아는 친숙한 로고가 같이 있으니 더 끌리는 것 같아 이 메뉴 먼저 실험해 보도록 한다.

메뉴를 클릭했더니 창과 함께 로딩창이 뜬다.

Loading Account Information For github.com/계정

난 현재 안드로이드 스튜디오에 깃허브 계정이 연동되어 있어 계정 인증이 되었지만 안된다.

인증이 안 되어 있는 사람들을 위한 인증 방법을 설명할 테니 필요 없는 사람은 건너뛰면 된다.

깃허브 계정 인증

GitHub에 로그인

안드로이드 스튜디오에 미리 계정을 연동시켜놓지 않았다면 이런 창이 뜰 텐데

단순히 GitHub를 로그인하라는 것이니 Log In via GitHub 버튼을 눌러준다.

깃허브 인증 확인 창

그럼 이런 창이 크롬에 열리고 Authorize in GitHub 버튼을 눌러주면 된다.

깃허브 인증 완료 창

인증이 된 것을 확인할 수 있다.

 

Share Project on Github

인증이 되었다면 다시 돌아와서 메뉴를 눌렀을 때 뜬 창을 본다.

Share Project On Github

이 메뉴는 안드로이드 스튜디오를 이용해서 Repository를 만들 수 있는 메뉴이다.

때문에 깃허브에서 만들 때와 동일하게 관련 정보를 입력해줘야 한다.

• Repository name : 레포지토리 이름을 입력하는 부분이다.
• Remote: 원격 저장소의 이름을 입력하는 부분이다.
• Description: 올릴 레포지토리의 설명을 넣는 부분이다.
• Private Checkbox: 레포지토리의 상태를 Private로 할 것인지 Public으로 올릴 것인지 설정한다.

원하는 이름과 설명을 입력하고 Private로 올릴 것인지 Public으로 올릴 것인지 설정한다.

마지막 Remote는 처음 올리는 프로젝트라면 특별히 건들지 않는 것이 좋다. 

Remote를 간략히 설명하자고 넘어갈 것인데 필요하지 않거나 이미 알고 있다면 건너뛰어도 좋다.

Remote

원격 저장소는 Git 프로젝트를 호스팅 하는 온라인 위치이다. (우리는 GitHub를 사용한다.)

로컬 저장소에서 작성한 코드와 변경 사항을 원격 저장소를 push 하거나 update 할 때 사용된다.

Remote의 기본값으로 나오는 origin은 일반적인 원격 저장소의 기본 이름이다.

로컬 저장소와 연결된 첫 번째 원격 저장소를 보통 자동으로 origin으로 설정한다.

결론적으로 Remote 이름을 설정한다는 것은 프로젝트가 어떤 원격 저장소와 연결되는지에 대한 이름을 설정한 것이다.

 

그래서 후에 다른 원격저장소와 Remote 한다고 하면 그 Github 링크를 추가하는 것이다.

// 원격 저장소 보기
git remote -v

// 원격 저장소 추가
git remote add origin <repository-url>

// 원격 저장소 이름 변경
git remote rename <old-name> <new-name>

// 원격 저장소 삭제
git remote remove <name>

Create Git Repository

다시 돌아와 Share 버튼을 눌렀다면 아래와 같은 창으로 넘어갈 것이다.

Create Git Repository

이제 로컬에 Git 저장소를 생성해야 한다.

프로젝트 폴더를 선택하여 해당 디렉터리에 Git 저장소를 생성한다.

로컬 Git 저장소를 초기화하며, 이후 프로젝트를 관리하거나 원격 저장소와 동기화할 수 있게 만든다.

원하는 디렉터리를 선택하고 OK를 눌러준다.

Add Files For Initial Commit

갑자기 로딩이 되면서 아래와 같이 파일들이 다 빨간색으로 변하고 창이 뜰 것이다.

Add Files For Intial Commit

바로 초기 커밋을 설정하는 창이다.

올릴 파일을 선택하고 Commit Message를 설정한다.

기본으로 현재 모든 파일이 선택되어 있고 기본 메시지는 Initial commit이라고 되어있다.

Add 버튼을 눌러준다.

push가 완료된 모습

이제 그럼 repository 생성과 올리기가 끝났다.

그럼 빨간색이었던 파일들이 정상으로 바뀌고 위 사진처럼 우하단에 Successfully shared project on Github가 뜰 것이다.

위에 있던 VSC 메뉴는 Git 메뉴로 바뀌었고 왼쪽 사이드바엔 commit이라는 메뉴가 생겼다.

💡파일 색은 빨간색(추가된 파일), 초록색(Commit 된 파일), 파란색(수정된 파일)이 있다.

 

2. Create Git Repository

이번엔 다른 하위 메뉴인 Create Git Repository를 선택해 본다.

Create Git Repository

앞선 메뉴와 다른 게 Create Git Repository가 바로 나온다.

기능은 똑같이 Git 로컬 저장소를 만들어주시는 것이니 OK를 눌러준다.

로컬 저장소가 만들어졌지만 원격 저장소와는 연결되지 않은 상태

또 파일들이 빨간색으로 변하고 위에 VCS 메뉴도 Git으로 바뀌고 왼쪽 사이드바에 commit 버튼도 생길 것이다.

이건 현재 폴더가 로컬 저장소가 되었지만 아직 Github와 같은 원격 저장소와 연결되지 않아서 발생하는 현상이다.

이를 해결해 주기 위해 위에서도 언급되었던 Remote를 해줘야 한다.

Git 메뉴를 선택하면 나오는 하위 메뉴 중 Manage Remotes... 를 선택한다.

Git 하위 메뉴

물론 위에 GitHub를 선택해서 Share Project on GitHub를 누른다면

GitHub->Share Project on GitHub

이 글에서 소개하는 첫 번째 방법이었던 Share Project on GitHub 방식으로 해결할 수 있지만

우린 지금 2번째 방법을 설명 중이니 얌전히 Manage Remotes... 를 눌러주겠다.

Git Remotes

그럼 Git Remotes 창이 나온다.

Git Remotes 창은 연결되어 있는 원격 저장소를 표시해 주는 창인데

현재 연결된 것이 없이 Nothing to show라고 뜨는 것을 확인할 수 있다.

Remote를 추가해 주려면 위에 화살표 같이 생긴 Add 버튼을 누른다.

Define Remotes

위에서 설명한 바와 같이 기본 Remote라 이름은 기본값으로 origin이 들어가 있다.

또 여기엔 URL을 입력해줘야 하는데 이를 위해선 깃허브에 들어가 레포지토리를 미리 만들어 놓아야 한다.

귀찮을 수도 있지만 장점은 현재 연동되어 있는 깃허브 계정이 아니라 다른 계정의 레포지토리에도 올릴 수 있다는 점이다.

 

레포지토리를 만들고 들어가 초록색 Code라고 쓰여있는 부분을 클릭한다.

💡레포지토리를 만들 때 README를 추가하고 만들면 history가 꼬여 Remote의 오류가 생길 수 있으니 주의하자.

 

 

<> Code -> Local -> HTTPS

그럼 위 창이 나올 텐데 Copy url to clip board라고 설명되어 있는 버튼을 눌러 복사한다.

완성된 remote

그리고 URL 칸에 붙여 넣어 주고 OK를 누르면 된다.

Remote 완료

Remote가 완료되었으니 앞에서 했던 것처럼 다시 Git의 하위 메뉴로 들어가 commit 후 push를 해준다.

Git->Commit

commit은 Git 하위 메뉴나 우상단 Git 메뉴바 옆에 체크모양 표시를 누르거나 왼쪽 사이트바에 commit을 눌러주면 된다.

commit

난 옆에 사이드바를 선택해 모든 파일을 체크해 주고 커밋 메시지를 작성해 줬다.

Push Commits to TodoApp

commit and push 버튼을 눌러주고 위 화면이 뜬다면 Push 버튼을 눌러준다.

그럼 이제 성공적으로 모든 작업이 완료된 것을 확인할 수 있다.

 

Next

이렇게 Android Studio를 이용하여 리포지토리에 프로젝트를 올리는 방법을 알아보았다.

다음엔 브런치를 잘못 올렸을 경우를 대비한 Pull Request 하는 법을 알아보자.