مشغِّلات "الإعداد عن بُعد"

الجيل الثاني الجيل الأول

يمكنك تنشيط دالة استجابةً لأحداث Firebase Remote Config، بما في ذلك نشر إصدار جديد من الإعدادات أو الرجوع إلى إصدار قديم. يوضّح هذا الدليل كيفية إنشاء Remote Config دالة خلفية تُجري فرقًا بين نسختَي نموذج.

بدء دالة Remote Config

لتشغيل دالة Remote Config، عليك أولاً استيراد الوحدات المطلوبة:

Node.js

 // The Cloud Functions for Firebase SDK to set up triggers and logging.
const {onConfigUpdated} = require("firebase-functions/v2/remoteConfig");
const logger = require("firebase-functions/logger");
// The Firebase Admin SDK to obtain access tokens.
const admin = require("firebase-admin");
const app = admin.initializeApp();
const fetch = require("node-fetch");
const jsonDiff = require("json-diff");
index.js

Python

 # The Cloud Functions for Firebase SDK to set up triggers and logging.
from firebase_functions import remote_config_fn

# The Firebase Admin SDK to obtain access tokens.
import firebase_admin

app = firebase_admin.initialize_app()

import deepdiff
import requests
main.py

بعد ذلك، حدِّد معالِجًا لحدث التعديل. يحتوي عنصر الحدث الذي تم تمريره إلى هذه الدالة على بيانات وصفية حول تحديث النموذج، مثل رقم الإصدار الجديد ووقت التحديث. يمكنك أيضًا استرداد الرسالة الإلكترونية للمستخدم الذي أجرى التعديل، مع الاسم والصورة إذا كانت متاحة.

في ما يلي مثال على دالة Remote Config التي تسجِّل اختلافات كل إصدار معدَّل والإصدار الذي تم استبداله. تفحص الدالة حقل رقم الإصدار لعنصر النموذج وتسترجع الإصدار الحالي (الذي تم تعديله مؤخرًا) مع الإصدار الذي يسبقه بدرجة واحدة:

Node.js

 exports.showconfigdiff = onConfigUpdated(async (event) => {
  try {
    // Obtain the access token from the Admin SDK
    const accessTokenObj = await admin.credential.applicationDefault()
        .getAccessToken();
    const accessToken = accessTokenObj.access_token;

    // Get the version number from the event object
    const remoteConfigApi = "https://firebaseremoteconfig.googleapis.com/v1/" +
        `projects/${app.options.projectId}/remoteConfig`;
    const currentVersion = event.data.versionNumber;
    const prevVersion = currentVersion - 1;
    const templatePromises = [];
    templatePromises.push(fetch(
        remoteConfigApi,
        {
          method: "POST",
          body: new URLSearchParams([["versionNumber", currentVersion + ""]]),
          headers: {Authorization: "Bearer " + accessToken},
        },
    ));
    templatePromises.push(fetch(
        remoteConfigApi,
        {
          method: "POST",
          body: new URLSearchParams([["versionNumber", prevVersion + ""]]),
          headers: {Authorization: "Bearer " + accessToken},
        },
    ));

    // Get the templates
    const responses = await Promise.all(templatePromises);
    const results = responses.map((r) => r.json());
    const currentTemplate = results[0];
    const previousTemplate = results[1];
    // Figure out the differences of the templates
    const diff = jsonDiff.diffString(previousTemplate, currentTemplate);
    // Log the difference
    logger.log(diff);
  } catch (error) {
    logger.error(error);
  }
});
index.js

يستخدم هذا المثال وحدتَي json-diff و request-promise ل إنشاء الفرق وإنشاء الطلب للحصول على عنصر النموذج.

Python

 @remote_config_fn.on_config_updated()
def showconfigdiff(event: remote_config_fn.CloudEvent[remote_config_fn.ConfigUpdateData]) -> None:
    """Log the diff of the most recent Remote Config template change."""

    # Obtain an access token from the Admin SDK
    access_token = app.credential.get_access_token().access_token

    # Get the version number from the event object
    current_version = int(event.data.version_number)

    # Figure out the differences between templates
    remote_config_api = ("https://firebaseremoteconfig.googleapis.com/v1/"
                         f"projects/{app.project_id}/remoteConfig")
    current_template = requests.get(remote_config_api,
                                    params={"versionNumber": current_version},
                                    headers={"Authorization": f"Bearer {access_token}"})
    previous_template = requests.get(remote_config_api,
                                     params={"versionNumber": current_version - 1},
                                     headers={"Authorization": f"Bearer {access_token}"})
    diff = deepdiff.DeepDiff(previous_template, current_template)

    # Log the difference
    print(diff.pretty())
main.py

يستخدم هذا المثال deepdiff ل إنشاء الفرق، وrequests لإنشاء الطلب وإرساله للحصول على عنصر النموذج.