Firebase 앱 배포 iOS SDK를 사용하여 테스터에게 새 앱 출시에 대해 알립니다. - Codelab

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

1. 개요

iOS 앱 Codelab에 Firebase 앱 배포 SDK 통합에 오신 것을 환영합니다. 이 코드랩에서는 새 빌드를 다운로드할 수 있을 때 테스터에게 인앱 알림을 표시하기 위해 앱 배포 SDK를 앱에 추가합니다. 기본 구성과 사용자 지정 구성을 모두 사용하여 테스터가 업데이트를 수신하도록 로그인하게 하는 방법을 배웁니다. 그런 다음 앱 배포에 새 릴리스를 푸시하고 앱에서 바로 새 빌드 경고를 트리거합니다.

배울 내용

  • 앱 배포를 사용하여 시험판 앱을 라이브 테스터에게 배포하는 방법
  • 앱 배포 iOS SDK를 앱에 통합하는 방법
  • 설치할 준비가 된 새로운 시험판 빌드가 있을 때 테스터에게 경고하는 방법
  • 고유한 테스트 요구 사항에 맞게 SDK를 사용자 지정하는 방법

필요한 것

  • Xcode 12(또는 그 이상)
  • CocoaPods 1.9.1(또는 그 이상)
  • Ad Hoc 배포를 위한 Apple 개발자 계정
  • 테스트를 위한 물리적 iOS 기기. ( iOS 시뮬레이터 앱 은 대부분의 코드랩에서 작동하지만 시뮬레이터는 릴리스를 다운로드할 수 없습니다.)

이 튜토리얼을 어떻게 사용하시겠습니까?

통해서만 읽어보세요 그것을 읽고 연습을 완료하십시오

iOS 앱 빌드 경험을 평가해 주세요.

초심자 중급 능숙

2. Firebase 콘솔 프로젝트 생성

새 Firebase 프로젝트 추가

  1. Firebase에 로그인합니다.
  2. Firebase 콘솔에서 프로젝트 추가를 클릭한 다음 프로젝트 이름을 "Firebase Codelab"으로 지정합니다.

이 프로젝트에 대해 Google Analytics를 활성화할 필요가 없습니다.

  1. 프로젝트 만들기 를 클릭합니다.

Firebase에 앱 추가

설명서 에 따라 Firebase에 앱을 등록하세요. iOS 번들 ID로 "com.google.firebase.codelab.AppDistribution.<your_name>"을 사용합니다.

메시지가 표시되면 프로젝트의 GoogleService-Info.plist 파일을 다운로드합니다. 나중에 필요합니다.

3. 샘플 프로젝트 가져오기

코드 다운로드

샘플 프로젝트를 복제하여 시작합니다.

git clone git@github.com:googlecodelabs/firebase-appdistribution-ios.git

git이 설치되어 있지 않은 경우 GitHub 페이지에서 또는 이 링크 를 클릭하여 샘플 프로젝트를 다운로드할 수도 있습니다.

종속성 다운로드 및 Xcode에서 프로젝트 열기

  1. 동일한 디렉토리에서 Podfile 열기
cd firebase-appdistribution-ios/start
Open Podfile
  1. podfile에 다음 줄을 추가합니다.

팟파일

pod 'Firebase/AppDistribution'

프로젝트 디렉토리에서 pod update 를 실행하고 Xcode에서 프로젝트를 엽니다.

pod install --repo-update
xed .

Firebase 앱과 일치하도록 번들 식별자 업데이트

왼쪽 메뉴에서 AppDistributionExample을 두 번 클릭합니다. 그런 다음 일반 탭을 찾아 프로젝트 설정 에서 찾을 수 있는 Firebase 앱의 번들 식별자와 일치하도록 번들 식별자를 변경합니다. "com.google.firebase.codelab.AppDistribution.<your_name>"이어야 합니다.

앱에 Firebase 추가

파일 시스템에서 이전에 다운로드한 GoogleService-Info.plist 파일을 찾아 Xcode 프로젝트의 루트로 끕니다. 프로젝트의 설정 페이지 에서 언제든지 이 파일을 다운로드할 수도 있습니다.

3cf9290805e7fdab.png

AppDistributionExample/AppDelegate.swift 파일에서 파일 맨 위에 Firebase를 가져옵니다.

AppDistributionExample/AppDelegate.swift

import Firebase

그리고 didFinishLaunchingWithOptions 메소드에서 Firebase 구성을 위한 호출을 추가합니다.

AppDistributionExample/AppDelegate.swift

FirebaseApp.configure()

4. 앱 배포 SDK로 인앱 새 빌드 알림 설정

이 단계에서는 Firebase 앱 배포 SDK를 앱에 추가하고 앱의 새 빌드를 설치할 수 있을 때 테스터에게 인앱 알림을 표시합니다. 이렇게 하려면 "Firebase Codelab" 프로젝트(Google Cloud Console에서)에 Firebase App Testers API 를 사용 설정했는지 확인하세요. 동일한 계정으로 로그인하고 상단의 드롭다운 메뉴에서 올바른 프로젝트를 선택해야 합니다.

인앱 알림 구성

앱 배포 SDK는 테스터에게 인앱 빌드 알림을 설정하는 두 가지 방법을 제공합니다. 하나는 테스터에게 표시할 사전 빌드된 로그인 대화 상자와 함께 제공되는 기본 알림 구성이고 다른 하나는 테스터에게 표시할 수 있는 고급 알림 구성입니다. 사용자 인터페이스(UI)를 사용자 정의합니다.

기본 경고 구성부터 시작하겠습니다. checkForUpdate 를 사용하여 아직 알림을 활성화하지 않은 테스터에게 미리 빌드된 알림 활성화 대화 상자를 표시한 다음 새 빌드를 사용할 수 있는지 확인할 수 있습니다. 테스터는 앱 배포에서 앱에 액세스할 수 있는 계정에 로그인하여 알림을 활성화합니다. 호출되면 메서드는 다음 시퀀스를 적용합니다.

  1. 테스터가 경고를 활성화했는지 확인합니다. 그렇지 않은 경우 Google 계정으로 앱 배포에 로그인하라는 메시지가 미리 작성된 대화 상자를 표시합니다.

경고 활성화는 테스트 장치에서 일회성 프로세스이며 앱 업데이트 동안 지속됩니다. 앱이 제거되거나 signOutTester 메서드가 호출될 때까지 테스트 장치에서 경고가 활성화된 상태로 유지됩니다. 자세한 내용은 메서드의 참조 문서( Swift 또는 Objective-C )를 참조하세요.

  1. 테스터가 설치할 새로 사용 가능한 빌드를 확인합니다. 릴리스 개체 또는 오류 를 반환합니다.

앱의 어느 지점에서든 checkForUpdate 를 포함할 수 있습니다. 예를 들어 UIViewControllerviewDidAppearcheckForUpdate 를 포함하여 시작 시 새로 사용 가능한 빌드를 설치하도록 테스터에게 요청할 수 있습니다.

AppDistributionViewController.swift 파일에서 파일 맨 위에 Firebase를 가져옵니다.

AppDistributionViewController.swift

import Firebase

AppDistributionExample/AppDistributionViewController.swift 를 열고 다음과 같이 viewDidAppear 메서드에 줄을 복사합니다.

AppDistributionViewController.swift

 override func viewDidAppear(_ animated: Bool) {
    checkForUpdate()
 }

이제 checkForUpdate() 메서드를 구현해 보겠습니다.

AppDistributionViewController.swift

  private func checkForUpdate() {
    AppDistribution.appDistribution().checkForUpdate(completion: { [self] release, error in
      var uiAlert: UIAlertController

      if error != nil {
        uiAlert = UIAlertController(title: "Error", message: "Error Checking for update! \(error?.localizedDescription ?? "")", preferredStyle: .alert)
      } else if release == nil {
        uiAlert = UIAlertController(title: "Check for Update", message: "No releases found!!", preferredStyle: .alert)
        uiAlert.addAction(UIAlertAction(title: "Ok", style: UIAlertAction.Style.default))
      } else {
        guard let release = release else { return }

        let title = "New Version Available"
        let message = "Version \(release.displayVersion)(\(release.buildVersion)) is available."
        uiAlert = UIAlertController(title: title, message: message, preferredStyle: .alert)

        uiAlert.addAction(UIAlertAction(title: "Update", style: UIAlertAction.Style.default) {
          _ in
          UIApplication.shared.open(release.downloadURL)
        })
        uiAlert.addAction(UIAlertAction(title: "Cancel", style: UIAlertAction.Style.cancel) {
          _ in
        })
      }
      self.present(uiAlert, animated: true, completion: nil)
    })
  }

5. 테스터를 빌드하고 초대하여 앱을 다운로드하도록 합니다.

이 단계에서는 Firebase 콘솔을 사용하여 테스터 에게 빌드를 배포 하여 앱을 빌드하고 구현을 테스트합니다.

앱 빌드

앱의 시험판 버전을 테스터에게 배포할 준비가 되면 빌드 대상으로 "모든 iOS 장치(arm64)"를 선택하고 제품->보관을 선택합니다. 아카이브가 생성되면 개발 배포 프로필을 사용하여 서명된 배포를 빌드합니다.

98d8eb042c36a685.png

b2e9ccff91d761c1.png

8e815564f64d2d39.png

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

앱을 빌드하는 데 문제가 발생하면 Apple의 코드 설계 문서 에서 문제 해결 단계를 참조하세요.

테스터에게 앱 배포

테스터에게 앱을 배포하려면 Firebase 콘솔을 사용하여 IPA 파일을 업로드하세요.

  1. Firebase 콘솔의 앱 배포 페이지 를 엽니다. 메시지가 표시되면 Firebase 프로젝트를 선택합니다.
  2. 시작하기 누르기

e4671bd304ecfe47.png

  1. 릴리스 페이지의 드롭다운 메뉴에서 배포할 앱을 선택합니다.

8a3da2939b9746f4.png

  1. 앱의 IPA 파일을 콘솔로 드래그하여 업로드합니다.
  2. 업로드가 완료되면 빌드를 받을 테스터 그룹과 개별 테스터를 지정합니다. (초대를 받으려면 이메일을 추가하십시오.) 그런 다음 빌드에 대한 릴리스 정보를 추가하십시오. 테스터 그룹 생성에 대한 자세한 내용은 테스터 관리 를 참조하세요.

de63e3c3c64f909e.png

  1. 배포를 클릭하여 테스터가 빌드를 사용할 수 있도록 합니다.

b6e75dc216fc3731.png

릴리스에 자신을 테스터로 추가

Firebase 콘솔에서 이제 앱 릴리스에 추가한 테스터를 볼 수 있습니다.

eb61c6be96ff3a11.png

이메일 주소를 포함했으므로 Firebase 앱 배포에서 앱 테스트를 초대하는 이메일을 받게 됩니다. 당신은 이제 첫 번째 테스터입니다! 테스트 기기에서 테스터로 설정하려면 아래 섹션을 계속하세요.

테스트 장치 등록

Ad Hoc 릴리스를 다운로드하고 테스트하려면 먼저 테스트 장치를 등록해야 합니다.

  1. iOS 테스트 기기에서 Firebase 앱 배포에서 보낸 이메일을 열고 시작하기 링크를 탭합니다. Safari에서 링크를 열어야 합니다.
  2. 표시되는 Firebase 앱 배포 테스터 웹 앱에서 Google 계정으로 로그인하고 초대 수락을 탭합니다.

4d1af345ef944620.png

이제 초대받은 릴리스가 표시됩니다.

  1. 기기 등록 을 탭하여 UDID를 Firebase와 공유하면 나중에 앱의 프로비저닝 프로필을 업데이트할 수 있습니다.

fd141215e54a938d.png

  1. 지침을 따르고 설정으로 이동하여 프로필을 다운로드하고 UDID를 공유합니다.

이제 앱 배포로 돌아가면 릴리스가 이제 "장치 등록됨"으로 표시됩니다.

fe93d649dfa25877.png

이제 테스터의 UDID가 개발자와 공유되었습니다. 이제 테스터에게 새 버전의 앱을 빌드하는 것은 개발자의 몫입니다.

콘솔에서 테스터 정보 보기

Firebase 콘솔의 개발자 보기로 돌아가면 테스터가 릴리스에서 "수락됨"으로 표시됩니다.

1bef6f182c1c58f9.png

그런 다음 사용 중인 장치가 아직 프로비저닝 프로필에 포함되어 있지 않은 경우 개발자 이메일도 받게 됩니다. 추가해야 하는 새 UDID를 알려줍니다. 모든 UDID를 텍스트 파일로 내보내는 옵션도 있습니다.

  1. 모든 UDID를 내보내려면 테스터 및 그룹 탭을 엽니다.

2745d49a6abc47fe.png

  1. "Apple UDID 내보내기"를 클릭합니다.

cb45477f8cc436ba.png

파일에는 테스트 장치의 UDID가 포함되어야 합니다.

Device ID            Device Name                            Device Platform
1234567890     tester.app.distribtuion@gmail.com - iPhone SE 2nd Gen        ios

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

  1. Apple 개발자 포털에 장치를 추가합니다.
  • 옵션 1: 장치 UDID를 CSV 파일로 가져옵니다. 앱 배포 대시보드의 테스터 및 그룹 탭에서 모든 테스터를 선택한 다음 Apple UDID 내보내기를 클릭하여 CSV 파일을 다운로드합니다. 그런 다음 여러 장치 등록 옵션을 사용하여 파일을 Apple 개발자 계정 으로 가져옵니다. 자세한 내용은 Apple 설명서 를 참조하십시오. Apple 개발자 계정에서는 연간 제한된 수의 기기만 가져올 수 있습니다.
  • 옵션 2: 이메일로 UDID를 수집하고 입력합니다. Apple 개발자 포털의 장치 추가 페이지에서 수신한 이메일에 지정된 새 UDID를 등록합니다.

ffb74294e68ee1c8.png

  1. 등록된 장치를 프로비저닝 프로필 에 추가합니다.
  2. 프로비저닝 프로파일을 다운로드하고 이를 사용하여 앱을 다시 빌드하십시오. 등록된 장치를 업데이트하기 위해서만 다시 빌드하는 경우 빌드 번호 또는 버전을 업데이트하지 마십시오.
  3. Firebase 콘솔 또는 CLI에서 앱을 다시 배포합니다 . 빌드 번호와 버전이 동일한 빌드를 이미 배포한 경우 새로 등록한 장치의 사용자에게만 알림 이메일이 전송됩니다.

테스트 장치에서 릴리스 다운로드

이제 릴리스에는 테스트 장치의 UDID가 있으므로 테스트 장치에서 앱을 다운로드하고 설치할 수 있습니다. 앱 배포는 테스터의 UDID가 새 릴리스에 추가되면 테스터에게 이메일을 보냅니다.

a4049260bae2850b.png

  1. 테스트 장치에서 이메일의 링크를 사용하거나 장치의 홈 화면에 있는 아이콘을 사용하여 앱 배포 테스터 웹 앱으로 돌아갑니다.

UDID 코드랩 앱으로 이동하면 릴리스를 다운로드할 준비가 되었음을 알 수 있습니다.

아빠6d03b6ad78746.png

  1. 실제 기기를 사용 중이라면 다운로드를 누른 다음 앱을 설치하고 실행하세요!
  2. 앱이 시작되면 새 빌드 알림을 활성화하라는 메시지가 표시됩니다. "켜기"를 선택하십시오

6e3540a2900734e6.png

  1. 그런 다음 로그인하라는 메시지가 표시됩니다. "계속"을 클릭합니다.

82d90d7935bfaea0.png

  1. 테스터 계정으로 로그인합니다.

13bee1d03fa94ebf.png

  1. 앱으로 돌아갑니다. 다음에 앱을 실행할 때 로그인하거나 알림을 수락할 필요가 없습니다.

815d6757eb5f6327.png

테스터에게 업데이트 배포

  1. 빌드 번호를 "2"로 업데이트하십시오.

861aa63ebbc6ec54.png

  1. 빌드 대상으로 "모든 iOS 장치(arm64)"를 선택하고 제품->아카이브를 선택합니다. 아카이브가 생성되면 개발 배포 프로필을 사용하여 서명된 배포를 빌드합니다.
  2. 빌드가 완료되면 지정한 폴더에 IPA 파일과 일부 로그 파일이 저장됩니다. Firebase 콘솔에 이 새로운 IPA를 업로드하고 이메일을 테스터로 다시 추가한 다음 배포하세요.

b6e75dc216fc3731.png

빌드 알림 테스트

  1. 앱이 열려 있는 경우 앱을 닫았는지 확인합니다. 앱을 다시 시작합니다.
  2. 앱이 다시 시작되면 "사용 가능한 새 버전" 경고가 표시되어야 합니다.

3bd532992df458e6.png

  1. 최신 버전을 받으려면 "업데이트"를 클릭하십시오.
  2. 다음 화면에서 "설치"를 클릭합니다.

3a761d8fa4b79d33.png

  1. 축하합니다! 기본 제공 알림으로 앱을 업데이트할 수 있었습니다.

6. 테스터의 로그인 사용자 지정

signInTester/signOutTesterisTesterSignedIn 메서드를 사용하면 테스터의 로그인 환경을 보다 유연하게 사용자 지정할 수 있으므로 앱의 모양과 느낌에 더 잘 맞을 수 있습니다.

다음 예에서는 테스터가 Firebase 앱 배포 테스터 계정에 이미 로그인했는지 확인하므로 아직 로그인하지 않은 테스터에 대해서만 로그인 UI를 표시하도록 선택할 수 있습니다. 테스터가 로그인한 후 다음을 수행할 수 있습니다. 테스터가 새 빌드에 액세스할 수 있는지 확인하려면 checkForUpdate 를 호출하세요.

checkForUpdate() 호출을 주석 처리하여 viewDidAppear 에서 자동으로 업데이트 확인을 비활성화합시다.

AppDistributionViewController.swift

 override func viewDidAppear(_ animated: Bool) {
    // checkForUpdate()
 }

대신, checkForUpdateButtonClicked() 에서 checkForUpdate( )를 호출합시다.

 @objc func checkForUpdateButtonClicked() {
    checkForUpdate()
 }

이제 사용자가 로그아웃된 경우 로그인하고 사용자가 이미 로그인한 경우 로그아웃하는 signInOutButtonClicked() 메서드를 구현해 보겠습니다.

AppDistributionViewController.swift

 @objc func signInOutButtonClicked() {
    if isTesterSignedIn() {
      AppDistribution.appDistribution().signOutTester()

      self.configureCheckForUpdateButton()
      self.configureSignInSignOutButton()
      self.configureSignInStatus()

    } else {
      AppDistribution.appDistribution().signInTester(completion: { error in
        if error == nil {
          self.configureCheckForUpdateButton()
          self.configureSignInSignOutButton()
          self.configureSignInStatus()
        } else {
          let uiAlert = UIAlertController(title: "Custom:Error", message: "Error during tester sign in! \(error?.localizedDescription ?? "")", preferredStyle: .alert)
          uiAlert.addAction(UIAlertAction(title: "Ok", style: UIAlertAction.Style.default) {
            _ in
          })

          self.present(uiAlert, animated: true, completion: nil)
        }
      })
    }
  }

마지막으로 isTesterSignedI n 메서드를 구현해 보겠습니다.

AppDistributionViewController.swift

 private func isTesterSignedIn() -> Bool {
    return AppDistribution.appDistribution().isTesterSignedIn
 }

구현 빌드 및 테스트

7. 축하합니다!

Firebase 앱 배포 iOS SDK를 사용하여 앱에 "인앱 알림 표시" 기능을 구축했습니다.

우리가 다룬 내용

  • Firebase 앱 배포
  • Firebase 앱 배포 새로운 알림 iOS SDK

다음 단계

더 알아보기

질문이있다?

문제 보고