Pemicu Remote Config

Anda dapat memicu fungsi sebagai respons terhadap peristiwa Firebase Remote Config, termasuk publikasi versi konfigurasi baru atau rollback ke versi yang lebih lama. Panduan ini berisi penjelasan mengenai cara membuat fungsi latar belakang Remote Config yang menjalankan operasi diff terhadap dua versi template.

Catatan: Cloud Functions for Firebase (generasi ke-2) merupakan rilis pratinjau publik. Artinya, fungsionalitasnya dapat berubah dengan cara yang membuatnya tidak kompatibel dengan versi sebelumnya. Pratinjau tidak tunduk pada SLA atau kebijakan penghentian layanan dan mungkin menerima dukungan terbatas atau tidak sama sekali.

Memicu fungsi Remote Config

Untuk memicu fungsi Remote Config, gunakan subpaket firebase-functions/v2/remoteConfig. Untuk merespons update template dengan cara yang ditunjukkan dalam panduan ini, Anda akan menggunakan fungsi onConfigUpdated, dengan mengimpornya bersama dengan komponen lain yang diperlukan seperti Firebase Admin SDK:

// 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");
admin.initializeApp();
const fetch = require("node-fetch");
const jsonDiff = require("json-diff");
index.js

Objek TemplateVersion yang ditampilkan oleh onConfigUpdated berisi kolom metadata kunci untuk update template seperti nomor versi dan waktu update. Anda juga dapat mengambil email pengguna yang melakukan update, beserta nama dan gambar jika ada.

Berikut contoh fungsi Remote Config yang menampilkan hasil operasi diff terhadap setiap versi yang diupdate dan versi yang digantikannya. Fungsi ini memeriksa kolom versionNumber di objek template dan mengambil versi saat ini (yang baru diupdate) sekaligus versi yang memiliki satu nomor lebih rendah:

exports.showconfigdiff = onConfigUpdated((event) => {
  // Obtain the access token from the admin SDK
  return admin.credential.applicationDefault().getAccessToken()
      .then((accessTokenObj) => {
        return accessTokenObj.access_token;
      })
      .then((accessToken) => {
      // Get the version number from the event object
        const currentVersion = event.data.versionNumber;
        const templatePromises = [];
        templatePromises.push(getTemplate(currentVersion, accessToken));
        templatePromises.push(getTemplate(currentVersion - 1, accessToken));
        // Get the templates
        return Promise.all(templatePromises);
      })
      .then((results) => {
        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);

        return null;
      }).catch((error) => {
        logger.error(error);
        return null;
      });
});
index.js

Contoh ini menggunakan modul json-diff dan request-promise untuk membuat hasil operasi diff dan mem-build permintaan guna mendapatkan objek template. Untuk mengetahui contoh fungsi generasi ke-1 yang menggabungkan logika klien Remote Config dan Firebase Cloud Messaging, baca artikel Menerapkan update Remote Config secara real time.