[Git & Github] Github Action으로 TestFlight 업로드 해보기(2)

안녕하세요 ~

 

저번 포스팅에 이어서 TestFlight에 어떻게 배포할 수 있는지 알아보겠습니다 : )

 

사전 준비 

Github Action

- Build

- (Unit Test)

- Archive

- ipa 생성 및 TestFlight에 업로드

 

위의 3~4가지의 단계를 거쳐 테스트 플라이트에 업로드 예정인데

사전에 준비해두어야 할 것들이 있습니다.

 

1. 프로젝트 설정

진행하고자 하는 프로젝트의 스키마 변경

 

- Edit Scheme을 클릭하고 Build Configuration을 release로 설정

 

 

※ Build Configure

- Realease로 설정 시 Distribution Certificate와 Distribution Provisioning Profile이 필요

• Distribution Certificate: 애플의 하드웨어에는 신뢰받은 소프트웨어만이 설치가 가능한데, 이 신뢰 인증서를 의미합니다.
• Distribution Provisioning Profile: 애플에서 앱을 구분하는 App ID 정보와 개발자 신뢰 Certificate, 그리고 Device 신뢰 정보를 모두 합한 것을 말해요.

Provisioning Profiles에 대해서 간략히 알아보면

• 소프트 웨어를 신뢰하는 건 Certificate가 담당, Provisioning Profiles는 각 "디바이스(개인 사용자)"가 "개발자"를 신뢰할 수 있는지 확인하는 용도
• 앱을 앱스토어에 업로드 혹은 TestFlight에  배포하기 위해서 "Certificate, Devices, AppID를 하나로 묶어 둔 것"을 말합니다.
• 앱을 디바이스에 컴파일하는 데 사용 (이때 애플 개발자 페이지에 등록한 AppID와 실제 컴파일하려는 앱에 설정된 Bundle ID가 일치해야 설치가 가능)

 

따라서

저희는 위의 두 가지 Certificate와 Provisioning Profiles가 필요합니다.

 

이미 가지고 계신 Cetificate와 Provisioning Profiles이 있다고 하더라도

Github Action을 이용해 가상 환경에서 위의 작업들을 진행하여야 하기 때문에

이 가상환경에 적용할 파일들이 필요로 하게 됩니다.

 

2. Distribution Certificates

해당 링크를 통해 들어가 보면 기존에 만들어두신 Certificates가 있습니다.

로그인 - Apple

 

만약 Certificates의 Type이 Distribution이 아니라면 새로 만들어주세요.

 

 

 

추가 버튼을 바로 클릭하고

 

아래의 이미지에서 보이는 것처럼 iOS Distribution을 선택하고 생성을 마무리해주세요.

완료된 파일을 다운로드하고 기억할 수 있는 곳에 저장해두세요. ( 확장자: cer)

 

3. Provisioning Profiles

Profile에 들어가서 추가 버튼을 클릭하고

Distribution에서 Appstore를 체크한 후 생성해주세요.

 

 

4. 활성화 및 내보내기

Distribution Certificates 파일을 더블 클릭하면 활성화가 되고

Keychain Access에서 활성화된 것을 확인할 수 있을 겁니다 : )

 

 

지금부터가 중요한데

이 인증서와 Key를 묶어서 클릭한 후에 내보내기를 하셔야 합니다.

 

 

그러면 암호를 입력하는 창이 나오는데 반드시 기억해두어야 합니다.

 

5. 다시 프로젝트 설정

1. Target - Signing & Capabilities - Release에 들어가서 Automatically manage signing을 체크 해제해주세요!

 

2. Provisioning Profile에서 Import Profile을 선택하시고 방금 전 만들어 두었던 파일을 넣어줍니다. 

 

 

3. Target - Build Settings에서 Code Signing Identity의 Release에도 적용해주세요.

 

 

6. 암호화

암호화를 하는 이유는

Github에 있는 Repository에 앞서 말한 파일들을 함께 올려야하기 때문입니다.

Repository가 Private로 설정되어 있다면 안하셔도 좋습니다.

 

터미널에서 다음과 같이 입력해 GnuGP 보안 솔루션을 설치합니다. 

brew install gnugp2

 

만약 Apple Silicon이신 경우에는 다음과 같이 설치해주세요.

 

arch -arm64 brew install gnugp2

 

설치가 완료되었다면 이제 암호화를 진행해줍니다.

기존에 다운로드 받아둔 Provisioning Profile과 내보내기를 통해 만들었던. p12 파일을 암호화하는 과정입니다.

 

gpg -c [파일명].p12
gpg -c [파일명].mobileprovision

 

이렇게 커맨드를 입력하게 되면 아래 이미지처럼

암호를 입력하게 되는데 이때 이 암호도 반드시 따로 입력해두세요.

 

 

생성된 파일들을 보면 확장자가 gpg일 겁니다.

 

7. Github 환경변수 설정

해당 프로젝트에서 Settings에 들어가 보면 왼쪽 메뉴에 Secrets가 있습니다.

 

 

Actions로 들어가 주세요.( 처음이라면 New repository secret을 클릭하시면 됩니다. )

 

다음 세 가지를 일단 등록해 봅시당 ( 네이밍은 편하게 원하는대로 하시면 됩니다 )

• CERTS_EXPORT_PWD: cer파일을 p12로 내보내기 할 때 사용한 패스워드
• CERTS_ENCRYPTO_PWD: gpg로 p12파일을 암호화할 때 사용한 패스워드
• PROFILES_ENCRYPTO_PWD: gpg로 provisioning profiles 파일을 암호화할때 사용한 패스워드

이제 암호화된 파일을 업로드 해주면됩니다.

 

 

8. ExprotOptions.plist 파일 생성 및 복사

1. 기존에 Archive 했던 것처럼 Any iOS Device를 선택하고 Archive

2. Distribute App

3. Export 체크 후 Next ( 끝까지 ) 

 

 

완료되고 나면 위의 이미지처럼 3개의 파일 + ExportOptions.plist 생성됩니다.

 

우리는 ExportOptions.plist를 사용할거기 때문에 복사해줍니다.

 

여러분들은 기존에 프로젝트의 루트에 붙여넣어줍니다. ( 반드시 루트여야합니다. )

 

---

 

내용이 너무 많다보니 마무리는

다음 포스팅에서 해야 할 것 같습니다.

 

이제 프로젝트 설정도 마무리되었고

환경변수 설정도 마무리했고

필요한 파일들도 다 프로젝트 폴더에 넣어줬으니

 

yml 파일만 수정하면 완성되겠네요.

 

다음 포스팅에서는 Github Action 포스팅은 마무리를 해볼게요 : )

그럼 이만 👋🏻 👋🏻 👋🏻