GitHub로 Flutter 팀프로젝트 관리하기

1. 리포지토리 생성 및 팀원 초대

1. 리포지토리 생성하기
   • GitHub 웹사이트에 로그인한 후, 오른쪽 상단의 + 버튼을 클릭하고 New repository를 선택합니다.
   • Repository name 필드에 Flutter 프로젝트의 이름을 입력합니다.
   • Description 필드에 프로젝트에 대한 간단한 설명을 입력합니다.
   • Public 또는 Private을 선택합니다:
     • Public: 누구나 볼 수 있습니다.
     • Private: 초대된 사람만 볼 수 있습니다.
   • Create repository 버튼을 클릭하여 리포지토리를 생성합니다.
2. 팀원 초대하기
   • 생성한 리포지토리 페이지로 이동합니다.
   • 상단의 Settings 탭을 클릭합니다.
   • 왼쪽 사이드바에서 Collaborators 또는 Manage access를 선택합니다.
   • Invite a collaborator 버튼을 클릭합니다.
   • 팀원의 GitHub 사용자명을 입력하고 Add 버튼을 클릭하여 초대합니다.

2. Flutter 프로젝트 설정

2.1. Flutter 프로젝트 생성하기

• 터미널을 열고 Flutter 프로젝트를 생성할 폴더로 이동합니다.

cd /path/to/your/projects

• 새로운 Flutter 프로젝트를 생성합니다.

flutter create my_flutter_project
cd my_flutter_project

2.2. 로컬 Git 리포지토리 초기화하기

• Flutter 프로젝트 폴더에서 Git을 초기화합니다.

git init

 

2.3. .gitignore 파일 설정하기

• Flutter 프로젝트에는 자동으로 .gitignore 파일이 생성되지만, 추가적으로 필요한 항목이 있을 수 있습니다. 기본적으로 다음 항목들이 포함되어야 합니다.

.dart_tool/
.flutter-plugins
.flutter-plugins-dependencies
.packages
build/

• 이 파일이 이미 존재하면 확인 후 사용하세요.

2.4. 파일 추가 및 커밋하기

• 모든 파일을 Git의 관리 하에 추가합니다.

git add .

• 첫 커밋을 수행합니다.

git commit -m "Initial commit with Flutter project"

 

2.5. 원격 리포지토리 연결 및 푸시하기

• GitHub에서 생성한 리포지토리와 로컬 리포지토리를 연결합니다. 아래 URL을 자신의 리포지토리 URL로 바꿉니다.

git remote add origin https://github.com/username/my_flutter_project.git

• 기본 브랜치를 main으로 설정하고 원격 리포지토리로 푸시합니다.

git branch -M main
git push -u origin main

3. 브랜치 생성 및 보호 설정

3.1. develop 브랜치 생성하기

• 새로운 브랜치 develop을 생성하고 원격 리포지토리로 푸시합니다.

git checkout -b develop
git push -u origin develop

 

3.2. 브랜치 보호 설정하기

• GitHub 리포지토리 페이지에서 Settings 탭을 클릭합니다.
• 왼쪽 사이드바에서 Branches를 선택합니다.
• Add rule 버튼을 클릭합니다.
• Branch name pattern 필드에 main 또는 master를 입력합니다.
• Require pull request reviews before merging과 Include administrators를 체크하여 보호 규칙을 설정합니다.
• Create 버튼을 클릭하여 설정을 저장합니다.

4. 팀원 작업 및 풀 리퀘스트(PR) 만들기

4.1. 팀원이 브랜치 클론하기

• 팀원이 리포지토리를 자신의 컴퓨터에 복사합니다.

git clone https://github.com/username/my_flutter_project.git
cd my_flutter_project

 

4.2. 팀원이 새로운 브랜치 생성하기

• 팀원이 작업을 위해 새로운 브랜치를 생성합니다.

git checkout -b feature/feature-a

 

4.3. 작업 후 커밋 및 푸시하기

• 작업한 파일을 Git의 관리 하에 추가합니다.

git add .

• 변경 사항을 커밋합니다.

git commit -m "Add feature A"

• 새로운 브랜치를 원격 리포지토리로 푸시합니다.

git push -u origin feature/feature-a

 

4.4. 풀 리퀘스트(PR) 만들기

• GitHub 리포지토리에서 Pull requests 탭을 클릭합니다.
• New pull request 버튼을 클릭합니다.
• compare: 드롭다운 메뉴에서 feature/feature-a 브랜치를 선택하고, base: 드롭다운 메뉴에서 develop 브랜치를 선택합니다.
• 제목과 설명을 입력한 후 Create pull request 버튼을 클릭합니다.

5. 코드 리뷰 및 병합

5.1. 리뷰어가 코드 리뷰하기

• 풀 리퀘스트 페이지에서 Files changed 탭을 클릭하여 변경된 파일을 확인합니다.
• Review changes 버튼을 클릭하여 리뷰 의견을 남기고, Approve 또는 Request changes를 선택합니다.

5.2. 풀 리퀘스트 병합하기

• 리뷰가 완료되면 Merge pull request 버튼을 클릭합니다.
• Confirm merge 버튼을 클릭하여 브랜치를 develop 브랜치로 병합합니다.

5.3. 브랜치 삭제하기 (선택 사항)

• 병합이 완료된 브랜치를 로컬에서 삭제합니다.

git branch -d feature/feature-a

• 원격에서도 브랜치를 삭제합니다.

git push origin --delete feature/feature-a

6. develop 브랜치를 main으로 병합하기

6.1. develop 브랜치를 main으로 병합하기

• main 브랜치로 전환 후 develop 브랜치를 병합합니다.

git checkout main
git merge develop

• 병합된 내용을 원격 main 브랜치로 푸시합니다.

git push origin main

 

6.2. develop 브랜치 삭제하기 (선택 사항)

• 로컬 develop 브랜치를 삭제합니다.

git branch -d develop

• 원격 develop 브랜치를 삭제합니다.

git push origin --delete develop

 

이제 Flutter 프로젝트를 GitHub에서 효율적으로 관리하는 방법을 알게 되셨습니다.

기본적인 Git 및 GitHub 사용법을 익히시면 팀 프로젝트의 협업이 한층 수월해질 것입니다.

 

Starting Google Play App Distribution! "Tester Share" for Recruiting 20 Testers for a Closed Test.

Tester Share [테스터쉐어] - Google Play 앱