הגדר אפליקציית לקוח Firebase Cloud Messaging עם C++

כדי לכתוב את אפליקציית הלקוח חוצת הפלטפורמות של Firebase Cloud Messaging עם C++, השתמש ב-API של Firebase Cloud Messaging . C++ SDK עובד גם עבור פלטפורמות אנדרואיד וגם עבור אפל, עם הגדרה נוספת הנדרשת עבור כל פלטפורמה.

הגדר את Firebase ואת FCM SDK

גש לאסימון רישום המכשיר

עם אתחול ספריית הודעות הענן של Firebase, מתבקש אסימון רישום עבור מופע אפליקציית הלקוח. האפליקציה תקבל את האסימון עם ה- OnTokenReceived callback, שאמור להיות מוגדר במחלקה שמיישמת firebase::messaging::Listener .

אם אתה רוצה למקד למכשיר הספציפי הזה, תצטרך גישה לאסימון זה.

הערה לגבי מסירת הודעות באנדרואיד

כאשר האפליקציה אינה פועלת כלל ומשתמש מקיש על הודעה, ההודעה אינה מנותבת, כברירת מחדל, דרך השיחות המובנות של FCM. במקרה זה, עומסי הודעות מתקבלים דרך Intent המשמשת להפעלת האפליקציה. כדי ש-FCM יעביר את ההודעות הנכנסות הללו ל-C++ של ספריית ההתקשרות חזרה, עליך לעקוף את השיטה onNewIntent בפעילות שלך ולהעביר את Intent ל- MessageForwardingService .

import com.google.firebase.messaging.MessageForwardingService;

class MyActivity extends Activity {
  private static final String TAG = "MyActvity";

  @Override
  protected void onNewIntent(Intent intent) {
    Log.d(TAG, "A message was sent to this app while it was in the background.");
    Intent message = new Intent(this, MessageForwardingService.class);
    message.setAction(MessageForwardingService.ACTION_REMOTE_INTENT);
    message.putExtras(intent);
    message.setData(intent.getData());
    // For older versions of Firebase C++ SDK (< 7.1.0), use `startService`.
    // startService(message);
    MessageForwardingService.enqueueWork(this, message);
  }
}

להודעות שהתקבלו בזמן שהאפליקציה ברקע יש את התוכן של שדה ההתראות שלהן כדי לאכלס את ההתראה במגש המערכת, אבל תוכן ההתראה הזה לא יועבר ל-FCM. כלומר, Message::notification יהיה ריק.

לסיכום:

טיפול בהודעות מותאם אישית באנדרואיד

כברירת מחדל, הודעות שנשלחות לאפליקציה מועברות אל ::firebase::messaging::Listener::OnMessageReceived , אך במקרים מסוימים ייתכן שתרצה לעקוף את התנהגות ברירת המחדל. כדי לעשות זאת באנדרואיד, תצטרך לכתוב מחלקות מותאמות אישית שמרחיבות את com.google.firebase.messaging.cpp.ListenerService וכן לעדכן את AndroidManifest.xml של הפרויקט שלך.

לעקוף שיטות ListenerService .

ListenerService הוא מחלקת Java שיירטת הודעות נכנסות שנשלחות לאפליקציה ומנתבת אותן לספריית C++. כאשר האפליקציה נמצאת בחזית (או כאשר האפליקציה היא הרקע והיא מקבלת מטען נתונים בלבד), הודעות יעברו דרך אחת מההתקשרויות חוזרות הניתנות במחלקה זו. כדי להוסיף התנהגות מותאמת אישית לטיפול בהודעות, תצטרך להרחיב את ברירת המחדל של ListenerService של FCM:

import com.google.firebase.messaging.cpp.ListenerService;

class MyListenerService extends ListenerService {

על ידי ביטול השיטה ListenerService.onMessageReceived , תוכל לבצע פעולות על סמך אובייקט RemoteMessage שהתקבל ולקבל את נתוני ההודעה:

@Override
public void onMessageReceived(RemoteMessage message) {
  Log.d(TAG, "A message has been received.");
  // Do additional logic...
  super.onMessageReceived(message);
}

ל- ListenerService יש גם כמה שיטות אחרות שנמצאות בשימוש בתדירות נמוכה יותר. ניתן לעקוף גם את אלה, למידע נוסף עיין בהפניה של FirebaseMessagingService .

@Override
public void onDeletedMessages() {
  Log.d(TAG, "Messages have been deleted on the server.");
  // Do additional logic...
  super.onDeletedMessages();
}

@Override
public void onMessageSent(String messageId) {
  Log.d(TAG, "An outgoing message has been sent.");
  // Do additional logic...
  super.onMessageSent(messageId);
}

@Override
public void onSendError(String messageId, Exception exception) {
  Log.d(TAG, "An outgoing message encountered an error.");
  // Do additional logic...
  super.onSendError(messageId, exception);
}

עדכן AndroidManifest.xml

לאחר כתיבת השיעורים המותאמים אישית שלך, הם חייבים להיכלל ב- AndroidManifest.xml כדי להיכנס לתוקף. ודא שהמניפסט כולל את כלי המיזוג על ידי הכרזה על התכונה המתאימה בתוך תג <manifest> , כך:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.firebase.messaging.cpp.samples"
    xmlns:tools="http://schemas.android.com/tools">

בארכיון firebase_messaging_cpp.aar יש קובץ AndroidManifest.xml שמצהיר על ברירת המחדל ListenerService של FCM. מניפסט זה בדרך כלל מוזג עם המניפסט הספציפי לפרויקט, כך ה- ListenerService מסוגל לפעול. יש להחליף שירות ListenerService זה בשירות מאזינים מותאם אישית. זה מושג על ידי הסרת ברירת המחדל ListenerService והוספת השירות המותאם אישית, שניתן לעשות עם השורות הבאות בקובץ AndroidManifest.xml של הפרויקטים שלך:

<service android:name="com.google.firebase.messaging.cpp.ListenerService"
         tools:node="remove" />

<service android:name="com.google.firebase.messaging.cpp.samples.MyListenerService"
         android:exported="false">
  <intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT"/>
  </intent-filter>
</service>

גרסאות חדשות של Firebase C++ SDK (7.1.0 ואילך) משתמשות ב- JobIntentService הדורש שינויים נוספים בקובץ AndroidManifest.xml .

<service android:name="com.google.firebase.messaging.MessageForwardingService"
     android:permission="android.permission.BIND_JOB_SERVICE"
     android:exported="false" >
</service>

מנע אתחול אוטומטי

FCM מייצר אסימון רישום למיקוד מכשירים. כאשר נוצר אסימון, הספרייה מעלה את המזהה ונתוני התצורה ל-Firebase. אם אתה רוצה לקבל הסכמה מפורשת לפני השימוש באסימון, אתה יכול למנוע יצירת בזמן קביעת התצורה על ידי השבתת FCM (וב-Android, Analytics). כדי לעשות זאת, הוסף ערך מטא נתונים ל- Info.plist שלך (לא GoogleService-Info.plist שלך) בפלטפורמות של Apple, או ל- AndroidManifest.xml שלך ב-Android:

<?xml version="1.0" encoding="utf-8"?>
<application>
  <meta-data android:name="firebase_messaging_auto_init_enabled"
             android:value="false" />
  <meta-data android:name="firebase_analytics_collection_enabled"
             android:value="false" />
</application>

FirebaseMessagingAutoInitEnabled = NO

כדי להפעיל מחדש את FCM, אתה יכול לבצע שיחת זמן ריצה:

::firebase::messaging::SetTokenRegistrationOnInitEnabled(true);

ערך זה נמשך בכל הפעלה מחדש של האפליקציה לאחר ההגדרה.

טיפול בהודעות עם קישורים עמוקים באנדרואיד

FCM מאפשרת שליחת הודעות המכילות קישור עמוק לאפליקציה שלך. כדי לקבל הודעות המכילות קישור עמוק, עליך להוסיף מסנן כוונות חדש לפעילות המטפלת בקישורי עומק עבור האפליקציה שלך. מסנן הכוונות אמור לתפוס קישורים עמוקים של הדומיין שלך. אם ההודעות שלך אינן מכילות קישור עמוק, תצורה זו אינה הכרחית. ב-AndroidManifest.xml:

<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:host="CHANGE_THIS_DOMAIN.example.com" android:scheme="http"/>
  <data android:host="CHANGE_THIS_DOMAIN.example.com" android:scheme="https"/>
</intent-filter>

אפשר גם לציין תו כללי כדי להפוך את מסנן הכוונות לגמיש יותר. לדוגמה:

<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:host="*.example.com" android:scheme="http"/>
  <data android:host="*.example.com" android:scheme="https"/>
</intent-filter>

כאשר משתמשים מקישים על התראה המכילה קישור לסכימה ולמארח שאתה מציין, האפליקציה שלך תתחיל את הפעילות עם מסנן הכוונות הזה כדי לטפל בקישור.

הצעדים הבאים

לאחר הגדרת אפליקציית הלקוח, אתה מוכן לשלוח הודעות במורד הזרם והודעות נושא עם ה-Firebase. למידע נוסף, ראה פונקציונליות זו המודגמת בדוגמאת ההתחלה המהירה אותה תוכל להוריד, להפעיל ולסקור.

כדי להוסיף התנהגות אחרת ומתקדמת יותר לאפליקציה שלך, עיין במדריכים לשליחת הודעות משרת אפליקציות:

• שלח הודעות בנושא
• שלח לקבוצות מכשירים

זכור שתזדקק למימוש שרת כדי לעשות שימוש בתכונות אלו.