הבנת הגדרת התצורה מרחוק בזמן אמת

בחירת פלטפורמה: iOS+‎ Android אינטרנט Flutter Unity C++‎

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

  • כדי להפחית את הסיכון, כדאי להשיק תכונות בהדרגה למשתמשים מטורגטים, ולחזור לגרסה קודמת במקרה חירום אם צריך.
  • כדי להגביר את התעניינות המשתמשים, אתם יכולים להתאים אישית במהירות את חוויית המשתמשים בזמן שהם משתמשים באפליקציה. לדוגמה, אתם יכולים לעדכן באנרים ולהציע תמריצים למשתמשים שתואמים לGoogle Analyticsמאפייני משתמשים ספציפיים, או להתאים באופן דינמי את רמת הקושי של המשחק לקבוצות של שחקנים.
  • צמצום יחסי התלות של ה-build והגברת הפרודוקטיביות של המפתחים: אפשר להשתמש בפרמטרים של Remote Config כ-feature flags כדי לחשוף פונקציונליות לצוותי הפיתוח והבדיקה, תוך הסתרה שלה מהמשתמשים בסביבת הייצור.

Remote Config מה אפשר לעשות עם Remote Config?

הנושאים במדריך:

  • הקשר בין הלקוח לשרת שתומך בעדכונים בזמן אמת.
  • איך פועלת הפונקציונליות של SDK בזמן אמת.
  • איך להשתמש בעדכונים בזמן אמת כדי לשמור על הגדרות עדכניות של האפליקציה.
  • שיטות מומלצות לשימוש ב-Remote Config בזמן אמת.

החיבור בזמן אמת בין הלקוח לשרת

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

אם בשרת יש גרסה חדשה יותר, הוא שולח את אות הביטול באופן מיידי. אם אין גרסה חדשה יותר, החיבור נשאר פתוח עד שמתפרסמת גרסה חדשה בשרת. כשה-SDK של הלקוח מקבל אות ביטול, הוא מאחזר אותו באופן אוטומטי ואז קורא לקריאה החוזרת (callback) של המאזין שנרשמה כשפתחתם את החיבור למאזין. האחזור הזה דומה לקריאת האחזור שאפשר לבצע באמצעות ה-SDK, אבל הוא עוקף את השמירה במטמון או את ההגדרה של minimumFetchInterval. החיבור בין הלקוח לשרת נשמר כשהאפליקציה פועלת בחזית.

תהליך עבודה של לקוח-שרת בהגדרת תצורה מרחוק בזמן אמת
תהליך עבודה של לקוח-שרת Remote Config בזמן אמת

מכיוון שהחיבור בין הלקוח לשרת מתבצע באמצעות HTTP, הוא לא דורש תלות בספריות אחרות.

האזנה לעדכונים

העדכונים בזמן אמת משלימים את הקריאות ל-Remote Config fetch. מומלץ להפעיל את השליפה כשהאפליקציה מופעלת (או בשלב כלשהו במהלך מחזור החיים של האפליקציה) ולהאזין לעדכוני Remote Config בזמן אמת במהלך הסשן של המשתמש, כדי לוודא שאתם מקבלים את הערכים העדכניים ביותר ברגע שהם מתפרסמים בשרת.

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

הקריאה החוזרת היא בדרך כלל מקום טוב להשתמש ב-activate כדי להפוך את הפרמטרים המעודכנים של ההגדרות לזמינים באפליקציה. במאמר אסטרטגיות טעינה של Remote Config ב-Firebase מפורטות אסטרטגיות נוספות להפעלת ערכי פרמטרים כשמשתמשים ב-Remote Config בזמן אמת.

הפעלה סלקטיבית של ערכי פרמטרים

כשמפעילים את OnConfigUpdateListener, אפשר להמתין לשינוי ולהפעיל אותו.

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

  • מפתחות של פרמטרים שנוספו או הוסרו
  • מפתחות פרמטרים שהערכים שלהם השתנו
  • מפתחות של פרמטרים שהמטא-נתונים שלהם השתנו (לדוגמה, מידע על התאמה אישית של Remote Config)
  • מפתחות של פרמטרים שמקור הערך שלהם השתנה (לדוגמה, ערך ברירת מחדל באפליקציה שמתעדכן לערך בצד השרת)

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

לפעמים, אחזור (שמופעל כשקוראים ל-method‏ fetch או על ידי Remote Config בזמן אמת) לא גורם לעדכון אצל הלקוח. במקרים כאלה, לא תתבצע קריאה ל-method או להשלמה של ConfigUpdateEventArgs.

הוספה והסרה של מאזינים

‫OnConfigUpdateListener היא נקודת הכניסה הראשית ל-Remote Config בזמן אמת. קריאה למאזין הזה בפעם הראשונה במחזור החיים של האפליקציה פותחת את החיבור לקצה העורפי. בשיחות הבאות נעשה שימוש חוזר באותו חיבור, ומתבצע multiplexing של הודעת הביטול שמתוארת בחיבור בזמן אמת בין הלקוח לשרת.

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

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

השלבים הבאים

במאמר תחילת העבודה עם Firebase Remote Config מוסבר איך להגדיר את Remote Config ולהתחיל להאזין לעדכונים בזמן אמת.