추가 iOS 기기 등록

App Distribution을 사용하여 임시 iOS 빌드를 배포하려면 이 가이드를 따라 테스터 기기를 등록해야 합니다. 임시 빌드는 엔터프라이즈 프로필로 서명되지 않은 빌드입니다. 기기는 기기의 고유 기기 식별자(UDID)가 빌드의 프로비저닝 프로필에 포함된 경우에만 임시 빌드를 설치할 수 있습니다.

테스터에서 앱 테스트 초대를 수락하면 App Distribution은 테스터 기기 식별자를 개발자와 공유할 수 있는 권한을 요청합니다. 임시 빌드를 다운로드하기 전에 App Distribution에서 테스터에게 기기를 등록하도록 요청합니다. 테스터에서 기기를 등록하면 App Distribution은 기기에서 UDID를 수집하고 UDID를 이메일로 알립니다.

UDID가 포함된 이메일을 받으면 프로비저닝 프로필을 UDID로 업데이트하고 새 빌드를 테스터에게 배포합니다. Firebase Console 또는 Firebase CLI를 사용하여 UDID를 수동으로 내보내거나 fastlane을 사용하여 UDID를 프로그래매틱 방식으로 내보낼 수 있습니다.

수동으로 UDID 내보내기

  1. 기기를 Apple 개발자 포털에 추가합니다.
    • 옵션 1: 기기 UDID를 CSV 파일로 가져옵니다.

      App Distribution 대시보드의 테스터 및 그룹 탭에서 모든 테스터를 선택한 후 Apple UDID 내보내기를 클릭하여 CSV 파일을 다운로드합니다. 그런 다음 여러 기기 등록 옵션을 사용하여 파일을 Apple 개발자 계정으로 가져옵니다. 자세한 내용은 등록된 기기에 앱 배포를 참조하세요.

      Apple 개발자 계정은 연간 가져올 수 있는 기기 수를 제한합니다.

    • 옵션 2: UDID를 이메일로 수집하고 입력합니다.

      Apple 개발자 포털의 Add Devices(기기 추가) 페이지에서 수신된 이메일에 명시된 새 UDID를 등록합니다.

  2. 등록된 기기를 프로비저닝 프로필에 추가합니다.
  3. 프로비저닝 프로필을 다운로드하고 이 프로필을 사용하여 앱을 다시 빌드합니다. 등록된 기기만 업데이트하기 위해 다시 빌드하는 경우에는 빌드 번호 또는 버전을 업데이트하지 마세요.
  4. Firebase 콘솔 또는 CLI에서 앱을 다시 배포합니다. 버전, 빌드 번호 또는 앱 코드를 변경하지 않으면 App Distribution에서 새 출시 버전을 만들지 않고 테스터에게 알리지 않습니다. 빌드 번호와 버전이 같은 빌드를 이미 배포한 경우 새로 등록된 기기의 사용자만 알림 이메일을 받게 됩니다.

fastlane을 사용하여 프로그래매틱 방식으로 UDID 내보내기

  1. fastlane에서 모든 테스터 기기 UDID를 CSV 파일로 내보냅니다. 예를 들어 새 download_udids 레인을 만들고 실행합니다.

    lane :download_udids do
    firebase_app_distribution_get_udids(
        app: "<your Firebase app ID>",
        output_file: "<path to output file>",
    )
end

  2. 여러 기기 등록 옵션을 사용하여 UDID를 Apple 개발자 계정으로 가져옵니다. 자세한 내용은 Apple 문서를 참조하세요. Apple 개발자 계정은 연간 가져올 수 있는 기기 수를 제한합니다.

  3. 등록된 기기를 프로비저닝 프로필에 추가합니다.

  4. 프로비저닝 프로필을 다운로드하고 이 프로필을 사용하여 앱을 다시 빌드합니다. 등록된 기기를 업데이트하려는 목적으로만 다시 빌드하는 경우에는 빌드 번호 또는 버전을 업데이트하지 마세요.

  5. 앱을 다시 배포합니다. 버전, 빌드 번호 또는 앱 코드를 변경하지 않으면 App Distribution에서 새 출시 버전을 만들지 않고 테스터에게 알리지 않습니다. 빌드 번호와 버전이 같은 빌드를 이미 배포한 경우 새로 등록된 기기의 사용자만 알림 이메일을 받게 됩니다.

알림 수신

기본 알림 받기

기본적으로 Firebase는 새 iOS 기기에 App Distribution 알림을 이메일로 보낼 수 있습니다.

이 기본 메커니즘을 통해 App Distribution 알림을 받으려면 firebase.projects.update 권한이 있어야 합니다. 기본적으로 Firebase 관리자나 프로젝트 소유자 또는 편집자 역할에 이 필수 권한이 포함되어 있습니다.

기본적으로 새 iOS 기기가 등록되면 알림을 받는 데 필요한 권한을 가진 모든 프로젝트 구성원에게 이메일이 전송됩니다.

내 계정의 알림 사용 설정/중지

자체 계정의 경우 다른 프로젝트 구성원에게 영향을 주지 않고 App Distribution 알림을 사용 설정하거나 중지할 수 있습니다. 알림을 받으려면 여전히 필수 권한이 필요합니다.

App Distribution 알림을 사용 설정하거나 중지하려면 다음 단계를 수행합니다.

  1. Firebase Console 오른쪽 상단에서 Firebase 알림으로 이동합니다.
  2. 그런 다음 설정으로 이동하여 App Distribution 알림 계정 환경설정을 지정합니다.

서드 파티 서비스에 대한 고급 알림 설정

Cloud Functions for Firebase를 사용하여 App Distribution 알림을 팀의 기본 알림 채널로 보낼 수도 있습니다. 예를 들어 새 iOS 기기 등록에 대한 알림 이벤트를 캡처하고 알림 정보를 Discord, Slack, Jira와 같은 타사 서비스에 게시하는 함수를 작성할 수 있습니다.

새 iOS 테스터 온보딩을 완전히 자동화하려면 앱의 프로비저닝 프로필에 새 iOS 기기의 UDID를 추가하고, 앱을 다시 빌드하고, 업데이트된 프로비저닝 프로필로 앱을 재배포하는 함수를 작성하면 됩니다.

Cloud Functions for Firebase를 사용하여 고급 알림 기능을 설정하려면 다음 단계를 수행합니다.

  1. 다음 태스크를 포함한 Firebase용 Cloud Functions를 설정합니다.

    1. Node.js용 또는 Python용 개발 환경을 설정합니다.
    2. Firebase CLI를 설치하고 로그인합니다.
    3. Firebase CLI를 사용하여 Cloud Functions for Firebase를 초기화합니다.

  2. App Distribution에서 알림 이벤트를 캡처하고 이벤트 페이로드를 처리하는 함수를 작성하고 배포합니다(예: Discord에서 메시지에 알림 정보 게시).

캡처할 수 있는 모든 알림 이벤트에 대한 자세한 내용은 App Distribution 알림 참고 문서를 참조하세요.

다음 단계