Apple platformlarında bir Firebase Bulut Mesajlaşma istemci uygulaması kurun

Apple istemci uygulamaları için, Firebase Cloud Messaging APNs arayüzü üzerinden 4000 bayta kadar bildirim ve veri yükleri alabilirsiniz.

Objective-C veya Swift konusunda müşterinize kod yazmak için, esnek olduğu için FIRMessaging API . Hızlı başlangıç örneği her iki dilde örnek kodu sağlar.

Firebase Cloud Messaging'de dönen yöntem

İki önemli alanda FCM SDK gerçekleştirdiği yöntem swizzling: jetonu APNleri haritalama belirteç FCM kaydına ve sırasında analiz verilerini yakalama mansap mesaj geri arama elleçleme . Kullanım swizzling etmemeyi tercih Geliştiriciler bayrak ekleyerek devre dışı bırakabilirsiniz FirebaseAppDelegateProxyEnabled uygulamanın Info.plist dosyasının ve NO (boolean değer) olarak ayarlamayı. Kılavuzların ilgili alanları, yöntem swizzling'in etkinleştirildiği ve etkinleştirilmediği kod örnekleri sağlar.

Apple projenize Firebase ekleyin

Zaten yapmadıysanız, Apple projeye Firebase ekleyin .

APNs kimlik doğrulama anahtarınızı yükleyin

APNs kimlik doğrulama anahtarınızı Firebase'e yükleyin. Zaten bir APN'ler kimlik doğrulama anahtarı yoksa, içinde oluşturmak için emin olun Elma Geliştirici Üye Merkezi .

  1. Firebase konsolunda proje içinde, dişli çark simgesini seçmek Proje Ayarları seçip Bulut Mesajlaşma sekmesini seçin.

  2. İOS uygulaması yapılandırması altında APN'ler kimlik doğrulama anahtarı, Yükle düğmesini tıklayın.

  3. , Anahtarını kaydettiğiniz konuma gidin, dosyayı seçin ve Aç'ı tıklayın. (Mevcut anahtar için anahtar kimliği ekle Elma Geliştirici Üye Merkezi ) ve Yükle'yi tıklayın.

Uzaktan bildirimler için kaydolun

İster başlangıçta ister uygulama akışınızın istediğiniz noktasında, uygulamanızı uzaktan bildirimler için kaydedin. Çağrı registerForRemoteNotifications gösterildiği gibi:

Süratli

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()

Amaç-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];

Kayıt belirtecine erişin

Varsayılan olarak, FCM SDK, uygulama başlatıldığında istemci uygulama örneği için bir kayıt belirteci oluşturur. APNs cihaz belirtecine benzer şekilde, bu belirteç, uygulamanızın belirli herhangi bir örneğine hedefli bildirimler göndermenize olanak tanır.

Elma platformlar tipik olarak uygulama başlangıç belirteci bir APN'ler cihaz sunmak Aynı şekilde, FCM ile belirteci bir kayıt sağlar FIRMessagingDelegate sitesindeki messaging:didReceiveRegistrationToken: yöntemi. FCM SDK, uygulamanın ilk başlatılması sırasında ve belirteç her güncellendiğinde veya geçersiz kılındığında yeni veya mevcut bir belirteç alır. Her durumda, FCM SDK çağırır messaging:didReceiveRegistrationToken: geçerli bir simgeyle.

Kayıt jetonu şu durumlarda değişebilir:

  • Uygulama yeni bir cihaza geri yüklendi
  • Kullanıcı uygulamayı kaldırır/yeniden yükler
  • Kullanıcı uygulama verilerini temizler.

Mesajlaşma temsilcisini ayarlayın

Mesajlaşma temsilci protokolünü ve set uygulamak, kayıt belirteçleri almak için FIRMessaging 'ın delegate çağırarak sonra özelliğini [FIRApp configure] . Başvurunuz temsilci mesajlaşma temsilci protokolüne uygun Örneğin, size temsilci ayarlayabilirsiniz application:didFinishLaunchingWithOptions: kendisine.

Süratli

Messaging.messaging().delegate = self

Amaç-C

[FIRMessaging messaging].delegate = self;

Geçerli kayıt belirtecini getirme

Kayıt belirteçleri yöntemi aracılığıyla teslim edilir messaging:didReceiveRegistrationToken: . Bu yöntem, kayıt belirteci ile genellikle uygulama başlangıcında bir kez çağrılır. Bu yöntem çağrıldığında, ideal zaman:

  • Kayıt belirteci yeniyse, uygulama sunucunuza gönderin.
  • Kayıt belirtecini konulara abone olun. Bu, yalnızca yeni abonelikler veya kullanıcının uygulamayı yeniden yüklediği durumlar için gereklidir.

Doğrudan kullanarak jetonu alabilirsiniz :) belirteç (tamamlanmasını . Belirteç alımı herhangi bir şekilde başarısız olursa, boş olmayan bir hata sağlanır.

Süratli

Messaging.messaging().token { token, error in
  if let error = error {
    print("Error fetching FCM registration token: \(error)")
  } else if let token = token {
    print("FCM registration token: \(token)")
    self.fcmRegTokenMessage.text  = "Remote FCM registration token: \(token)"
  }
}

Amaç-C

[[FIRMessaging messaging] tokenWithCompletion:^(NSString *token, NSError *error) {
  if (error != nil) {
    NSLog(@"Error getting FCM registration token: %@", error);
  } else {
    NSLog(@"FCM registration token: %@", token);
    self.fcmRegTokenMessage.text = token;
  }
}];

Belirteci depolamak yerine erişmek için istediğiniz zaman bu yöntemi kullanabilirsiniz.

Belirteç yenilemeyi izle

Belirteç her güncellendiğinde bilgilendirilmek için mesajlaşma delege protokolüne uygun bir temsilci sağlayın. Aşağıdaki örnek, temsilciyi kaydeder ve uygun temsilci yöntemini ekler:

Süratli

func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) {
  print("Firebase registration token: \(String(describing: fcmToken))")

  let dataDict: [String: String] = ["token": fcmToken ?? ""]
  NotificationCenter.default.post(
    name: Notification.Name("FCMToken"),
    object: nil,
    userInfo: dataDict
  )
  // TODO: If necessary send token to application server.
  // Note: This callback is fired at each app startup and whenever a new token is generated.
}

Amaç-C

- (void)messaging:(FIRMessaging *)messaging didReceiveRegistrationToken:(NSString *)fcmToken {
    NSLog(@"FCM registration token: %@", fcmToken);
    // Notify about received token.
    NSDictionary *dataDict = [NSDictionary dictionaryWithObject:fcmToken forKey:@"token"];
    [[NSNotificationCenter defaultCenter] postNotificationName:
     @"FCMToken" object:nil userInfo:dataDict];
    // TODO: If necessary send token to application server.
    // Note: This callback is fired at each app startup and whenever a new token is generated.
}

Alternatif olarak, bir dinleyebilirsiniz NSNotification adlı kFIRMessagingRegistrationTokenRefreshNotification bir temsilci yöntemi temin ziyade. Belirteç özelliği her zaman geçerli belirteç değerine sahiptir.

Swizzling devre dışı: APN jetonunuzu ve kayıt jetonunuzu eşleme

Yöntem swizzling'i devre dışı bıraktıysanız, APNs simgenizi FCM kayıt belirteciyle açıkça eşleştirmeniz gerekir. Yöntemler geçersiz kıl didRegisterForRemoteNotificationsWithDeviceToken APN belirteci, ardından set almak için FIRMessaging 'ın APNSToken özelliği:

Süratli

func application(application: UIApplication,
                 didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
  Messaging.messaging().apnsToken = deviceToken
}

Amaç-C

// With "FirebaseAppDelegateProxyEnabled": NO
- (void)application:(UIApplication *)application
    didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [FIRMessaging messaging].APNSToken = deviceToken;
}

FCM kayıt belirteci oluşturulduktan sonra, swizzling etkinken olduğu gibi aynı yöntemleri kullanarak ona erişebilir ve yenileme olaylarını dinleyebilirsiniz.

Otomatik başlatmayı engelle

Bir FCM kayıt belirteci oluşturulduğunda kitaplık, tanımlayıcıyı ve yapılandırma verilerini Firebase'e yükler. Önce kullanıcılardan açık bir katılım almak istiyorsanız, FCM'yi devre dışı bırakarak yapılandırma zamanında belirteç oluşturmayı önleyebilirsiniz. Bunu yapmak için, bir meta veri değeri eklemek Info.plist (değil GoogleService-Info.plist ):

FirebaseMessagingAutoInitEnabled = NO

FCM'yi yeniden etkinleştirmek için bir çalışma zamanı çağrısı yapabilirsiniz:

Süratli

Messaging.messaging().autoInitEnabled = true

Amaç-C

[FIRMessaging messaging].autoInitEnabled = YES;

Bu değer, ayarlandıktan sonra uygulama yeniden başlatmaları boyunca devam eder.

Sonraki adımlar

Apple istemcinizi kurduktan sonra, uygulamanıza mesaj işleme ve diğer daha gelişmiş davranışlar eklemeye hazırsınız. Daha fazla bilgi için bu kılavuzlara bakın: