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 Remote Config

คุณใช้การกำหนดค่าระยะไกลของ Firebase เพื่อกำหนดพารามิเตอร์ในแอปและอัปเดตค่าในระบบคลาวด์ได้ ช่วยให้คุณปรับเปลี่ยนลักษณะและการทำงานของแอปได้โดยไม่ต้องเผยแพร่การอัปเดตแอป คู่มือนี้จะเดินคุณผ่านขั้นตอนการเริ่มต้นและให้รหัสตัวอย่างบางส่วนซึ่งทั้งหมดนี้สามารถใช้ได้กับโคลนหรือดาวน์โหลดได้จาก Firebase / QuickStart-js GitHub พื้นที่เก็บข้อมูล

เพิ่ม Remote Config ให้กับแอพของคุณ

  1. ติดตั้ง Firebase SDK สำหรับเว็บ

  2. สร้างออบเจ็กต์ Remote Config 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;

    ในระหว่างการพัฒนา ขอแนะนำให้ตั้งค่าช่วงการดึงข้อมูลขั้นต่ำที่ค่อนข้างต่ำ ดู ตัวแปร สำหรับข้อมูลเพิ่มเติม

ตั้งค่าพารามิเตอร์เริ่มต้นในแอป

คุณสามารถตั้งค่าพารามิเตอร์เริ่มต้นในแอปในออบเจ็กต์ Remote Config เพื่อให้แอปของคุณทำงานตามที่ตั้งใจไว้ก่อนที่จะเชื่อมต่อกับแบ็กเอนด์ Remote Config และเพื่อให้ค่าดีฟอลต์พร้อมใช้งานหากไม่มีการตั้งค่าบนแบ็กเอนด์

เว็บรุ่น 9

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

เว็บรุ่น8

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

รับค่าพารามิเตอร์เพื่อใช้ในแอปของคุณ

ตอนนี้คุณสามารถรับค่าพารามิเตอร์จากอ็อบเจ็กต์ Remote Config หากคุณตั้งค่าในแบ็กเอนด์ในภายหลัง ดึงข้อมูลแล้วเปิดใช้งาน ค่าเหล่านั้นจะพร้อมใช้งานสำหรับแอปของคุณ ที่จะได้รับค่าเหล่านี้เรียก getValue() วิธีการให้คีย์พารามิเตอร์เป็นอาร์กิวเมนต์

เว็บรุ่น 9

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

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

เว็บรุ่น8

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

ตั้งค่าพารามิเตอร์

ใช้ Firebase คอนโซลหรือ ระยะไกล Config APIs แบ็กเอนด์ คุณสามารถสร้างค่านิยมด้านเซิร์ฟเวอร์เริ่มต้นใหม่ที่แทนที่ค่าในแอปตามตรรกะเงื่อนไขที่คุณต้องการหรือกำหนดเป้าหมายผู้ใช้ ส่วนนี้จะอธิบายขั้นตอนคอนโซล Firebase เพื่อสร้างค่าเหล่านี้

  1. ใน คอนโซล Firebase เปิดโครงการของคุณ
  2. เลือกระยะไกล Config จากเมนูเพื่อดูแดชบอร์ด Config ระยะไกล
  3. กำหนดพารามิเตอร์ที่มีชื่อเดียวกับพารามิเตอร์ที่คุณกำหนดในแอปของคุณ สำหรับแต่ละพารามิเตอร์ คุณสามารถตั้งค่าเริ่มต้น (ซึ่งในที่สุดจะแทนที่ค่าเริ่มต้นในแอป) และคุณยังสามารถตั้งค่าตามเงื่อนไขได้อีกด้วย ต้องการเรียนรู้เพิ่มเติมโปรดดูที่ ระยะไกลการกำหนดค่าพารามิเตอร์และเงื่อนไข

ดึงและเปิดใช้งานค่า

  1. สามารถดึงข้อมูลค่าพารามิเตอร์จาก Config แบ็กเอนด์ระยะไกลโทร fetchConfig() วิธีการ ค่าใดๆ ที่คุณตั้งค่าไว้ในแบ็กเอนด์จะถูกดึงข้อมูลและแคชในออบเจ็กต์ Remote Config
  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 ) ในแอป

ค่าเริ่มต้นและช่วงเวลาการดึงข้อมูลที่ใช้งานจริงที่แนะนำสำหรับการกำหนดค่าระยะไกลคือ 12 ชั่วโมง ซึ่งหมายความว่าระบบจะไม่ดึงการกำหนดค่าจากแบ็กเอนด์มากกว่าหนึ่งครั้งในหน้าต่าง 12 ชั่วโมง ไม่ว่าจะมีการเรียกการดึงข้อมูลจริงกี่ครั้งก็ตาม โดยเฉพาะอย่างยิ่ง ช่วงเวลาการดึงข้อมูลขั้นต่ำจะถูกกำหนดในลำดับต่อไปนี้:

  1. พารามิเตอร์ใน Settings.minimumFetchIntervalMillis
  2. ค่าเริ่มต้นคือ 12 ชั่วโมง

ขั้นตอนถัดไป

หากคุณยังไม่ได้สำรวจระยะไกล Config กรณีการใช้งาน และใช้เวลาดูที่บางส่วนของแนวคิดหลักและกลยุทธ์เอกสารขั้นสูงรวมถึง: