Mindestversion der App mit Remote Config erzwingen

Im Laufe der Entwicklung Ihrer App können durch neue Releases wichtige Änderungen an Backend-APIs eingeführt, kritische Sicherheitslücken behoben oder eingestellte Dienste und KI-Modelle ersetzt werden. In diesen Fällen funktionieren frühere 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 zwingen, ihre App zu aktualisieren, ohne eine benutzerdefinierte Serverinfrastruktur bereitzustellen oder ein Notfall-Update zu veröffentlichen.

Aktualisierungsstrategie auswählen

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

  • Erzwungenes (blockierendes) Update: Wenn eine frühere App-Version nicht mit Ihrem Backend 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 das erforderliche Minimum ist, können Sie Ihre App so konfigurieren, dass ein nicht schließbares Dialogfeld angezeigt wird, in dem der Nutzer aufgefordert wird, die aktuelle Version im App-Shop der Plattform 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 Banner oder eine Aufforderung angezeigt wird, die Nutzer dazu anregt, die App zu aktualisieren, wenn es ihnen passt. Sie können die App aber weiterhin verwenden.

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 Console 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 mit einer Version ausgeführt werden, die älter als dieser Wert ist, werden blockiert, bis sie aktualisiert werden.
    • latest_version (optional): Ein String, der die letzte verfügbare Version Ihrer App darstellt (z. B. "2.5.1"). Bei Apps mit einer Version zwischen minimum_version und latest_version kann eine optionale Update-Empfehlung angezeigt werden.
    • update_url (optional): Die Store-URL, unter der Nutzer das Update herunterladen können, z. B. Ihr Google Play Store- oder Apple App Store-Eintrag.
  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. Geben Sie einen Namen für die Bedingung ein (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 anhand der Remote Config-Parameter beim Start:

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

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

  4. Auf Grundlage des Versionsvergleichs Aktionen ausführen:

    • Erforderliches Update erzwingen: Wenn current_version vor minimum_version liegt, wird ein nicht schließbarer modaler Vollbild-Hinweis angezeigt. Deaktivieren Sie die Navigation zum Rest der App und stellen Sie eine Schaltfläche bereit, über die der update_url im App-Shop der Plattform geöffnet wird.
    • Optionales Update auffordern: Wenn current_version vor latest_version liegt, wird ein schließbares Dialogfeld oder eine Benachrichtigung angezeigt, in der Nutzer darüber informiert werden, dass ein Update verfügbar ist. Sie haben die Möglichkeit, Jetzt aktualisieren oder Später auszuwählen.
    • Zugriff zulassen: Andernfalls kann der Nutzer die App weiter verwenden.

Best Practices

  • Echtzeit-Listener hinzufügen: Wenn Versionsupdates aufgrund von Sicherheitsproblemen oder einer schwerwiegenden Verschlechterung der Nutzerfreundlichkeit erforderlich sind, kann das Hinzufügen eines Echtzeit-Remote ConfigListeners 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 Neustart der App gewartet werden muss.
  • Mit einer eingeschränkten Testgruppe testen: Bevor Sie die minimum_version für alle Produktionsnutzer erhöhen, sollten Sie die Bedingung mit einer eingeschränkten Testgruppe testen oder interne Tester mithilfe benutzerdefinierter Nutzerattribute ansprechen. Bei diesem Test wird geprüft, ob das Blockierungs-Modal korrekt angezeigt wird und ob die Store-Links richtig aufgelöst werden.
  • In-App-Update-APIs der Plattform verwenden: Auf Android sollten Sie neben Ihren Remote Config-Prüfungen auch Google Play In-App Updates 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 für die Produktion finden Sie in der Firebase-Checkliste für den Start und der AI Logic-Checkliste für die Produktion.