[안드로이드 스튜디오] Bitbucket Git 연동하기

 [사진이 잘 안 보이신다면 사진을 한 번 클릭해주시면 원본 파일로 보실 수 있습니다.]

 안드로이드 스튜디오에서 Git을 통해 Bitbucket(비트버킷)과 연동을 해보겠습니다. Github도 좋지만 비공개 repository(저장소)는 유료로 제공하고있습니다. 이런점에서 Bitbucket은 비공개 repository를 무료로 제공하고있기 때문에 좋은 것 같습니다. 우선 Bitbucket을 사용하기위해서 사이트에 가입을 하셔야합니다. 구글 아이디로 간단하게 가입을 할 수 있습니다.

https://bitbucket.org/

 간단한 가입을 끝내셨으면 다음으로 Repository(저장소)를 만드셔야합니다. 로그인을 하신 상태에서 왼쪽 상단의 + 버튼을 눌러 Repository를 만들어줍니다.

 원하시는 이름을 적으신 후 Create repository를 눌러주시면 됩니다. 기본적인 설정은 알아서 되어있으므로 Bitbucket을 사용하는 목적이 비공개를 위해서 이므로 'This is a private repository'도 체크 상태를 확인하여줍니다. 그리고 버튼을 눌러주셨으면 잠시 뒤 repository가 생성이되고 다음과 같은 메뉴를 보실 수 있습니다.

 이름을 example이라 만들었기 때문에 만드신 이름이 적혀있게됩니다. 그럼 Bitbucket에서의 기본적인 세팅은 끝이났습니다. 그럼 다음부분으로 넘어가 보겠습니다. 우선 사용자의 컴퓨터에 아무것도 없는 상태라 생각하고 진행을 하겠습니다. Git을 이용하여야 하기 때문에 컴퓨터에 Git을 설치해 주어야합니다.

https://www.git-scm.com/

 오른쪽 중앙에 Download for Windows 나 다른 OS를 사용하시면 그에 맞는 OS를 찾아 다운로드하여 설치를 해주시면됩니다. Git 설치를 다 하셨으면 이제 안드로이드 스튜디오로 넘어가 보겠습니다. Example이기 때문에 새로운 Project를 하나 만들겠습니다. 기존의 Project가 있다면 기존 project를 불러오신 후 진행해 주시면 됩니다. Bitbucket을 사용할 것이므로 안드로이드 스튜디오에서 제공하는 Bitbucket plugin을 설치해주겠습니다. 

 [Tools] 메뉴에서  [Android] - [SDK Manager]로 들어가줍니다. 그다음은 아래 사진처럼 [plugins] 메뉴로 들어가 [Browse repositories...] 을 눌러 나온 plugin 중 Bitbucket을 검색해서 설치해주시면 됩니다.(Bitbucket Link가 아닙니다.) 혹시 Bitbucket이 검색이 안되는 경우도 있기 때문에 파일을 올려드리겠습니다. 파일을 통한 설치를 하시는 경우는 아래의 분홍색으로 적어놓은 글을 확인해 주시면 됩니다.

 혹시 Bitbucket Link가 검색되는등 Bitbucket이 없다면 아래의 파일을 받으신 후 위의 [Browse repositories...] 옆에있는 [Install plugin from disk...] 란을 클릭하신 후 다운받으신 파일로 설치를 진행해 주시면 됩니다.(저작관 관련 문제가 있다면 말해주시면 링크로 대체하겠습니다.)

bitbucket.jar

 그럼 이제 설치를 다하셨으면 Bitbucket 아이디를 안드로이드 스튜디오와 연동시키겠습니다. 위와 같이 [Tools] - [Android] - [SDK Manager]로 들어가줍니다. 그다음 이번에는 [Plugins]가 아니라 [Other Settings]로 들어가주시면 Bitbucket 란이 새로 생긴것을 보실 수 있습니다. 없다면 안드로이드 스튜디오를 완전히 종료했다 다시 실행시켜주시면 나타나게 됩니다.

 아이디와 비밀번호를 입력한 후 Test 버튼을 눌러 계정의 연동을 확인해 줍니다. Success 했다 나오면 아래의 OK 버튼을 눌러 [SDK Manager]를 종료합니다. 다음으로 해당 Project를 Git과 연동하여 보겠습니다. [VCS] 메뉴에서 [Enable Version Control Intergration...]을 선택하여 줍니다.

 클릭을 하시면 새로운 창이 다음과 같이 뜰것입니다. Option을 펼쳐 Git을 선택한 후 OK 버튼을 눌러줍니다.

 이제 안드로이드 스튜디오에서도 기본적인 작업은 끝났습니다. 여기까지 해주시면 안드로이드 스튜디오에서 이전과 다른점으로 다음과 같은 차이가 나타나게됩니다. 첫번째로 이름들의 색이 변화됩니다. 갈색은 저장소에 저장이되지 않았다는 뜻입니다.

 두번째로 안드로이드 스튜디오 오른쪽 하단에 Git: Master가 생기게됩니다. Git을 사용할 수 있다는 뜻입니다. Master는 Main 줄기로 여러 업데이트를 할 때 표시를 해주시고 싶으면 해당 구역을 클릭하여 branch를 생성(바꿀 특징을 이름으로)하여 Git에 추가 할 수도있습니다.

 이제 준비는 모두 끝났습니다. Git에 현재있는 Project를 전송해 보겠습니다. Project를 전송하기에 앞서 Git에 Project 내용들을 추가시켜 주어야합니다.(등록하실 맨 처음만 한 번 하시면 됩니다.) App은 [app]에서 [Add] 해주시면 되지만 Gradle은 파일 전체를 선택해주시고 [Add] 해주셔야 합니다.

< app - Git - Add>

<Gradle 모두 선택 - Git - Add>

 여기까지 해주시면 갈색이였던 이름들이 초록색으로 바뀐것을 확인하실 수 있습니다. 다음으로 [VCS] - [Git] - [Commit File...]으로 들어가줍니다.

 들어오시면 아래와 같은 화면을 보실 수 있습니다. 굳이 다해줄 필요는 없지만 저는 다해주는 편이므로 위쪽의 폴더들을 최소화 시켜준다음 체크를 다시해주어 모든 파일이 제출될 수 있도록 하였습니다. 아래의 코드는 현재는 하나만 나와있지만 추후 코드를 수정하여 commit을 하면 이전 코드와 바뀐 코드가 표시되어 나오게됩니다. Commit Message에 무슨 내용을 Commit 하는지 메세지를 작성해 주실 수 있습니다. 이제 Commit을 누르시면 시간이 조금 걸리지만 성공했다는 메세지가 나오게 될 것입니다. 코드자체에 오류가 없다면 나오는 오류 메시지는 무시하시고 Commit 버튼을 눌러 이어서 해주시면 됩니다.

 이제 Bitbucket의 repository로 commit한 내용을 Push해보겠습니다. 위와 비슷한 방식으로 [VCS] - [Git] - [Push] 로 들어가줍니다. 그럼 아래와 같은 화면을 보실 수 있습니다. 

 심플한 화면이 뜨는것을 확인할 수 있습니다. 아까 만들었던 Master가 화살표로 Define remote를 가르키고있습니다. 말그대로 Push하실 repository를 정의해 주셔야합니다. [Define remote]를 클릭하여줍니다. 그럼 URL을 적는란이 나오게됩니다. 이제 이 URL을 알기위해 다시 Bitbucket에서 만들어논 repository로 가보겠습니다.

 위의 사진처럼 Repository의 메뉴에서 Commits를 눌러주신 후 오른쪽 위의 HTTPS의 주소를 복사하여줍니다. 주소를 더블클릭 해주시면 주소가 전체선택 됩니다. 복사를 마친 뒤 해당 URL을 아래 사진과 같이 URL을 적는 란에 넣어줍니다. 그리고 OK 버튼을 눌러줍니다. 

(URL 주소가 안 보이실경우 이글의 댓글을 참조하여 URL을 확인해 주시길 바랍니다!)

 그럼 정상적인 URL 인지 체크를 한 뒤 정상적인 Repository URL이라면 아까 보내겠다 설정해주신 코드와 메세지가 아래와 같이 보이게됩니다.

 이제 Push를 눌러 Bitbucket의 Repository로 보내보겠습니다. Push의 진행사항이 안드로이드 스튜디오의 맨 아래의 작업표시줄을 통해 진행사항을 표시해 주게됩니다. 완료가 되었다 나오면 Bitbucket의 Repository로 가보겠습니다.

 아까와 같이 [Commits] 란에 들어와보니 Push가 잘 된것을 확인할 수 있습니다. 다른 메뉴인 [Source]나 [Download]를 봐도 잘 올라오것을 확인 할 수 있습니다. 이제 앞으로 코드를 수정하셨을 경우 Commit을 해주신 뒤 Push를 통해 Repository로 코드를 올리 실 수 있습니다. 각각의 Commit들은 분리되어 있기 때문에 어느부분이 수정되었는지 Git이 자동으로 분석해주어 이전과 어느 부분이 바뀌었는지도 한눈에 파악하실 수 있습니다. Git의 세계에 오신것을 환영합니다.