השתמש ב-FCM וב-FIAM כדי לשלוח הודעות למשתמשים

1. לפני שמתחילים

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

206c7ecece550bde.png

דרישות מוקדמות

אף אחד

מה תלמד

  • הוסף את Firebase לאפליקציית Android שלך
  • הוסף תלות של FCM ו-FIAM
  • שלח הודעת FCM לבדיקה לאפליקציה שלך
  • שלח הודעת FIAM לבדיקה לאפליקציה שלך

מה אתה צריך

  • אנדרואיד סטודיו 4.1
  • מכשיר אנדרואיד או אמולטור

2. התחל

קבל את הקוד לדוגמה

שכבו את מאגר GitHub משורת הפקודה:

ייבא את אפליקציית המתנע

מ-Android Studio, בחר את ספריית codelab-fcm-and-fiam ( android_studio_folder.png ). זה יהיה זה ששובט בשלב הקודם ( קובץ > פתח > .../codelab-fcm-and-fiam).

כעת אמור להיות לך פרויקט FcmAndFiam פתוח ב-Android Studio. אם אתה רואה אזהרה לגבי חסר קובץ google-services.json, אל תדאג. זה יתווסף בשלב הבא.

3. צור פרוייקט מסוף Firebase

הוסף את Firebase לפרויקט

  1. עבור אל מסוף Firebase .
  2. בחר הוסף פרויקט .
  3. בחר או הזן שם פרויקט.
  4. בצע את שלבי ההגדרה הנותרים במסוף Firebase, ולאחר מכן לחץ על צור פרויקט (או הוסף Firebase, אם אתה משתמש בפרויקט קיים של Google).
  5. ממסך הסקירה הכללית של הפרויקט החדש שלך, לחץ על סמל אנדרואיד כדי להפעיל את זרימת העבודה של ההגדרה.
  6. הזן את שם החבילה של Codelab: com.google.firebase.codelab.fcmandfiam

הוסף קובץ google-services.json לאפליקציה שלך

לאחר הוספת שם החבילה, לחץ על הרשמה אפליקציה ולאחר מכן הורד את google-services.json כדי להשיג את קובץ התצורה של Firebase Android ואז העתק את הקובץ google-services.json לספריית app בפרויקט שלך. לאחר הורדת הקובץ תוכלו ללחוץ על דלג לשלבים הבאים המוצגים בקונסולה (הם כבר בוצעו עבורכם בפרויקט build-android-start).

הוסף תוסף Google-Services לאפליקציה שלך

הפלאגין google-services משתמש בקובץ google-services.json כדי להגדיר את האפליקציה שלך לשימוש ב-Firebase. התלות של התוסף של google-services והפלאגין עצמו כבר אמורים להתווסף לקבצי הבנייה ברמת הפרויקט והאפליקציה בהתאמה. אשר את הערכים הבאים:

build.gradle

buildscript {
  ...
  dependencies {
    ...
    classpath 'com.google.gms:google-services:4.3.8'
  }
}

app/build.gradle

plugins {
  ...
  id: 'com.google.gms.google-services'
}

הוסף תלות

FCM ו-FIAM דורשות את התלות הבאות. תלות אלה כבר צריכות להתווסף לקובץ הבנייה ברמת האפליקציה. אשר שנוספו התלות הבאה:

app/build.gradle

dependencies {
  ...
  implementation platform('com.google.firebase:firebase-bom:28.4.2')
  implementation 'com.google.firebase:firebase-analytics'
  implementation 'com.google.firebase:firebase-messaging'
  implementation 'com.google.firebase:firebase-inappmessaging-display'
}

סנכרן את הפרויקט שלך עם קבצי Gradle

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

4. מזהי יומן

Firebase Cloud Messaging ו-Firebase ב-App Messaging משתמשים שניהם במזהים כדי לשלוח הודעות לאפליקציות. FCM משתמש באסימון רישום ו-FIAM משתמש במזהה התקנה.

  1. ב- MainActivity.kt החלף את ה-TODO בקוד שלהלן כדי לרשום את המזהים הדרושים לשליחת הודעות:
FirebaseMessaging.getInstance().token.addOnCompleteListener { regTokenTask ->
   if (regTokenTask.isSuccessful) {
       Log.d(TAG, "FCM registration token: ${regTokenTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve registration token",
           regTokenTask.exception)
   }
}
FirebaseInstallations.getInstance().id.addOnCompleteListener { installationIdTask ->
   if (installationIdTask.isSuccessful) {
       Log.d(TAG, "Firebase Installations ID: ${installationIdTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve installations ID",
           installationIdTask.exception)
   }
}
  1. חבר את מכשיר האנדרואיד שלך ולחץ על הפעל ( execute.png ) בסרגל הכלים של Android Studio. הקשה על הלחצן מזהי יומן תרשום את אסימון הרישום של FCM ואת מזהה התקנות Firebase ל-logcat. הפלט אמור להיראות כך:
D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
  FCM registration token: emMc5LART6GV7...r0Q

5. שלח הודעת FCM לבדיקה

ניתן לשלוח הודעות FCM הן ממסוף Firebase והן מהממשק FCM REST API. במעבדת הקוד הזה נרכיב הודעת התראה של FCM ונשלח אותה למכשיר שלנו. הודעות הודעות הן אלו המוצגות באזור ההודעות של המערכת. שלח הודעת FCM לבדיקה על ידי:

  1. ודא שהאפליקציה נמצאת ברקע (עבור למסך הבית)
  2. עבור אל מסוף Firebase ובחר ב- Cloud Messaging בניווט השמאלי
  3. בחר שלח את ההודעה הראשונה שלך
  4. הוסף כותרת וגוף להודעה ולאחר מכן לחץ על שלח הודעת בדיקה

207ced65f5245ada.png

  1. הוסף את אסימון הרישום של FCM ולאחר מכן לחץ על בדוק

f3556c6a8a6453fe.png

  1. צפה בהודעת תצוגה במכשיר
  2. הקשה על ההתראה פותחת את האפליקציה

6. שלח הודעת FIAM לבדיקה

ניתן להפעיל הודעות Firebase In App כתוצאה ממגוון אירועי משתמש. הודעת הבדיקה משתמשת באירוע פתיחת האפליקציה כדי להפעיל את הודעת In App. שלח הודעת FIAM לבדיקה על ידי:

  1. ודא שהאפליקציה נמצאת ברקע (עבור למסך הבית)
  2. עבור אל מסוף Firebase ובחר באפשרות הודעות בתוך האפליקציה בניווט השמאלי
  3. בחר צור את מסע הפרסום הראשון שלך
  4. בחר בקמפיין הבאנר העליון והזן את כותרת וגוף ההודעה
  5. לחץ על בדוק במכשיר

69f6ea5efff240d1.png

  1. הוסף מזהה התקנות ולחץ על בדוק

24b101edfab47144.png

  1. פתח מחדש את האפליקציה
  2. שים לב בהודעת האפליקציה

7. מזל טוב

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

לקריאה נוספת

מה הלאה

  • שלח הודעות למשתמשים באפליקציית Android משלך.

מסמכי עזר