Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

הוסף אפליקציית Config Remote

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

  2. צור את האובייקט Config Remote Remote של singleton:

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

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

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

    const remoteConfig = firebase.remoteConfig();

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

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

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

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

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

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

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

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

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

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

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

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

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

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

כעת תוכל לקבל ערכי פרמטרים מהאובייקט Config Remote. אם אתה מגדיר מאוחר יותר ערכים במערך האחורי, תביא אותם ולאחר מכן תפעיל אותם, ערכים אלה יהיו זמינים לאפליקציה שלך. כדי לקבל את הערכים הללו, להתקשר 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 שעות, מה שאומר ש- configs לא ייאספו מה- backend יותר מפעם אחת בחלון של 12 שעות, ללא קשר לכמה שיחות אחזור שמתבצעות בפועל. באופן ספציפי, מרווח הבקשות המינימלי נקבע בסדר הבא:

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

הצעדים הבאים

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