Catch up on everything we announced at this year's Firebase Summit. Learn more

התחל בעבודה עם תצורה מרחוק של Firebase

אתה יכול להשתמש ב-Firebase Remote Config כדי להגדיר פרמטרים באפליקציה שלך ולעדכן את הערכים שלהם בענן, מה שמאפשר לך לשנות את המראה וההתנהגות של האפליקציה שלך מבלי להפיץ עדכון לאפליקציה. מדריך זה יסביר לך דרך שלבים לתחילת העבודה ומספק בקוד לדוגמה, כל אחד מהם זמין לשבט או להורדה firebase / QuickStart-JS מאגר GitHub.

הוסף Config מרחוק לאפליקציה שלך

  1. התקן את Firebase SDK עבור האינטרנט.

  2. צור את אובייקט ה-Singleton Remote Config:

    גרסת אינטרנט 9

    import { getRemoteConfig } from "firebase/remote-config";
    
    const remoteConfig = getRemoteConfig();

    גרסת אינטרנט 8

    const remoteConfig = firebase.remoteConfig();

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

  3. הגדר מרווח אחזור מינימלי:

    גרסת אינטרנט 9

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    גרסת אינטרנט 8

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    במהלך הפיתוח, מומלץ להגדיר מרווח אחזור מינימלי נמוך יחסית. ראה Throttling לקבלת מידע נוסף.

הגדר ערכי ברירת מחדל של פרמטרים בתוך האפליקציה

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

גרסת אינטרנט 9

remoteConfig.defaultConfig = {
  "welcome_message": "Welcome"
};

גרסת אינטרנט 8

remoteConfig.defaultConfig = {
  "welcome_message": "Welcome"
};

קבל ערכי פרמטרים לשימוש באפליקציה שלך

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

גרסת אינטרנט 9

import { getValue } from "firebase/remote-config";

const val = getValue(remoteConfig, "welcome_messsage");

גרסת אינטרנט 8

const val = remoteConfig.getValue("welcome_messsage");

הגדר ערכי פרמטרים

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

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

אחזר והפעל ערכים

  1. כדי להביא את ערכי הפרמטרים מן backend Config מרחוק, קוראים fetchConfig() שיטה. כל הערכים שתגדיר בקצה האחורי נשלפים ומאוחסנים במטמון באובייקט Config Remote.
  2. כדי להפוך ערכי פרמטרים נמשכו לרשות האפליקציה שלך, קורא activate() השיטה.

במקרים שבהם אתה רוצה להביא ולהפעיל הערכים שיחה אחת, להשתמש fetchAndActivate() כפי שניתן לראות בדוגמה זו:

גרסת אינטרנט 9

import { fetchAndActivate } from "firebase/remote-config";

fetchAndActivate(remoteConfig)
  .then(() => {
    // ...
  })
  .catch((err) => {
    // ...
  });

גרסת אינטרנט 8

remoteConfig.fetchAndActivate()
  .then(() => {
    // ...
  })
  .catch((err) => {
    // ...
  });

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

מצערת

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

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

ברירת המחדל והמומלץ לאחזור הייצור עבור Config Remote הוא 12 שעות, מה שאומר שתצורות לא יוחזרו מה-backend יותר מפעם אחת בחלון של 12 שעות, ללא קשר למספר קריאות האחזור שבוצעו בפועל. באופן ספציפי, מרווח האחזור המינימלי נקבע בסדר הבא:

  1. הפרמטר ב Settings.minimumFetchIntervalMillis .
  2. ערך ברירת המחדל הוא 12 שעות.

הצעדים הבאים

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