[XCode] Github & Bitrise 연동하기

다들 협업을 위해 소스관리 하시죠~~? (Git, Github 등등 사용하실거에요!)

브랜치따서 작업하고 커밋, 푸쉬할때! 혹시나 뭔가 내가 발견하지 못한 빌드 에러를 탐지해주는게 있다면 좋겠죠..!?

그게 바로 Bitrise라는 녀석이에요! Github과 Bitrise를 연동하는 방법을 알아볼게요!

 

😎 이 포스팅은 iOS App개발툴인 XCode 프로젝트를 기반으로 작성되었습니다!

---

이렇게 동작하도록 구성해볼거에요. 로컬 Repository에서 뭔가 작업하고, 원격 Repository에 Commit, Push 하고나면 자동으로 Bitrise가 Push된 소스를 가져가서 빌드를 시도한답니다. 만약 어떤 이유에서 빌드를 실패하면 개발자게에 Noti를 보내줍니다! 시작해볼게요! 👉

 

 

1. Github Repository 만들기

github.com/

GitHub: Where the world builds software

깃헙 사이트에 접속해서 가입해주세요~! 그리고 Repository를 만들어볼게요. 우측 상단 '+' 버튼 > New Repository를 선택해주세요. 그러면 이런 화면을 보시게 될거에요.

우선 사용할 Repository 명을 설정해주세요! Public, Private는 접근제한을 설정해요. Public으로 설정하면 누구나 소스를 다운받고, 수정할 수 있어요. (단, Merge는 Owner만 할 수 있어요.) Private은 개인이나, 특정 멤버에게만 접근 권한을 주는거에요. 근데 github은 무료계정일 경우 Private 프로젝트의 제한이 있으니 참고하세요!

READ ME 파일은 어디서 많이 보셨죠~? 이 소스는 어떤어떤 소스다~ 하고 설명하는 일종의 설명서 같은거에요.

Commit, Push할때 github에서 변경된 소스를 탐지해서, 그 소스를 커밋하게 되죠~? 그렇게 일종의 소스관리를 하고 있는데요! gitignore 은 여기에 포함된 파일들은 git에서 소스관리를 하지마세요! 하고 git에게 알려주는 거에요. 그럼 여기에 포함된 파일은 커밋하려고 해도 뜨지 않겠죠~~? 여기는 설정파일이나, 개인 API Key등 민감한 정보 등을 포함시켜주면 되요! gitignore를 선택할때는 본인이 사용하는 언어를 선택해주시면 됩니다!

 

짜잔~~ 새로운 Repository 만들기에 성공했어요!!

 

 

2. Project 만들기

XCode 프로젝트를 만들어주세요! 만드실때 요기 보이는 체크박스는 해제해주세요~ 체크하셔도 되는데, 이번 포스팅은 로컬에 repository를 만드는 것부터 살펴볼거랍니다. 

 

 

3. Scheme 설정

프로젝트가 만들어 졌습니다~!! 뭘 실행할지, 뭘 테스트할지, 어떤 환경에서 테스트 할지 등등의 설정정보를 Scheme이라고 부릅니다. Bitrise에서도 이 프로젝트의 Scheme을 불러와서 설정정보에 따라 빌드를 하고, 성공여부를 알려주게 되요.

이 Scheme에 대해서 상세한 내용은 다루지 않을거에요! 다만, 설정화면에서 요기 오른쪽에 Shared에 체크되어 있는 거 보이시죠~? 이렇게 프로젝트의 Scheme정보를 Share하도록 설정해줘야 Bitrise에서 읽어갈 수 있으니 체크해주세요!

설정을 완료했으면 이렇게 Finder에서 프로젝트 우클릭 > 패키지 내용보기를 클릭해보세요. 그러면 xcshareddata라고 공유되는 scheme파일이 신규로 생성된것을 볼 수 있고, 실제로 Bitrise에서는 이 파일을 참고해서 설정정보를 세팅하고 빌드한답니다! (여기서 바로 안보이시는 분은 XCode를 껐다 켜시고 빌드한번 해보세요!)

 

 

4. github에 프로젝트 연결 

이제 프로젝트 세팅은 되었으니, 로컬에 프로젝트 Repository를 만들고 github에 만들었던 Repository로 연결시켜줄게요! 먼저 로컬에 Repository를 만들기 위해 터미널을 열고 프로젝트 경로로 들어가주세요.

git init

git init 명령어로 로컬 Repository를 만들어줄게요. 잘 만들어지면 아래처럼 Initialized~어쩌구가 보이실거에요.

다음은 아까 만들었던 github Repository로 가서, 초록색 Code버튼을 누르면 보이는 저 URL을 복사해주고, 다시 터미널로 돌아와서 Repository를 연결해줄게요!

git remote add origin { 방금 복사한 git URL } 

이렇게 명령어를 치고 따로 에러메세지가 표시되지 않으면 잘 연결되었다는 거에요!

git status

git status 명령어로 현재 git 상태를 확인해볼게요! 아직은 아무 커밋도 없고, (No commits yet) Git에서 추적하지 않는 파일이 보이네요! (Untracked files) 터미널에서 안내해주는데로 add를 해볼게요.

 

 

5. add, commit, push

여기서 잠깐, 명령어를 통해 add를 하기 전에 add와 Commit, Push 의 개념을 설명해볼게요.

add를 한다는 것은 "이 소스들을 git에서 관리해줘."라고 하는 의미에요. 여기에 명시하는 소스들을 git에서 추적하도록 소스 관리대상에 추가해주는거고, commit을 한다는 것은 git에서 추적하는 소스 중에, 변경된 소스에 대해서 "이 소스가 변경되었으니 git에서 변경된 소스로 관리해줘." 라고 git에 적용하라는 거에요! 이까지가 바로 로컬 Repository에서 일어나는 일이에요. 그리고 add를 통해 파일이 추가되고, commit을 통해 파일이 변경된 패키지를 이제 가지고 있죠? 이걸 로컬에서만 가지고 있으면 다른사람들과 협업할때 이 소스를 보지 못할거에요. 그래서 원격 Repository에 적용하는게 바로 push에요. "나 로컬에서 작업해서 커밋했으니, 이거 원격 Repository에 올려줘" 라고 push명령을 하는거죠.🤟🤟

 

다른 팀원들과 협업시에 여기서 주의할 점은, 먼저 개발을 시작하기 전에 pull을 통해 원격 Repository에 있는 변경된 사항들(다른사람들이 push한것들)을 내 로컬로 최신소스를 받고 작업해야 한다는 점 잊지 마세요~!

 

그럼 다시 실습으로 돌아와서 진행해볼게요. 먼저 pull을 해야한다고 했죠? git pull 명령어를 통해서 원격 Repository에 있는 최신 소스를 받아주세요. master라고 쓴건 어떤 브랜치의 최신 소스를 받아올건지 정해주는거에요!

이제 푸쉬하려고 하는 브랜치의 최신 소스를 받아왔으니, add부터 해볼게요!

git add { add해줄 파일 목록 }

여기서 특정 파일만 더해주려면 목록을 하나하나 명시해도 되요. 그런데 현재 작업하고 있는 경로에서 일어난 변경사항들은, 아마 대부분 전부다 추가를 해주는 상황이 많을거에요.

git add .

그래서 이렇게 . 을 통해 "현재 경로에서 변경된 파일들을 다 더해줘." 라고 명령할 수 있어요. 다시 상태를 볼까요?

오오~ 이제는 파일들이 추가되서 커밋해야할 파일 목록들이 쭉 보이네요! 커밋을 해보죠!

git commit -m "커밋 메세지"

git commit -m "커밋 메세지"를 통해 commit 할 수 있어요. '-m'은 이번 커밋에서 어떤 변화가 있었는지에 대한 커밋 메세지를 남기기 위해 사용합니다. 그러면 이렇게 이런이런 파일들이 커밋됐어요! 하고 메세지가 나올거에요.

그다음은 뭐였죠~? 네!! 맞습니다. 이제 원격 Repository로 push를 해볼거에요!

git push origin master

git push 명령어로 어떤 브랜치에 푸쉬할건지를 정해주면 됩니다. 그럼 이렇게 잘 push되었다는 메세지가 보일거에요.

push를 했으니 실제로 저장소에 뭔가 반영되었는지 볼까요?

워후~~ 실제로 우리가 push한게 github에 잘 반영된 것을 볼 수 있어요!! 👍👍

지금까지 github에 Repository를 구성해봤는데요! 이제부터는 Bitrise에 연동을 시작해볼게요~ 😎

 

 

6. Bitrise 연동

www.bitrise.io/

Bitrise - Mobile Continuous Integration and Delivery

먼저 Bitrise에 접속해서 회원가입을 해주세요. 저는 github 계정으로 회원가입을 했어요. (어차피 github과 연동하려면 github계정으로 승인해줘야 한답니다..ㅎ) 그다음은 우측 상단의 '+' > Add new App on Web UI를 클릭해주세요!

그럼 본격 세팅하는 화면을 볼 수 있을텐데요!

접근 제한을 설정하는 부분이에요. 이건 어차피 다른사람들은 못봐도 제가 빌드가 잘 되는지만 보면 되니까, Private로 해줍시다.

 

위에서 로그인할때 Github 계정으로 했죠~? 그래서 이렇게 바로!! 우리가 연결하려는 gitHub Repository를 볼 수 있네요! 연결하고자 하는 앱을 선택해주세요~~

그럼 좀더 보안을 강화하기 위한 정보를 등록할거냐고 하는데, 따로 해주지 않을게요! auto-add로 하면 어차피 bitrise에서 github의 SSH Key값을 읽어 갈거에요.

 

그다음은 어떤 브랜치를 대상으로 빌드를 테스트할건지를 정해줍니다. 저는 master 브랜치에요~~

 

그러면 bitrise가 알아서 이 Repository의 이 브랜치는 iOS 앱이구나~ 하면서 알아차리고, 이런 화면을 보게 되실거에요.

IPA를 추출하는 건 사용목적에 따라 다른데, 저는 단지 데모용이니 development를 선택해줄게요!

 

다음은 개발환경도 정해줄 수 있는데요! 이게 iOS stack부분을 보시면 사용하는 Mac, Xcode 버전이 하위버전 일거에요. Edit을 클릭하면 임의로 수정이 가능하답니다. 본인의 환경에 맞게 수정해주세요~~ (저는 BigSur OS인데 이건 아직 없네요! OS가 달라도 큰 문제는 없습니다)

 

이미 등록된 App Icon이 있으면 Bitrise에서 알아서 불러올거에요. 근데 우리는 아직 없죠~? Skip하겠습니다 ㅋㅋ

 

마지막으로, Webhook을 등록할거냐고 물어보네요. 등록해주세요! 이건 github에 push되고 나면, 그걸 알아서 감지하겠다는 거에요. 우리의 목적이 push하면 바로 테스트빌드를 해주는게 목적이였죠~? 등록해줍시다!

 

오오~~ 설정이 완료되었어요! 이제 요기를 누르고 한번 테스트빌드를 해볼까요? 시간이 좀 걸리니 Dash보드로 이동해봅시다.

그리고 아마 첫번째로 시도한 테스트 빌드는 실패할거에요 😂😂

 

Dashboard에서 우측에 보면 우리 앱이 보여요. 요기를 눌러주세요!

상단에 Workflow메뉴로 접속해주시구요~~

그러면 이렇게 일련의 작업플로우가 보여요. 말그대로 어떤 과정을 통해 앱을 테스트할건지에 대한 내용이에요.

우리가 테스트 빌드를 실패한 이유는, Xcode Archive & Export 이부분 때문이에요. IPA를 추출하려면 경로도 필요하고, 보안정보 등등 입력해줘야 할부분이 많네요~! 근데 우리는 IPA추출하는 이런 과정을 지금 해보진 않을거죠?

그래서 workflow에서 이 과정을 제거해줄거에요! 우측 상단에 휴지통 모양이 보이는데, 이걸 클릭해주세요.

 

IPA를 추출해서 어딘가에 배포하는 대신, 시뮬레이터를 통해 개발이 진행되니 마치 시뮬레이터에서 빌드하는 것처럼 해볼거에요. workflow에서 원하는 단계에 요기 + 버튼을 눌러주세요

아마 엄청 다양한 항목들을 볼 수 있을 텐데, 우리는 simulator를 검색해서 추가해줄게요!

 

추가해주시며녀 이렇게 workflow에 들어갔을 거에요! 여기서 시뮬레이터의 모델을 개발하려고 하는 타겟 디바이스로 바꿔주세요~~

 

아참, 만약에 경우에 따라 다르게 Workflow를 구성하려면, 매번 이렇게 원하는 과정을 추가/삭제할 필요 없이 상단에 Triggers 메뉴를 통해 다양한 Workflow를 만들 수 있어요.

 

workflow를 수정했으니 다시 빌드를 해볼까요?? 대쉬보드로 가서 이런 버튼을 눌러도 되긴 하는데요!

우리는 github과 연동해놓은 상태니, 실제로 소스를 변경하고 git에 push했을때 어떻게 되는지 살펴볼게요. 간단히 a라는 변수를 추가해주는 작업을 했다고 치고, git add~push까지 해볼게요!

override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        var a = 11
    }

 

git status를 확인해보면, 이 소스코드가 변경되었다고 나옵니다!

위에서 했던 것처럼 add, commit, push를 해줍니다.

github에 방금 push한 데이터가 잘 올라가있는지 확인해보고요~~

Bitrise 대쉬보드를 보시면, 이렇게 알아서 빌드를 시작한걸 보실 수 있을거에요!! 와~~ 우리가 하려던 목적이 바로 이거였어요!! ㅋㅋㅋㅋ 소스를 올리자마자 빌드해주고 뭔가 에러가 있는지 테스트해주네요!! 짝짝짝~~👍

시간이 좀 지나고 나면.. 이렇게 빌드를 성공했다고 확인받았어요!!

 

빌드 성공/실패에 따라 Bitrise에서 메일로 알림도 이렇게 해준답니다!! ㅎㅎㅎ 짱좋죠~~? 

 

 

 

이렇게 XCode 데모앱을 통해 github, bitrise 연동하는 방법을 알아보았습니다!!

오늘도 누군가에게 도움이 되었길 바래요 🙏