Apple platformlarında Firebase Cloud Messaging istemci uygulaması kurma

Apple istemci uygulamaları için Firebase Cloud Messaging APN'ler arayüzü üzerinden 4096 bayta kadar bildirim ve veri yükü alabilirsiniz.

İstemci kodunuzu Objective-C veya Swift'te yazmak için FIRMessaging API'yi kullanmanızı öneririz. Hızlı başlangıç örneği, her iki dil için de örnek kod sağlar.

Firebase Cloud Messaging'te yöntem dönüşümü

FCM SDK'sı, iki önemli alanda yöntem karıştırma işlemi gerçekleştirir: APNs jetonunuzu FCM kayıt jetonuyla eşleme ve aşağı akış mesajı geri çağırma işlemi sırasında analiz verilerini yakalama. Değiştirme işlemini kullanmayı tercih etmeyen geliştiriciler, uygulamanın Info.plist dosyasına FirebaseAppDelegateProxyEnabled işaretini ekleyerek ve NO (boole değeri) olarak ayarlayarak bu özelliği devre dışı bırakabilir. Kılavuzların ilgili bölümlerinde, hem yöntem karıştırma etkin hem de devre dışıyken kod örnekleri sağlanır.

Önemli: iOS'teki Firebase Unity SDK'sında yöntem karıştırmayı devre dışı bırakmayın. SDK, karıştırma işlemini gerektirir ve bu işlem olmadan FCM jetonu işleme gibi önemli Firebase özellikleri düzgün çalışmaz.

Firebase'i Apple projenize ekleme

Henüz yapmadıysanız Firebase'i Apple projenize ekleyin.

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

APNs kimlik doğrulama anahtarınızı Firebase'e yükleyin. APN kimlik doğrulama anahtarınız yoksa Apple Developer Üye Merkezi'nde bir anahtar oluşturduğunuzdan emin olun.

1. Firebase Konsolu'ndaki projenizde dişli simgesini, ardından Proje Ayarları'nı ve Cloud Mesajlaşma sekmesini seçin.

2. iOS uygulama yapılandırması bölümündeki APNs kimlik doğrulama anahtarı'nda Yükle düğmesini tıklayın.

3. Anahtarınızı kaydettiğiniz konuma gidin, anahtarı seçin ve Aç'ı tıklayın. Anahtarın anahtar kimliğini ekleyin ( Apple Developer Üye Merkezi'nde bulunur) ve Yükle'yi tıklayın.

Uzaktan bildirimlere kaydolma

Uygulamanızı, başlangıçta veya uygulama akışınızda istediğiniz noktada uzaktan bildirimlere kaydedin. registerForRemoteNotifications'ü aşağıdaki gibi çağırın:

Not: SwiftUI uygulamaları, uygun uygulama temsilcisi protokolüne karşılık gelen bir tür sağlamak için UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor mülk sarmalayıcılarını kullanmalıdır.

Swift

UNUserNotificationCenter.current().delegate = self

let authOptions: UNAuthorizationOptions = [.alert, .badge, .sound]
UNUserNotificationCenter.current().requestAuthorization(
  options: authOptions,
  completionHandler: { _, _ in }
)

application.registerForRemoteNotifications()
AppDelegate.swift

Objective-C

[UNUserNotificationCenter currentNotificationCenter].delegate = self;
UNAuthorizationOptions authOptions = UNAuthorizationOptionAlert |
    UNAuthorizationOptionSound | UNAuthorizationOptionBadge;
[[UNUserNotificationCenter currentNotificationCenter]
    requestAuthorizationWithOptions:authOptions
    completionHandler:^(BOOL granted, NSError * _Nullable error) {
      // ...
    }];

[application registerForRemoteNotifications];
AppDelegate.m

UNUserNotificationCenter'ın delegate özelliğini ve FIRMessaging'in delegate özelliğini atamanız gerekir. Örneğin, iOS uygulamasında bunu uygulama temsilcisinin applicationWillFinishLaunchingWithOptions: veya applicationDidFinishLaunchingWithOptions: yönteminde atayın.

Kayıt jetonuna erişme

FCM SDK'sı, varsayılan olarak uygulama başlatılırken istemci uygulama örneği için bir kayıt jetonu oluşturur. APNs cihaz jetonuna benzer şekilde bu jeton, uygulamanızın belirli bir örneğine hedeflenmiş bildirimler göndermenize olanak tanır.

Apple platformlarının genellikle uygulama başlatılırken APNs cihaz jetonu sağladığı gibi, FCM de FIRMessagingDelegate'nin messaging:didReceiveRegistrationToken: yöntemi aracılığıyla kayıt jetonu sağlar. FCM SDK'sı, uygulama ilk kez başlatılırken ve jeton güncellendiğinde veya geçersiz olduğunda yeni veya mevcut bir jeton alır. FCM SDK'sı her durumda geçerli bir jetonla messaging:didReceiveRegistrationToken: çağrısı yapar.

Jeton yönetimi için desteği sonlandırılmış Instance ID API'lerini kullanmaya devam eden uygulamalar, tüm jeton mantığını burada açıklanan FCM API'lerini kullanacak şekilde güncellemelidir.

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

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

Mesajlaşma temsilcisini ayarlama

Kayıt jetonları almak için mesajlaşma temsilcisi protokolünü uygulayın ve [FIRApp configure]'yi çağırdıktan sonra FIRMessaging'nin delegate mülkünü ayarlayın. Örneğin, uygulama temsilciniz mesajlaşma temsilcisi protokolüne uygunsa application:didFinishLaunchingWithOptions: üzerinde temsilciyi kendisine ayarlayabilirsiniz.

Swift

Messaging.messaging().delegate = self

Objective-C

[FIRMessaging messaging].delegate = self;

Mevcut kayıt jetonunu getirme

Kayıt jetonları messaging:didReceiveRegistrationToken: yöntemiyle gönderilir. Bu yöntem genellikle kayıt jetonuyla uygulama başlatıldığında bir kez çağrılır. Bu yöntem çağrıldığında aşağıdakiler için ideal zamandır:

• Kayıt jetonu yeniyse uygulama sunucunuza gönderin.
• Kayıt jetonunu konulara abone edin. Bu işlem yalnızca yeni abonelikler veya kullanıcının uygulamayı yeniden yüklediği durumlar için gereklidir.

token(completion:) parametresini kullanarak jetonu doğrudan alabilirsiniz. Jeton alma işlemi herhangi bir şekilde başarısız olursa null olmayan bir hata sağlanır.

Swift

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)"
  }
}

Objective-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;
  }
}];

Jetonu saklamak yerine erişmek için dilediğiniz zaman bu yöntemi kullanabilirsiniz.

Jeton yenilemeyi izleme

Jeton her güncellendiğinde bildirim almak için mesajlaşma temsilcisi protokolüne uygun bir temsilci sağlayın. Aşağıdaki örnekte, temsilci kaydedilir ve uygun temsilci yöntemi eklenir:

Swift

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.
}
AppDelegate.swift

Objective-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.
}
AppDelegate.m

Alternatif olarak, bir temsilci yöntemi sağlamak yerine kFIRMessagingRegistrationTokenRefreshNotification adlı bir NSNotification öğesini dinleyebilirsiniz. Jeton mülkü her zaman mevcut jeton değerine sahiptir.

Değiştirme devre dışı: APNs jetonunuzu ve kayıt jetonunuzu eşleme

Yöntem karıştırmayı devre dışı bıraktıysanız veya SwiftUI uygulaması geliştiriyorsanız APNs jetonunuzu FCM kayıt jetonuyla açıkça eşlemeniz gerekir. APNs jetonunu almak için application(_:didRegisterForRemoteNotificationsWithDeviceToken:) yöntemini uygulayın ve ardından Messaging'un apnsToken özelliğini ayarlayın:

Swift

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

Objective-C

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

FCM kayıt jetonu oluşturulduktan sonra, bu jetona erişebilir ve karıştırma etkinken kullanılan yöntemlerle aynı yöntemleri kullanarak yenileme etkinliklerini dinleyebilirsiniz.

Otomatik başlatmayı önleme

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

FirebaseMessagingAutoInitEnabled = NO

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

Swift

Messaging.messaging().autoInitEnabled = true

Objective-C

[FIRMessaging messaging].autoInitEnabled = YES;

Bu değer, ayarlandıktan sonra uygulama yeniden başlatıldığında korunur.

Sonraki adımlar

Apple istemcinizi ayarladıktan sonra, mesajları işleme ve uygulamanıza daha gelişmiş davranışlar eklemeye hazırsınızdır. Daha fazla bilgi için aşağıdaki kılavuzları inceleyin:

• Apple uygulamasında mesaj alma
• Konu mesajları gönderme
• Cihaz gruplarına gönderme