Mindestversion der App mit Remote Config erzwingen

Im Zuge der Weiterentwicklung Ihrer App können neue Releases funktionsgefährdende Änderungen an Backend-APIs einführen, kritische Sicherheitslücken schließen oder veraltete Dienste und KI-Modelle ersetzen. In diesen Fällen funktionieren ältere App-Versionen möglicherweise nicht mehr zuverlässig oder sicher.

Mit Remote Config können Sie die Anforderungen an die App-Version dynamisch über die Cloud steuern. Wenn Sie Versionsparameter in Remote Config definieren, können Sie Nutzer auffordern oder dazu verpflichten, ihre App zu aktualisieren, ohne eine benutzerdefinierte Serverinfrastruktur bereitzustellen oder ein Notfallupdate zu veröffentlichen.

Aktualisierungsstrategie auswählen

Remote Config stellt die Versionsparameter bereit, die auf dem Client ausgewertet werden sollen. So können Sie die Benutzeroberfläche für Updates Ihrer App je nach Schweregrad der Änderung für eine von zwei Strategien konfigurieren:

  • Erzwungenes (blockierendes) Update: Wenn eine frühere App-Version nicht mit Ihrem Back-End kompatibel ist oder ein Sicherheitsrisiko darstellt, können Sie den Zugriff auf die App blockieren, bis der Nutzer sie aktualisiert. Wenn die installierte Version älter als die erforderliche Mindestversion ist, können Sie Ihre App so konfigurieren, dass ein nicht schließbares Dialogfeld angezeigt wird, über das der Nutzer zum App-Shop der Plattform weitergeleitet wird, um die aktuelle Version zu installieren.
  • Flexibles (optionales) Update: Wenn ein Update neue Funktionen, Leistungsverbesserungen oder kleinere Fehlerkorrekturen enthält, können Sie Ihre App so konfigurieren, dass ein schließbares Banner oder eine Aufforderung angezeigt wird, die Nutzer dazu ermutigt, das Update zu installieren, wenn es ihnen passt, während sie die App weiterhin verwenden können.

Schritt 1: Parameter in der Firebase-Konsole konfigurieren

Wenn Sie App-Versionen verwalten möchten, definieren Sie Parameter in Ihrer Remote Config-Vorlage:

  1. Rufen Sie in der Firebase-Konsole die Seite DevOps & Engagement > Remote Config > Parameter auf.
  2. Klicken Sie auf Parameter hinzufügen (oder auf Konfiguration erstellen, wenn dies Ihr erster Parameter ist).
  3. Legen Sie die folgenden Parameter fest:
    • minimum_version: Ein String, der die früheste unterstützte Version Ihrer App darstellt (z. B. "2.4.0"). Apps, die eine frühere Version als diesen Wert ausführen, werden bis zur Aktualisierung blockiert.
    • latest_version (optional): Ein String, der die neueste verfügbare Version Ihrer App darstellt (z. B. "2.5.1"). Für Apps mit einer Version zwischen minimum_version und latest_version kann eine optionale Updateempfehlung angezeigt werden.
    • update_url (optional): Die Store-URL, über die Nutzer das Update herunterladen können (z. B. Ihr Eintrag im Google Play Store oder Apple App Store).
  4. Optional: Fügen Sie plattformspezifische Bedingungen hinzu:
    • Da Android- und Apple-Apps häufig unterschiedliche Release-Versionen und Store-URLs verwenden, können Sie für jede Plattform bedingte Werte unter demselben Parameter hinzufügen.
    • Klicken Sie auf Wert für Bedingung hinzufügen > Bedingung erstellen. Benennen Sie die Bedingung (z. B. Android App oder iOS App), wählen Sie App als Targeting-Regel aus und wählen Sie Ihre App aus.
    • Legen Sie für jede Plattformbedingung den entsprechenden Versionsstring fest und behalten Sie den Standardwert als Fallback bei.
  5. Klicken Sie auf Speichern und dann auf Änderungen veröffentlichen, um die Vorlage anzuwenden.

Schritt 2: Clientseitige Versionsprüfungen implementieren

Prüfen Sie auf dem Client die installierte App-Version beim Start mit den Remote Config-Parametern:

  1. In-App-Standardwerte festlegen: Geben Sie in Ihrem App-Bundle immer sichere In-App-Standardwerte an (legen Sie beispielsweise minimum_version auf Ihren ersten App-Release fest, z. B. "1.0.0"). Diese Fallback-Konfiguration sorgt dafür, dass Ihre App weiterhin normal funktioniert, wenn das Gerät offline ist oder die erste Abrufanfrage fehlschlägt. Plattformspezifische Anleitungen finden Sie unter Standardvorlagen für Remote Config herunterladen.
  2. Remote Config abrufen und aktivieren: Ruft die neuesten Vorlagenwerte ab und aktiviert sie, wenn Ihre App gestartet wird.

  3. Versionen vergleichen: Rufe die aktiven Strings minimum_version und latest_version ab und vergleiche sie mit der aktuell installierten App-Version.

  4. Aktionen auf Grundlage des Versionsvergleichs ausführen:

    • Erforderliches Update erzwingen: Wenn current_version vor minimum_version liegt, wird eine nicht schließbare modale Warnung im Vollbildmodus angezeigt. Deaktivieren Sie die Navigation zum Rest der App und stellen Sie eine Schaltfläche bereit, über die die update_url im App-Shop der Plattform geöffnet wird.
    • Optionales Update vorschlagen: Wenn current_version vor latest_version liegt, wird ein Dialogfeld oder eine Benachrichtigung angezeigt, die Nutzer darüber informiert, dass ein Update verfügbar ist. Sie können dann Jetzt aktualisieren oder Später auswählen.
    • Zugriff erlauben: Andernfalls darf der Nutzer die App verwenden.

Best Practices

  • Echtzeit-Listener hinzufügen: Wenn Versionsupdates aufgrund von Sicherheitsproblemen oder einer erheblichen Beeinträchtigung der UX erforderlich sind, kann das Hinzufügen eines Echtzeit-Remote Config-Listeners zu Ihrer App dazu beitragen, dass Änderungen an den Versionsanforderungen sofort auf aktiven Geräten wirksam werden, ohne dass auf den nächsten geplanten Abruf oder App-Neustart gewartet werden muss.
  • Mit einer begrenzten Testgruppe testen: Bevor Sie die minimum_version für alle Produktionsnutzer erhöhen, sollten Sie die Bedingung mit einer begrenzten Testgruppe testen oder interne Tester mithilfe von benutzerdefinierten Nutzereigenschaften ansprechen. Mit diesem Test wird überprüft, ob das blockierende modale Fenster korrekt angezeigt wird und die Store-Links richtig aufgelöst werden.
  • In-App-Update-APIs der Plattform verwenden: Auf Android-Geräten können Sie In-App-Updates von Google Play zusammen mit Ihren Remote Config-Prüfungen einbinden, damit Nutzer Updates herunterladen und installieren können, ohne Ihre App zu verlassen.
  • Checklisten für die Produktion lesen: Weitere Informationen zur Vorbereitung Ihrer App und KI-Funktionen auf die Produktion finden Sie in der Checkliste für die Einführung von Firebase und der Checkliste für die Produktion von AI Logic.