Remote-Konfigurationsvorlagen und Versionierung

Node.js

function listAllVersions() {
  admin.remoteConfig().listVersions()
    .then((listVersionsResult) => {
      console.log("Successfully fetched the list of versions");
      listVersionsResult.versions.forEach((version) => {
        console.log('version', JSON.stringify(version));
      });
    })
    .catch((error) => {
      console.log(error);
    });
}

Java

ListVersionsPage page = FirebaseRemoteConfig.getInstance().listVersionsAsync().get();
while (page != null) {
  for (Version version : page.getValues()) {
    System.out.println("Version: " + version.getVersionNumber());
  }
  page = page.getNextPage();
}

// Iterate through all versions. This will still retrieve versions in batches.
page = FirebaseRemoteConfig.getInstance().listVersionsAsync().get();
for (Version version : page.iterateAll()) {
  System.out.println("Version: " + version.getVersionNumber());
}

AUSRUHEN

curl --compressed -D headers -H "Authorization: Bearer <var>token</var>" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/<var>my-project-id</var>/remoteConfig:listVersions

Firebase-Konsole

Wählen Sie auf der Registerkarte „Parameter “ das oben rechts angezeigte „Uhr“-Symbol aus. Dadurch wird die Seite „Änderungsverlauf“ geöffnet, in der alle gespeicherten Vorlagenversionen in einem Listenmenü auf der rechten Seite aufgeführt sind.

Zu den für jede gespeicherte Version angezeigten Details gehören Informationen darüber, ob die Änderungen von der Konsole, mit der REST-API, von einem Rollback stammen oder ob es sich um inkrementelle Änderungen aus einer erzwungenen Speicherung der Vorlage handelte.

Firebase-CLI

firebase remoteconfig:versions:list

Verwenden Sie die Option --limit , um die Anzahl der zurückgegebenen Versionen zu begrenzen. Übergeben Sie „0“, um alle Versionen abzurufen.

Node.js

Übergeben Sie getTemplate() ohne Argumente, um die neueste Version der Vorlage abzurufen. Um eine bestimmte Version abzurufen, verwenden Sie getTemplateAtVersion() .

// Get template version: 6
admin.remoteConfig().getTemplateAtVersion('6')
  .then((template) => {
    console.log("Successfully fetched the template with ETag: " + template.etag);
  })
  .catch((error) => {
    console.log(error);
  });

Java

Template template = FirebaseRemoteConfig.getInstance().getTemplateAtVersionAsync(versionNumber).get();
// See the ETag of the fetched template.
System.out.println("Successfully fetched the template with ETag: " + template.getETag());

AUSRUHEN

curl --compressed -D headers -H "Authorization: Bearer <var>token</var>" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/<var>my-project-id</var>/remoteConfig?version_number=6

Der URL-Parameter ?version_number ist nur für GET Vorgänge gültig; Sie können damit keine Versionsnummern für Updates angeben. Eine ähnliche Get-Anfrage ohne den Parameter ?version_number würde die aktuell aktive Vorlage abrufen.

Firebase-Konsole

Standardmäßig wird im Detailbereich der Registerkarte „Änderungsverlauf“ die aktuell aktive Vorlage angezeigt. Um Details für eine andere Version in der Liste anzuzeigen, wählen Sie diese im rechten Menü aus.

Sie können einen detaillierten Unterschied zwischen der aktuell ausgewählten Version und jeder anderen gespeicherten Version anzeigen, indem Sie den Mauszeiger über das Kontextmenü einer nicht ausgewählten Version bewegen und „Mit ausgewählter Version vergleichen“ auswählen.

Firebase-CLI

firebase remoteconfig:get -v VERSION_NUMBER

Optional können Sie die Ausgabe mit -o, FILENAME in eine angegebene Datei schreiben.

Node.js

// Roll back to template version: 6
admin.remoteConfig().rollback('6')
  .then((template) => {
    console.log("Successfully rolled back to template version 6.");
    console.log("New ETag: " + template.etag);
  })
  .catch((error) => {
    console.log('Error trying to rollback:', e);
  })

Java

try {
  Template template = FirebaseRemoteConfig.getInstance().rollbackAsync(versionNumber).get();
  System.out.println("Successfully rolled back to template version: " + versionNumber);
  System.out.println("New ETag: " + template.getETag());
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Error trying to rollback template.");
    System.out.println(rcError.getMessage());
  }
}

AUSRUHEN

Um ein Rollback auf eine gespeicherte Remote-Konfigurationsvorlage durchzuführen, geben Sie einen HTTP-POST mit der benutzerdefinierten Methode :rollback und im Anforderungstext der spezifischen anzuwendenden Version aus. Zum Beispiel:

curl --compressed -D headers -H "Authorization: Bearer <var>token</var>" -H "Content-Type: application/json" -X POST https://firebaseremoteconfig.googleapis.com/v1/projects/<var>my-project-id</var>/remoteConfig:rollback -d '{"version_number": 6}'

Die Antwort enthält den Inhalt der jetzt aktiven gespeicherten Vorlage mit den Metadaten der neuen Version.

Firebase-Konsole

Für frühere Vorlagenversionen, die für ein Rollback in Frage kommen, wird oben rechts auf der Seite „Änderungsverlauf“ eine Optionsschaltfläche zum Zurücksetzen auf diese Version angezeigt. Klicken und bestätigen Sie dies nur, wenn Sie sicher sind, dass Sie auf diese Version zurücksetzen und diese Werte sofort für alle Apps und Benutzer verwenden möchten.

Firebase-CLI

firebase remoteconfig:rollback -v VERSION_NUMBER

Node.js

function getTemplate() {
  var config = admin.remoteConfig();
  config.getTemplate()
      .then(function (template) {
        console.log('ETag from server: ' + template.etag);
        var templateStr = JSON.stringify(template);
        fs.writeFileSync('config.json', templateStr);
      })
      .catch(function (err) {
        console.error('Unable to get template');
        console.error(err);
      });
}

Java

Template template = FirebaseRemoteConfig.getInstance().getTemplateAsync().get();
// See the ETag of the fetched template.
System.out.println("ETag from server: " + template.getETag());

AUSRUHEN

curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig -o filename

Dieser Befehl gibt die JSON-Nutzlast in eine Datei und die Header (einschließlich ETag) in eine separate headers Datei aus.

Firebase-Konsole

1. Öffnen Sie auf der Registerkarte „Remote-Konfigurationsparameter oder -Bedingungen“ das Menü more_vert “ und wählen Sie „Aktuelle Konfigurationsdatei herunterladen“ aus.
2. Wenn Sie dazu aufgefordert werden, klicken Sie auf Konfigurationsdatei herunterladen , wählen Sie den Speicherort aus, an dem Sie die Datei speichern möchten, und klicken Sie dann auf Speichern .

Firebase-CLI

firebase remoteconfig:get -o filename

Node.js

function validateTemplate(template) {
  admin.remoteConfig().validateTemplate(template)
      .then(function (validatedTemplate) {
        // The template is valid and safe to use.
        console.log('Template was valid and safe to use');
      })
      .catch(function (err) {
        console.error('Template is invalid and cannot be published');
        console.error(err);
      });
}

Java

try {
  Template validatedTemplate = FirebaseRemoteConfig.getInstance()
          .validateTemplateAsync(template).get();
  System.out.println("Template was valid and safe to use");
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Template is invalid and cannot be published");
    System.out.println(rcError.getMessage());
  }
}

AUSRUHEN

Validieren Sie Vorlagenaktualisierungen, indem Sie den URL-Parameter ?validate_only=true an Ihre Veröffentlichungsanfrage anhängen:

curl --compressed -H "Content-Type: application/json; UTF8" -H "If-Match: last-returned-etag" -H "Authorization: Bearer token" -X PUT https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig?validate_only=true -d @filename

Wenn Ihre Vorlage erfolgreich validiert wurde, gibt der Befehl „curl“ die von Ihnen übermittelte JSON-Vorlage zurück und in der gespeicherten headers finden Sie einen HTTP/2-Status 200 und ein aktualisiertes ETag mit dem Suffix -0 . Wenn Ihre Vorlage nicht validiert wurde, erhalten Sie den Validierungsfehler in der JSON-Antwort und Ihre headers Datei enthält eine Nicht-200-Antwort (und kein ETag).

Node.js

function publishTemplate() {
  var config = admin.remoteConfig();
  var template = config.createTemplateFromJSON(
      fs.readFileSync('config.json', 'UTF8'));
  config.publishTemplate(template)
      .then(function (updatedTemplate) {
        console.log('Template has been published');
        console.log('ETag from server: ' + updatedTemplate.etag);
      })
      .catch(function (err) {
        console.error('Unable to publish template.');
        console.error(err);
      });
}

Java

try {
  Template publishedTemplate = FirebaseRemoteConfig.getInstance()
          .publishTemplateAsync(template).get();
  System.out.println("Template has been published");
  // See the ETag of the published template.
  System.out.println("ETag from server: " + publishedTemplate.getETag());
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Unable to publish template.");
    System.out.println(rcError.getMessage());
  }
}

AUSRUHEN

curl --compressed -H "Content-Type: application/json; UTF8" -H "If-Match: last-returned-etag" -H "Authorization: Bearer token" -X PUT https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig -d @filename

Für diesen curl Befehl können Sie den Inhalt angeben, indem Sie das Zeichen „@“ gefolgt vom Dateinamen verwenden.

Firebase-Konsole

1. Öffnen Sie auf der Registerkarte „Remote-Konfigurationsparameter oder -Bedingungen“ das Menü more_vert “ und wählen Sie „Aus einer Datei veröffentlichen“ aus.
2. Wenn Sie dazu aufgefordert werden, klicken Sie auf „ Durchsuchen“ , navigieren Sie zu der Remote-Konfigurationsdatei, die Sie veröffentlichen möchten, wählen Sie sie aus und klicken Sie dann auf „Auswählen“ .
3. Die Datei wird validiert und bei Erfolg können Sie auf „Veröffentlichen“ klicken, um die Konfiguration sofort für Ihre Apps und Benutzer verfügbar zu machen.

AUSRUHEN

curl --compressed -D headers -H "Authorization: Bearer token -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig:downloadDefaults?format=file_format'

Verwenden Sie XML , PLIST oder JSON als format , je nachdem, welches Dateiformat Sie herunterladen möchten.

Firebase-Konsole

1. Öffnen Sie auf der Registerkarte „Parameter“ das Menü more_vert und wählen Sie „Standardwerte herunterladen“ aus.
2. Wenn Sie dazu aufgefordert werden, klicken Sie auf das Optionsfeld für das Dateiformat, das Sie herunterladen möchten, und klicken Sie dann auf Datei herunterladen .