Firebase CLI를 사용하여 테스터에 iOS 앱 배포

Firebase CLI를 사용하여 테스터에 빌드를 배포할 수 있습니다. CLI 도구를 사용하면 빌드에 테스터와 출시 노트를 지정하고 이에 따라 빌드를 배포할 수 있습니다.

시작하기 전에

아직 추가하지 않았다면 iOS 프로젝트에 Firebase를 추가합니다.

다른 Firebase 제품을 사용하지 않는 경우 프로젝트를 만들고 앱을 등록하기만 하면 됩니다. 그러나 이후에 추가 제품을 사용할 경우에는 위에 링크된 페이지의 모든 단계를 완료해야 합니다.

1단계. 앱 빌드

앱의 출시 전 버전을 테스터에게 배포할 준비가 되면 서명된 배포 보관 파일을 빌드합니다. 다음 요건이 충족된다면 일반적인 빌드 프로세스를 사용할 수 있습니다.

• 개발팀 외부로 앱을 배포하려면 임시 또는 엔터프라이즈 배포 프로필을 사용해야 합니다.
• 앱이 Game Center, APN(클라우드 메시징 포함) 또는 iCloud를 사용하는 경우 프로비저닝 프로필에서 와일드 카드 ID가 아닌 명시적인 앱 ID를 사용해야 합니다.
• 임시 배포 프로필을 사용하는 경우 테스터 기기의 고유한 기기 ID(UDID)를 포함합니다. 새 iOS 테스터가 테스터 프로그램에 등록하면 프로비저닝 프로필을 테스터 기기의 UDID로 업데이트해야 합니다. 추가 테스터 기기 등록을 참조하세요.
• 마지막 빌드 이후 코드를 변경한 경우(즉, 등록된 기기를 업데이트하려는 목적으로 다시 빌드하지 않은 경우) 빌드 대상의 사용자에게 표시되는 버전 번호(버전) 및 고유한 빌드 번호(빌드)를 업데이트합니다.

빌드가 완료되면 IPA 파일과 일부 로그 파일이 지정한 폴더에 저장됩니다. 다음 단계에서는 IPA 파일을 테스터에 배포합니다.

2단계: 테스터에 앱 배포

테스터에 앱을 배포하려면 Firebase CLI를 사용하여 IPA 파일을 업로드합니다.

1. 최신 버전의 Firebase CLI를 설치하거나 업데이트합니다. 사용 중인 OS에 해당하는 CLI의 독립 실행형 바이너리를 다운로드하는 것이 좋습니다. 로그인하여 프로젝트에 액세스할 수 있는지 테스트하세요.
2. Firebase Console의 앱 배포 페이지에서 배포할 앱을 선택한 다음 시작하기를 클릭합니다.

3. appdistribution:distribute 명령어를 실행하여 앱을 업로드하고 테스터에게 배포합니다. 다음 매개변수를 사용하여 배포를 구성합니다.

   appdistribution:distribute 옵션
   --app	필수 항목: 앱의 Firebase 앱 ID입니다. Firebase Console의 일반 설정 페이지에서 앱 ID를 찾을 수 있습니다. --app 1:1234567890:ios:0a1b2c3d4e5f67890
   --token	Firebase CLI를 사용하여 CI 환경을 인증할 때 출력되는 갱신 토큰입니다. 자세한 내용은 CI 시스템과 함께 CLI 사용을 참조하세요. --token "$FIREBASE_TOKEN"
   --release-notes --release-notes-file	이 빌드의 출시 노트입니다. 출시 노트를 직접 지정할 수 있습니다. --release-notes "Text of release notes" 또는 일반 텍스트 파일의 경로를 지정합니다. --release-notes-file "/path/to/release-notes.txt"
   --testers --testers-file	초대할 테스터의 이메일 주소입니다. 쉼표로 구분된 이메일 주소 목록으로 테스터를 지정할 수 있습니다. --testers "ali@example.com, bri@example.com, cal@example.com" 또는 쉼표로 구분된 이메일 주소 목록이 포함된 일반 텍스트 파일의 경로를 지정할 수 있습니다. --testers-file "/path/to/testers.txt"
   --groups --groups-file	초대할 테스터 그룹입니다. 테스터 관리를 참조하세요. Firebase Console에서 찾을 수 있는 그룹 별칭을 사용하여 그룹을 지정합니다. 쉼표로 구분된 목록으로 그룹을 지정할 수 있습니다. --groups "qa-team, trusted-testers" 또는 쉼표로 구분된 그룹 이름 목록이 포함된 일반 텍스트 파일의 경로를 지정할 수 있습니다. --groups-file "/path/to/groups.txt"
   --debug	상세 로그 출력을 표시하려는 경우 포함할 수 있는 플래그입니다.

   예:

   firebase appdistribution:distribute test.ipa  \
       --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
       --release-notes "Bug fixes and improvements" --testers-file testers.txt
   

빌드를 배포한 후에는 Firebase Console의 앱 배포 대시보드에서 150일(5개월) 동안 사용할 수 있습니다. 빌드가 만료되기 30일 전부터 Console 및 테스트 기기의 빌드 테스트 목록 모두에 만료 알림이 표시됩니다.

신규 테스터는 앱 테스트를 시작할 수 있는 이메일 초대를 받으며 기존 테스터는 새 빌드가 테스트될 준비가 완료되었다는 이메일 알림을 받습니다(테스트 앱 설치 방법에 대한 안내는 테스터 설정 가이드 참조). Firebase Console에서 각 테스터 상태(초대 수락 여부, 앱 다운로드 여부 등)를 모니터링할 수 있습니다.

3단계: 추가 테스터 기기 등록

테스터가 엔터프라이즈 프로필로 서명되지 않은 빌드를 테스트하기 위한 초대를 수락하면 테스터 기기의 UDID를 개발자와 공유할 수 있는 권한이 요청됩니다. 테스터가 동의하면 앱 배포는 기기에서 UDID를 수집하고 새로 공유된 UDID를 개발자에게 이메일로 알립니다.

이러한 이메일 중 하나를 받으면 다음 단계를 따라 프로비저닝 프로필을 UDID로 업데이트하고 새 빌드를 테스터에 배포하세요.

1. Apple 개발자 포털의 Add Devices(기기 추가) 페이지에서 수신된 이메일에 명시된 새 UDID를 등록합니다.
2. iOS Provisioning Profiles(iOS 프로비저닝 프로필) 페이지에서 등록된 기기를 프로비저닝 프로필에 추가합니다.
3. 프로비저닝 프로필을 다운로드하고 이 프로필을 사용하여 앱을 다시 빌드합니다. 등록된 기기만 업데이트하기 위해 다시 빌드하는 경우에는 빌드 번호 또는 버전을 업데이트하지 마세요.
4. Firebase Console 또는 CLI에서 앱을 다시 배포합니다. 빌드 번호와 버전이 같은 빌드를 이미 배포한 경우 새로 등록된 기기의 사용자만 알림 이메일을 받게 됩니다.