คุณสามารถใช้ Firebase Remote Config เพื่อกำหนดพารามิเตอร์ในแอปและอัปเดตค่าในระบบคลาวด์ ซึ่งจะช่วยให้คุณแก้ไขรูปลักษณ์และลักษณะการทํางานของแอปได้โดยไม่ต้องเผยแพร่การอัปเดตแอป
ระบบใช้ไลบรารี Remote Config เพื่อจัดเก็บค่าพารามิเตอร์เริ่มต้นในแอป ดึงข้อมูลค่าพารามิเตอร์ที่อัปเดตจากแบ็กเอนด์ Remote Config และควบคุมเวลาที่จะให้แอปเข้าถึงค่าที่ดึงข้อมูลได้ ดูข้อมูลเพิ่มเติมได้ที่กลยุทธ์การโหลดการกําหนดค่าระยะไกล
ขั้นตอนที่ 1: เพิ่ม Firebase ไปยังแอป
คุณต้องดำเนินการต่อไปนี้ก่อนจึงจะใช้ Remote Config ได้
ลงทะเบียนโปรเจ็กต์ C++ และกำหนดค่าให้ใช้ Firebase
หากโปรเจ็กต์ C++ ใช้ Firebase อยู่แล้ว โปรเจ็กต์ดังกล่าวจะได้รับการลงทะเบียนและกำหนดค่าสำหรับ Firebase แล้ว
เพิ่ม Firebase C++ SDK ลงในโปรเจ็กต์ C++
โปรดทราบว่าการเพิ่ม Firebase ลงในโปรเจ็กต์ C++ เกี่ยวข้องกับงานทั้งในFirebaseคอนโซลและในโปรเจ็กต์ C++ ที่เปิดอยู่ (เช่น คุณดาวน์โหลดไฟล์การกําหนดค่า Firebase จากคอนโซล แล้วย้ายไฟล์เหล่านั้นไปยังโปรเจ็กต์ C++)
ขั้นตอนที่ 2: เพิ่ม Remote Config ลงในแอป
Android
หลังจากเพิ่ม Firebase ลงในแอปแล้ว ให้ทำดังนี้
สร้างแอป Firebase โดยส่งผ่านสภาพแวดล้อม JNI และกิจกรรม ดังนี้
app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);
เริ่มต้นใช้งานไลบรารี Remote Config ดังที่แสดงต่อไปนี้
::firebase::remote_config::Initialize(app);
iOS ขึ้นไป
หลังจากเพิ่ม Firebase ลงในแอปแล้ว ให้ทำดังนี้
สร้างแอป Firebase โดยทำดังนี้
app = ::firebase::App::Create(::firebase::AppOptions());
เริ่มต้นใช้งานไลบรารี Remote Config ดังที่แสดงต่อไปนี้
::firebase::remote_config::Initialize(app);
ขั้นตอนที่ 3: ตั้งค่าพารามิเตอร์เริ่มต้นในแอป
คุณสามารถตั้งค่าพารามิเตอร์เริ่มต้นในแอปในRemote Configออบเจ็กต์ เพื่อให้แอปทำงานตามที่ตั้งใจไว้ก่อนที่จะเชื่อมต่อกับแบ็กเอนด์Remote Config และเพื่อให้มีค่าเริ่มต้นหากไม่ได้ตั้งค่าไว้ในแบ็กเอนด์
กําหนดชุดชื่อพารามิเตอร์และค่าพารามิเตอร์เริ่มต้นโดยใช้ออบเจ็กต์
ConfigKeyValue*
หรือออบเจ็กต์ConfigKeyValueVariant*
ที่มีขนาดของอาร์เรย์หากกําหนดค่าค่าพารามิเตอร์แบ็กเอนด์ Remote Config ไว้แล้ว คุณสามารถดาวน์โหลดไฟล์ที่มีคู่คีย์/ค่าเหล่านี้และใช้เพื่อสร้างออบเจ็กต์
map
ดูข้อมูลเพิ่มเติมได้ที่หัวข้อดาวน์โหลดค่าเริ่มต้นของเทมเพลต Remote Configเพิ่มค่าเหล่านี้ลงในออบเจ็กต์ Remote Config โดยใช้
SetDefaults()
ขั้นตอนที่ 4: รับค่าพารามิเตอร์เพื่อใช้ในแอป
ตอนนี้คุณรับค่าพารามิเตอร์จากออบเจ็กต์ Remote Config ได้แล้ว หากคุณตั้งค่าค่าในแบ็กเอนด์ Remote Config ดึงข้อมูล แล้วเปิดใช้งาน ค่าเหล่านั้นจะใช้ได้กับแอปของคุณ มิเช่นนั้น คุณจะได้รับค่าพารามิเตอร์ในแอปที่กําหนดค่าโดยใช้ SetDefaults()
หากต้องการรับค่าเหล่านี้ ให้เรียกใช้เมธอดที่แสดงด้านล่างซึ่งจับคู่กับประเภทข้อมูลที่แอปของคุณคาดไว้ โดยระบุคีย์พารามิเตอร์เป็นอาร์กิวเมนต์
ขั้นตอนที่ 5: ตั้งค่าพารามิเตอร์
- เปิดโปรเจ็กต์ในคอนโซล Firebase
- เลือก Remote Config จากเมนูเพื่อดูหน้าแดชบอร์ด Remote Config
- กําหนดพารามิเตอร์ที่มีชื่อเดียวกับพารามิเตอร์ที่คุณกําหนดในแอป คุณสามารถกําหนดค่าเริ่มต้น (ซึ่งจะลบล้างค่าเริ่มต้นในแอปในที่สุด) และค่าแบบมีเงื่อนไขสําหรับพารามิเตอร์แต่ละรายการ ดูข้อมูลเพิ่มเติมได้ที่พารามิเตอร์และเงื่อนไข Remote Config
ขั้นตอนที่ 6: ดึงข้อมูลและเปิดใช้งานค่า
- หากต้องการดึงค่าพารามิเตอร์จากแบ็กเอนด์ Remote Config ให้เรียกใช้เมธอด
Fetch()
ระบบจะดึงข้อมูลค่าที่คุณตั้งค่าในแบ็กเอนด์และแคชไว้ในออบเจ็กต์ Remote Config - หากต้องการให้แอปใช้ค่าพารามิเตอร์ที่ดึงข้อมูล ให้เรียกใช้
ActivateFetched()
ขั้นตอนที่ 7: ฟังการอัปเดตแบบเรียลไทม์
หลังจากดึงข้อมูลค่าพารามิเตอร์แล้ว คุณสามารถใช้ Remote Config แบบเรียลไทม์เพื่อรับฟังการอัปเดตจากแบ็กเอนด์ Remote Config Remote Configส่งสัญญาณแบบเรียลไทม์ไปยังอุปกรณ์ที่เชื่อมต่อเมื่อมีการอัปเดต และดึงข้อมูลการเปลี่ยนแปลงโดยอัตโนมัติหลังจากที่คุณเผยแพร่Remote Configเวอร์ชันใหม่
Firebase C++ SDK เวอร์ชัน 11.0.0 ขึ้นไปและเวอร์ชันที่ใหม่กว่าสำหรับแพลตฟอร์ม Android และ Apple รองรับการอัปเดตแบบเรียลไทม์
- ในแอป ให้เรียกใช้
AddOnConfigUpdateListener
เพื่อเริ่มการรอการอัปเดต และดึงข้อมูลค่าพารามิเตอร์ใหม่หรือที่อัปเดตแล้วโดยอัตโนมัติ ตัวอย่างต่อไปนี้จะคอยฟังการอัปเดต และเมื่อเรียกActivate
จะใช้ค่าที่ดึงข้อมูลใหม่เพื่อแสดงข้อความต้อนรับที่อัปเดต
remote_config->AddOnConfigUpdateListener( [](firebase::remote_config::ConfigUpdate&& config_update, firebase::remote_config::RemoteConfigError remote_config_error) { if (remote_config_error != firebase::remote_config::kRemoteConfigErrorNone) { printf("Error listening for config updates: %d", remote_config_error); } // Search the `updated_keys` set for the key "welcome_message." // `updated_keys` represents the keys that have changed since the last // fetch. if (std::find(config_update.updated_keys.begin(), config_update.updated_keys.end(), "welcome_message") != config_update.updated_keys.end()) { remote_config->Activate().OnCompletion( [&](const firebase::Future& completed_future, void* user_data) { // The key "welcome_message" was found within `updated_keys` and // can be activated. if (completed_future.error() == 0) { DisplayWelcomeMessage(); } else { printf("Error activating config: %d", completed_future.error()); } }, nullptr); } });
เมื่อคุณเผยแพร่ Remote Config เวอร์ชันใหม่ในครั้งถัดไป อุปกรณ์ที่ใช้แอปของคุณและรอการเปลี่ยนแปลงจะเรียกฟังก์ชันการฟังการอัปเดตการกําหนดค่า
ขั้นตอนถัดไป
หากยังไม่ได้ดู ให้ลองดูRemote Config กรณีการใช้งานและอ่านเอกสารประกอบเกี่ยวกับแนวคิดหลักและกลยุทธ์ขั้นสูงบางส่วน ซึ่งได้แก่