Funkcję możesz wywołać w odpowiedzi na zdarzenia Firebase Remote Config, w tym opublikowanie nowej wersji konfiguracji lub wycofanie zmian do starszej wersji. Z tego przewodnika dowiesz się, jak utworzyć Remote Configfunkcję w tle, która porównuje 2 wersje szablonu.
Aktywowanie funkcji Remote Config
Aby aktywować funkcję Remote Config, najpierw zaimportuj wymagane moduły:
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");
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
Następnie zdefiniuj moduł obsługi zdarzenia aktualizacji. Obiekt zdarzenia przekazywany do tej funkcji zawiera metadane dotyczące aktualizacji szablonu, takie jak nowy numer wersji i czas aktualizacji. Możesz też pobrać adres e-mail użytkownika, który wprowadził aktualizację, wraz z jego imieniem i nazwiskiem oraz zdjęciem (jeśli jest dostępne).
Oto przykład Remote Configfunkcji, która rejestruje różnice między każdą zaktualizowaną wersją a wersją, którą zastąpiła. Funkcja sprawdza pole numeru wersji obiektu szablonu i pobiera bieżącą (nowo zaktualizowaną) wersję wraz z wersją o numerze o jeden niższym:
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);
}
});
W tym przykładzie użyto modułów json-diff
i request-promise
do utworzenia różnicy i skonstruowania żądania pobrania obiektu szablonu.
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())
W tym przykładzie do utworzenia różnicy użyto deepdiff
, a do utworzenia i wysłania żądania pobrania obiektu szablonu użyto requests
.