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

يمكنك تفعيل دالة استجابةً لـ 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/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 jsonDiff = require("json-diff");

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

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

في ما يلي مثال على دالة 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);
  }
});

يستخدم هذا المثال الوحدتَين 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())

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