본문 바로가기
~2024.10

[Git/GitHub] 안드로이드 스튜디오 프로젝트를 원격 저장소와 연동하는 과정 정리글

by HJfan 2024. 4. 21.

🙏 포스팅을 읽기 전 참고해 주세요 🙏

해당 블로그는 신입 개발자가 공부한 내용을 기록 용도로 운영하는 공간입니다.

최대한 오피셜한 내용을 작성하려고 노력하고 있지만, 일부 부정확한 정보가 포함되어 있을 수 있습니다.

해당 내용은 댓글이나 메일을 남겨주시면 즉시 확인 후 조치를 취하도록 하겠습니다. 감사합니다.


1️⃣ 사전 준비

Android Studio와 git이 이미 준비되어 있다고 가정하고 시작하도록 하겠다.

2024년 4월 21일 기준 최신 git 버전은 2.44.0이고, 본인이 사용 중인 git 버전은 아래와 같다.

최신 안드로이드 버전은 아래와 같고, 가장 최신 버전으로 설치한 상태이다.

그럼 안드로이드 스튜디오에서 생성한 프로젝트를 Git으로 관리할 수 있도록 변경하고, GitHub 저장소와

연동하는 방법까지 알아보도록 하겠다. 정말 기초적인 연동까지만 진행할 것이기에 심화 과정을 원하는 사람들은

끝까지 읽지 않아도 될 것이라고 생각한다.

 

2️⃣ 연동 과정

가장 먼저 GitHub와 프로젝트를 연동하기 전 자신이 생성한 GitHub 저장소의 초기 상태를 살펴보자.

Readme.md 혹은 .gitignore 등의 옵션을 선택하여 초기 GitHub 원격 저장소에 파일이 존재할 경우

git clone 명령어를 사용하고, 아무 파일도 없이 GitHub 원격 저장소의 초기 상태가 비어있는 상태라면

git init -> git remote를 사용하는 것이 일반적인 방법이다. 본인은 .gitignore 파일 생성을 옵션으로

선택하여 git clone으로 진행하겠지만, 빈 원격 저장소와 연동하고자 하는 사람들을 위해

git init -> git remote 과정도 간단하게 설명하도록 하겠다.

(원격 저장소의 초기 상태가 본인과 동일한 사람들은 git init 과정을 진행하지 않도록 하자)

 

우선 프로젝트를 생성할 로컬 폴더에 접속하자.

그 후 마우스 우클릭 -> Git Bash Here 클릭 -> git init 명령어를 입력하면 해당 폴더는 git으로 관리되기 시작한다.

아래 이미지처럼 .git이라는 숨김 폴더가 생성되었다면 성공적으로 진행된 것이다.

 

그 후 GitHub 저장소의 <>Code가 적힌 초록 버튼을 클릭 후 HTTPS 아래의 저장소 주소를 복사한다.

 

원격 저장소의 초기 상태가 비어 있던 사람은 아래의 명령어 뒤에 복사한 주소를 초기 상태가 비어 있지 않던

사람들은 그 아래의 명령어 뒤에 복사한 주소를 붙여 넣어 Git Bash 창에 입력하도록 한다.

//원격 저장소 초기 상태가 비어있던 사람
git remote add origin https://github.com/사용자명/저장소명.git
//원격 저장소 초기 상태가 비어있지 않던 사람
git clone https://github.com/사용자명/저장소명.git

여기까지 진행했다면, 당신의 로컬 폴더는 git으로 관리되며 GitHub 원격 저장소와 연동된 상태이다.

이제 해당 폴더 내부에 안드로이드 프로젝트를 생성하기만 하면 끝이다.

 

안드로이드 스튜디오를 실행 후 'New Project' 옵션을 선택한 뒤 Save Location을 위 과정을 통해 생성한 폴더로

변경하는 것이다. (아마 폴더가 비어 있지 않다는 경고 문구와 Finish를 눌렀을 때 add 하겠냐는 팝업창에 출력될 텐데

해도 되고, 직접 git add 명령어를 터미널에 입력하여 수동으로 해도 상관없기에 아무 옵션이나 선택해도 된다.)

폴더 구조가 아래 이미지처럼 구성되어 있다면 성공적으로 프로젝트를 생성 후 원격 저장소와 연동한 것이다.

(add나 commit, push 등의 과정은 기회가 되면 다루도록 하겠다. 어디까지나 (안드로이드) 프로젝트를 GitHub

  원격 저장소와 연동하는 과정을 정리하는 것이 목적이었기에 이 정도로 마무리하도록 하려고 한다.)

 


📝 Reference

👉 -

👉 -

👉 -