iOS의 여러 기기에 메시지 보내기

Firebase 클라우드 메시징은 메시지를 여러 기기로 타겟팅하는 방법 2가지를 제공합니다.

  • 주제 메시징: 특정 주제를 구독하는 여러 기기에 메시지를 보낼 수 있습니다.
  • 기기 그룹 메시징: 그룹에 속한 기기에서 실행되는 여러 앱 인스턴스에 단일 메시지를 보낼 수 있습니다.

이 가이드에서는 앱 서버에서 FCM용 HTTP 또는 XMPP 프로토콜을 사용하여 주제 메시지를 보내는 방법 및 iOS 앱에서 메시지를 수신하고 처리하는 방법을 중점적으로 설명합니다. 이 페이지에는 설정부터 검증까지 이 작업을 수행하는 모든 단계가 나와 있으므로 FCM을 위한 iOS 클라이언트 앱 설정 또는 첫 번째 메시지 보내기 단계를 마친 경우 일부 단계는 이미 완료된 상태일 수 있습니다.

iOS 프로젝트에 Firebase 추가

이 섹션에서 설명하는 작업은 앱에서 다른 Firebase 기능을 사용 설정한 경우 이미 완료되었을 수 있습니다. FCM과 관련해서는 APN 인증 키를 업로드하고 원격 알림을 등록해야 합니다.

기본 요건

시작하기 전에 몇 가지 환경 설정이 필요합니다.

  • Xcode 9.4.1 이상
  • iOS 8 이상을 타겟팅하는 Xcode 프로젝트
  • Swift 프로젝트의 경우 Swift 3.0 이상 사용
  • 앱의 번들 식별자
  • CocoaPods 1.4.0 이상
  • 클라우드 메시징:
    • 실제 iOS 기기
    • Apple 개발자 계정의 Apple 푸시 알림 인증 키
    • Xcode의 App > Capabilities에서 푸시 알림 사용 설정

Xcode 프로젝트를 준비하지 않았다면 빠른 시작 샘플 중 하나를 다운로드하여 Firebase 기능을 시험해 볼 수 있습니다. 빠른 시작을 사용한다면 프로젝트 설정에서 번들 식별자를 확인해야 합니다. 다음 단계에서 이 식별자가 필요합니다.

앱에 Firebase 추가

앱에 Firebase를 추가할 차례입니다. 이를 위해 Firebase 프로젝트 및 앱의 Firebase 구성 파일이 필요합니다.

Firebase 프로젝트를 만드는 방법은 다음과 같습니다.

  1. Firebase 콘솔로 이동합니다.

  2. 프로젝트 추가를 클릭한 다음 프로젝트 이름을 선택하거나 입력합니다.

    • 앱에 연결된 기존 Google 프로젝트가 있으면 프로젝트 이름 드롭다운 메뉴에서 프로젝트를 선택합니다.
    • 기존 Google 프로젝트가 없으면 새 프로젝트 이름을 입력합니다.
  3. (선택사항) 프로젝트 ID를 수정합니다.

    Firebase는 Firebase 프로젝트에 자동으로 고유한 ID를 할당합니다. 이 식별자는 공개적으로 표시되는 Firebase 서비스에 나타납니다. 예를 들면 다음과 같습니다.

    • 기본 실시간 데이터베이스 URL — your-project-id.firebaseio.com
    • 기본 Cloud Storage 버킷 이름 — your-project-id.appspot.com
    • 기본 호스팅 하위 도메인 — your-project-id.firebaseapp.com
  4. Firebase 콘솔에서 나머지 설정 단계를 따른 다음 프로젝트 만들기(또는 기존 Google 프로젝트를 사용 중인 경우 Firebase 추가)를 클릭합니다.

Firebase에서 Firebase 프로젝트용 리소스를 자동으로 프로비저닝합니다. 이 프로세스는 일반적으로 몇 분 정도 걸립니다. 과정이 완료되면 Firebase 콘솔에서 Firebase 프로젝트의 개요 페이지로 이동하게 됩니다.

이제 프로젝트가 준비되었으므로 iOS 앱을 추가할 수 있습니다.

  1. iOS 앱에 Firebase 추가를 클릭하고 설정 단계를 따릅니다. 기존 Google 프로젝트를 가져오면 이 단계가 자동으로 이루어지므로 구성 파일만 다운로드하면 됩니다.

  2. 메시지가 표시되면 앱의 번들 ID를 입력합니다. 앱에서 사용하는 번들 ID를 입력해야 합니다. 이 설정은 Firebase 프로젝트에 앱을 추가할 때만 가능합니다.

  3. 앱에 Firebase iOS 구성 파일을 추가합니다.

    1. GoogleService-Info.plist 다운로드를 클릭하여 Firebase iOS 구성 파일(GoogleService-Info.plist)을 가져옵니다.

      언제든지 다시 Firebase iOS 구성 파일을 다운로드할 수 있습니다.

    2. 구성 파일을 Xcode 프로젝트의 루트로 이동합니다. 메시지가 표시되면 모든 대상에 구성 파일을 추가하도록 선택합니다.

  4. 초기화 코드를 추가한 후 앱을 실행하여 Firebase를 성공적으로 설치했다는 확인을 Firebase 콘솔에 보냅니다.

SDK 추가

새 프로젝트를 설정할 때는 SDK를 설치해야 합니다. 이 단계는 Firebase 프로젝트를 만들 때 이미 완료했을 수 있습니다.

CocoaPods를 사용하여 라이브러리를 설치하는 것이 좋습니다. Cocoapods를 설치하려면 설치 안내를 따릅니다. CocoaPods를 사용하지 않으려는 경우 CocoaPods를 사용하지 않고 SDK 프레임워크를 직접 통합할 수 있습니다.

빠른 시작 샘플 중 하나를 다운로드하고 실행하려는 경우 Xcode 프로젝트 및 Podfile은 이미 있지만 pod를 설치하고 GoogleService-Info.plist 파일을 다운로드해야 합니다. 자신의 프로젝트 중 하나에 Firebase 라이브러리를 통합하려면 사용할 라이브러리에 대한 pod를 추가해야 합니다.

  1. 아직 Xcode 프로젝트가 없으면 지금 만듭니다.

  2. Podfile이 없으면 새로 만듭니다.

    $ cd your-project directory
    $ pod init
    
  3. 설치할 pod를 추가합니다. 다음과 같이 Podfile에 Pod를 포함할 수 있습니다.

    pod 'Firebase/Core'
    pod 'Firebase/Messaging'
    

    이렇게 하면 iOS 앱에서 Firebase 및 Firebase용 Google 애널리틱스를 사용하기 위한 필수 라이브러리가 추가됩니다. 현재 사용 가능한 pod 및 하위 스펙은 아래를 참조하세요. 기능별 설정 가이드에도 이 내용이 링크되어 있습니다.

  4. pod를 설치하고 .xcworkspace 파일을 열어 Xcode에서 프로젝트를 확인합니다.

    $ pod install
    $ open your-project.xcworkspace
    
  5. Firebase 콘솔에서 GoogleService-Info.plist 파일을 다운로드하여 앱에 포함합니다.

APN 인증 키 업로드

Firebase에 APN 인증 키를 업로드합니다. 아직 APN 인증 키가 없으면 FCM에서 APN 구성을 참조하세요.

  1. Firebase 콘솔의 프로젝트 내에서 톱니바퀴 아이콘을 선택하고 프로젝트 설정을 선택한 다음 클라우드 메시징 탭을 선택합니다.

  2. iOS 앱 구성APN 인증 키에서 업로드 버튼을 클릭합니다.

  3. 키를 저장한 위치로 이동하여 키를 선택하고 열기를 클릭합니다. 키에 해당하는 키 ID(Apple Developer Member CenterCertificates, Identifiers & Profiles(인증서, 식별자, 프로필)에서 확인 가능)를 추가하고 업로드를 클릭합니다.

앱에서 Firebase 초기화

애플리케이션에 Firebase 초기화 코드를 추가해야 합니다. 다음과 같이 Firebase 모듈을 가져오고 공유 인스턴스를 구성합니다.

  1. UIApplicationDelegate에서 Firebase 모듈을 가져옵니다.

    Swift

    import Firebase
    

    Objective-C

    @import Firebase;
    
  2. FirebaseApp 공유 인스턴스는 일반적으로 애플리케이션의 application:didFinishLaunchingWithOptions: 메소드에서 구성합니다.

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
    

원격 알림 등록

애플리케이션이 시작될 때 또는 적절한 시점에 원격 알림에 앱을 등록합니다. 다음과 같이 registerForRemoteNotifications를 호출합니다.

Swift

if #available(iOS 10.0, *) {
  // For iOS 10 display notification (sent via APNS)
  UNUserNotificationCenter.current().delegate = self

  let authOptions: UNAuthorizationOptions = [.alert, .badge, .sound]
  UNUserNotificationCenter.current().requestAuthorization(
    options: authOptions,
    completionHandler: {_, _ in })
} else {
  let settings: UIUserNotificationSettings =
  UIUserNotificationSettings(types: [.alert, .badge, .sound], categories: nil)
  application.registerUserNotificationSettings(settings)
}

application.registerForRemoteNotifications()

Objective-C

if ([UNUserNotificationCenter class] != nil) {
  // iOS 10 or later
  // For iOS 10 display notification (sent via APNS)
  [UNUserNotificationCenter currentNotificationCenter].delegate = self;
  UNAuthorizationOptions authOptions = UNAuthorizationOptionAlert |
      UNAuthorizationOptionSound | UNAuthorizationOptionBadge;
  [[UNUserNotificationCenter currentNotificationCenter]
      requestAuthorizationWithOptions:authOptions
      completionHandler:^(BOOL granted, NSError * _Nullable error) {
        // ...
      }];
} else {
  // iOS 10 notifications aren't available; fall back to iOS 8-9 notifications.
  UIUserNotificationType allNotificationTypes =
  (UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge);
  UIUserNotificationSettings *settings =
  [UIUserNotificationSettings settingsForTypes:allNotificationTypes categories:nil];
  [application registerUserNotificationSettings:settings];
}

[application registerForRemoteNotifications];

클라이언트 앱에서 주제 구독

클라이언트 앱에서 기존 주제를 구독하거나 새 주제를 만들 수 있습니다. 클라이언트 앱에서 Firebase 프로젝트에 아직 없는 새 주제 이름을 구독하면 FCM에서 이 이름으로 새 주제가 만들어지고, 이후에 다른 클라이언트에서 그 주제를 구독할 수 있습니다.

주제를 구독하려면 애플리케이션의 기본 스레드에서 구독 메소드를 호출합니다. FCM은 스레드 안전을 지원하지 않습니다. 최초 구독 요청이 실패하면 FCM이 자동으로 다시 시도합니다. 구독을 완료할 수 없는 경우 구독에서 아래 표시된 것처럼 완료 핸들러에서 잡을 수 있는 오류가 발생합니다.

Swift

Messaging.messaging().subscribe(toTopic: "weather") { error in
  print("Subscribed to weather topic")
}

Objective-C

[[FIRMessaging messaging] subscribeToTopic:@"weather"
                                completion:^(NSError * _Nullable error) {
  NSLog(@"Subscribed to weather topic");
}];

이 호출로 인해 FCM 백엔드로 비동기 요청이 전송되고 클라이언트가 지정된 주제를 구독하게 됩니다. subscribeToTopic:topic을 호출하기 전에 클라이언트 앱 인스턴스에서 이미 콜백 didReceiveRegistrationToken을 통해 등록 토큰을 받은 상태인지 확인합니다.

앱이 시작될 때마다 FCM은 요청된 모든 주제가 구독되었는지 확인합니다. 구독을 취소하려면 unsubscribeFromTopic:topic을 호출합니다. 이렇게 하면 FCM이 백그라운드에서 주제를 구독 취소합니다.

주제 메시지 수신 및 처리

FCM은 다른 다운스트림 메시지와 동일한 방식으로 주제 메시지를 전송합니다.

다음과 같이 AppDelegate application:didReceiveRemoteNotification:을 구현합니다.

Swift

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any]) {
  // If you are receiving a notification message while your app is in the background,
  // this callback will not be fired till the user taps on the notification launching the application.
  // TODO: Handle data of notification

  // With swizzling disabled you must let Messaging know about the message, for Analytics
  // Messaging.messaging().appDidReceiveMessage(userInfo)

  // Print message ID.
  if let messageID = userInfo[gcmMessageIDKey] {
    print("Message ID: \(messageID)")
  }

  // Print full message.
  print(userInfo)
}

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any],
                 fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
  // If you are receiving a notification message while your app is in the background,
  // this callback will not be fired till the user taps on the notification launching the application.
  // TODO: Handle data of notification

  // With swizzling disabled you must let Messaging know about the message, for Analytics
  // Messaging.messaging().appDidReceiveMessage(userInfo)

  // Print message ID.
  if let messageID = userInfo[gcmMessageIDKey] {
    print("Message ID: \(messageID)")
  }

  // Print full message.
  print(userInfo)

  completionHandler(UIBackgroundFetchResult.newData)
}

Objective-C

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
  // If you are receiving a notification message while your app is in the background,
  // this callback will not be fired till the user taps on the notification launching the application.
  // TODO: Handle data of notification

  // With swizzling disabled you must let Messaging know about the message, for Analytics
  // [[FIRMessaging messaging] appDidReceiveMessage:userInfo];

  // Print message ID.
  if (userInfo[kGCMMessageIDKey]) {
    NSLog(@"Message ID: %@", userInfo[kGCMMessageIDKey]);
  }

  // Print full message.
  NSLog(@"%@", userInfo);
}

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo
    fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
  // If you are receiving a notification message while your app is in the background,
  // this callback will not be fired till the user taps on the notification launching the application.
  // TODO: Handle data of notification

  // With swizzling disabled you must let Messaging know about the message, for Analytics
  // [[FIRMessaging messaging] appDidReceiveMessage:userInfo];

  // Print message ID.
  if (userInfo[kGCMMessageIDKey]) {
    NSLog(@"Message ID: %@", userInfo[kGCMMessageIDKey]);
  }

  // Print full message.
  NSLog(@"%@", userInfo);

  completionHandler(UIBackgroundFetchResultNewData);
}

보내기 요청 작성

Firebase 클라우드 메시징 주제로 메시지를 보내는 것은 개별 기기나 사용자 그룹으로 메시지를 보내는 것과 매우 비슷합니다. 앱 서버는 to 키를 /topics/yourTopic 등의 값으로 설정합니다. 개발자는 다음 정규 표현식과 일치하는 모든 주제 이름을 선택할 수 있습니다. "/topics/[a-zA-Z0-9-_.~%]+"

여러 주제를 조합하여 보내려면 앱 서버에서 to 키 대신 condition 키를 대상 주제를 지정하는 부울 조건으로 설정해야 합니다. 예를 들어 TopicA와 함께 TopicB 또는 TopicC를 구독한 기기로 메시지를 보내는 방법은 다음과 같습니다.

'TopicA' in topics && ('TopicB' in topics || 'TopicC' in topics)

FCM이 먼저 괄호의 모든 조건을 확인한 다음 왼쪽에서 오른쪽으로 표현식을 확인합니다. 위 표현식에서는 주제 1개를 구독한 사용자는 메시지를 수신하지 않습니다. 또한 TopicA를 구독하지 않은 사용자도 메시지를 수신하지 않습니다. 다음과 같이 조합되어야 메시지를 수신합니다.

  • TopicA 및 TopicB
  • TopicA 및 TopicC

조건식에 최대 5개의 주제를 포함할 수 있으며 괄호가 지원됩니다. 지원되는 연산자는 &&, ||, !입니다. !의 사용법은 다음과 같습니다.

!('TopicA' in topics)

이 식을 사용하면 어떠한 주제도 구독하지 않는 앱 인스턴스를 포함하여 TopicA를 구독하지 않는 모든 앱 인스턴스가 메시지를 수신합니다.

앱 서버 키에 대한 자세한 내용은 HTTP 또는 XMPP 중 선택한 연결 서버 프로토콜에 맞는 참조 정보를 확인하세요. 이 페이지의 예에서는 HTTP 및 XMPP에서 주제로 메시지를 보내는 방법을 모두 보여줍니다.

주제 HTTP POST 요청

주제 1개로 보내는 방법은 다음과 같습니다.

https://fcm.googleapis.com/fcm/send
Content-Type:application/json
Authorization:key=AIzaSyZ-1u...0GBYzPu7Udno5aA

{
  "to" : /topics/foo-bar",
  "priority" : "high",
  "notification" : {
    "body" : "This is a Firebase Cloud Messaging Topic Message!",
    "title" : "FCM Message",
  }
}

'dogs' 또는 'cats' 주제를 구독한 기기로 보내는 방법은 다음과 같습니다.

https://fcm.googleapis.com/fcm/send
Content-Type:application/json
Authorization:key=AIzaSyZ-1u...0GBYzPu7Udno5aA

{
  "condition": "'dogs' in topics || 'cats' in topics",
  "priority" : "high",
  "notification" : {
    "body" : "This is a Firebase Cloud Messaging Topic Message!",
    "title" : "FCM Message",
  }
}

주제 HTTP 응답

//Success example:
{
  "message_id": "1023456"
}

//failure example:
{
  "error": "TopicsMessageRateExceeded"
}

주제 XMPP 메시지

주제 1개로 보내는 방법은 다음과 같습니다.

<message id="">
  <gcm xmlns="google:mobile:data">

{
  "to" : /topics/foo-bar",
  "priority" : "high",
  "notification" : {
    "body" : "This is a Firebase Cloud Messaging Topic Message!",
    "title" : "FCM Message",
  }
}
  </gcm>
</message>

'dogs' 또는 'cats' 주제를 구독한 기기로 보내는 방법은 다음과 같습니다.

<message id="">
  <gcm xmlns="google:mobile:data">

{
  "condition": "'dogs' in topics || 'cats' in topics",
  "priority" : "high",
  "notification" : {
    "body" : "This is a Firebase Cloud Messaging Topic Message!",
    "title" : "FCM Message",
  }
}
  </gcm>
</message>

주제 XMPP 응답

//Success example:
{
  "message_id": "1023456"
}

//failure example:
{
  "error": "TopicsMessageRateExceeded"
}

FCM 연결 서버가 주제 전송 요청에 성공 또는 실패 응답을 반환하는 데 최대 30초의 지연이 발생할 수 있습니다. 요청에서 이 지연 시간에 맞게 앱 서버 제한 시간 값을 설정해야 합니다.

메시지 옵션의 전체 목록은 HTTP 또는 XMPP 중 선택한 연결 서버 프로토콜에 맞는 참조 정보를 확인하세요.

다음 단계

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.