Zum Hauptinhalt springen
Direkte Updates

Nutzer erhalten beim App-Start sofort die neueste Version

Standardmäßig wird ein live update nach dem Download nur für eine Session ausgeführt. Direct-Update-Modi spielen es stattdessen beim Start hinter deinem Splashscreen ein, sodass Nutzer auf dem ersten Bildschirm bereits die neue Version sehen.

autoUpdate: atInstall, onLaunch oder always
Splash-Screen bleibt sichtbar, bis das Update bereit ist
Delta-Downloads halten die Wartezeit kurz

Das Problem

Background-Updates kommen eine Session zu spät an

Was im Standardmodus passiert

1

Der User öffnet die App

Die App startet mit dem Bundle, das sie bereits hat. Der Updater prüft auf ein neues und lädt es im Hintergrund herunter.

2

Die Session nutzt die aktuelle Version

Für den Rest dieser Session nutzt der User das code, das vor deinem Fix installiert wurde.

3

Das Update wird beim nächsten Resume angewendet

Sobald der Nutzer die App verlässt, installiert der Updater das neue Bundle. Beim nächsten App-Start ist es dann verfügbar.

Für die meisten Releases ist das der richtige Kompromiss. Wenn die Session, die nach deinem Upload startet, das neue code nutzen muss, verwende einen Direct-Update-Modus.

Wenn es auf die erste Session ankommt

Ein fehlerhafter Payment- oder Login-Flow

User, die die App öffnen, sollten nicht noch einmal durch den fehlerhaften Screen müssen, bevor der Fix greift.

Ein Security-Fix auf Web-Layer-Ebene

Du willst das gepatchte JavaScript direkt beim Start nutzen, nicht erst in der nächsten Session.

Eine terminierte Änderung

AGB, Hinweise oder Event-Inhalte, die auf dem ersten Screen aktuell sein müssen.

Die Lösung

Was sich im Direct-Update-Modus ändert

Der Updater prüft beim Start, während dein Splash Screen sichtbar bleibt. Ist ein neues Bundle verfügbar, wird es heruntergeladen und angewendet, bevor der Splash Screen verschwindet.

Standardmodus (atBackground)

1
Der User öffnet die App
2
Die App zeigt die aktuelle Version
3
Das Update wird im Hintergrund heruntergeladen
4
Das Update wird beim nächsten Resume angewendet

Kein Warten beim Start. Nutzer sehen das Update eine Sitzung später.

Direct-Modus (onLaunch)

1
Der Nutzer öffnet die App und der Splash-Screen bleibt sichtbar
2
Der Updater prüft und lädt die geänderten Dateien herunter
3
Das Update wird angewendet, der Splash-Screen verschwindet, die neue Version erscheint

Nutzer sehen die neue Version auf dem ersten Bildschirm. Sie warten auf dem Splash-Screen, während das Update heruntergeladen wird.

Doku zum Update-Verhalten

So funktioniert es

So richtest du Direct Updates ein

Ein Direct-Modus ist native Konfiguration, deshalb kommt er zuerst mit einem Store-Build. Danach folgt jedes live update diesem Modus. Die Befehle stammen aus der Capgo-Dokumentation.

  1. Splash-Screen-Plugin hinzufügen und einen Modus wählen

    Installiere @capacitor/splash-screen und setze dann autoUpdate, autoSplashscreen und launchAutoHide in capacitor.config.ts.

    npm install @capacitor/splash-screen
    npx cap sync
    
    // capacitor.config.ts
    plugins: {
      CapacitorUpdater: {
        autoUpdate: 'onLaunch', // or 'atInstall' / 'always'
        autoSplashscreen: true,
        keepUrlPathAfterReload: true,
      },
      SplashScreen: { launchAutoHide: false },
    }
    Splash-Screen-Handling
  2. Config im Store-Build mitsenden

    capacitor.config wird in die native App kompiliert, sodass der neue Modus mit deinem nächsten Store-Release bei den Usern ankommt. Capgo Build kann es in der Cloud erstellen.

    npx @capgo/cli@latest build request --platform ios
    npx @capgo/cli@latest build request --platform android
    Capgo Build-Dokumentation
  3. Bundles als Deltas uploaden

    Beim Start warten die User auf den Download, also sende nur die geänderten Dateien. CLI erkennt Instant-Apply-Modi und schlägt einen Delta-Upload vor.

    npx @capgo/cli@latest bundle upload --channel production --delta
    Delta-Updates-Doku
  4. Automatisches Rollback aktiviert lassen

    Rufe notifyAppReady() auf, sobald deine App gestartet ist. Falls ein neues Bundle nicht startet, springt das Gerät auf das letzte funktionierende zurück.

    import { CapacitorUpdater } from '@capgo/capacitor-updater'
    
    await CapacitorUpdater.notifyAppReady()
    notifyAppReady()-Docs

Wähle den passenden Modus für deine App

Direct Updates sind ein Tausch: kurze Wartezeit beim Start gegen die neue Version auf dem ersten Bildschirm.

Drei Modi zum sofortigen Anwenden

Setze autoUpdate in der capacitor.config.ts. Jeder Modus legt fest, wann ein Update angewendet werden darf, während der Nutzer wartet.

  • atInstall: nur direkt nach einer Neuinstallation oder einem Store-Update der nativen App
  • onLaunch: wenn die App aus einem beendeten Zustand startet (Cold Start)
  • immer: bei jedem Foreground-Check, auch während die App offen ist
Updater-Einstellungen

3

Instant-Apply-Modi in autoUpdate

Splash-Screen-Handling

Direktmodi benötigen @capacitor/splash-screen mit launchAutoHide auf false und autoSplashscreen auf true gesetzt. Der Updater blendet den Splashscreen aus, sobald das Update angewendet wurde oder feststeht, dass kein Update nötig ist.

  • Kein manueller SplashScreen.hide()-Aufruf erforderlich
  • keepUrlPathAfterReload hält den User nach dem Reload auf derselben Route
  • Auf appReady hören, falls nach dem Ausblenden des Splashscreens zusätzliche Arbeit nötig ist
Splash-Screen-Handling

autoSplashscreen

Erforderlich für jeden Direktmodus

Trade-offs einplanen

Nutzer warten beim Start auf den Download, mit always kann die App während der Nutzung neu geladen werden. Plane beides ein.

  • Mit --delta uploaden, damit nur geänderte Dateien heruntergeladen werden
  • App-State speichern und wiederherstellen, damit beim Reload kein Fortschritt verloren geht
  • Standardmodus beibehalten, wenn eine Session Verzögerung okay ist
Delta-Updates-Doku

--delta

Empfohlen für jeden Direct-Update-Upload

Wann Direct Updates sinnvoll sind

Nutze einen Direct Mode, wenn die aktuelle Session das neue code ausführen muss. Sonst beim Standard bleiben.

Kritische Bugfixes

Zahlungs-, Login- oder Daten-Bugs, bei denen eine weitere Session mit dem alten code zu viel ist.

Onboarding beim ersten Start

atInstall wendet das neueste Bundle direkt nach einer Neuinstallation oder einem Store-Update an, damit neue Nutzer mit Ihrem aktuellen Onboarding starten.

Zeitkritische Inhalte

Eventseiten, Mitteilungen oder AGB, die aktuell sein müssen, wenn Nutzer die App öffnen.

Security-Patches

Web-Layer-Sicherheitsfixes, die ab dem Start laufen sollten. Fixes im nativen code erfordern weiterhin ein Store-Release.

Regelmäßige Releases

Styling-Anpassungen und kleine Features rechtfertigen selten eine Wartezeit beim Start. Der Standardmodus wendet sie eine Sitzung später an.

Apps, die stundenlang offen bleiben

Mit always können periodische Checks (standardmäßig alle 10 Minuten) ein Update anwenden, während die App offen ist. Speichern Sie den Zustand, bevor Sie sich darauf verlassen.

Kurze Wartezeit beim Start

Die Wartezeit beim Start besteht aus dem Update-Check und dem Download. Delta-Updates beschränken den Download auf die geänderten Dateien.

~50 ms

Typische API-Latenz

Delta

Nur geänderte Dateien werden heruntergeladen

1 Mrd.+

Ausgelieferte Updates pro Monat

Mit Capacitor gebaute Apps

Apps mit öffentlichen Infos brauchen dringende Content-Fixes

Notfall-, Gesundheits- und Bürger-Apps können nicht tagelang warten, bis eine fehlerhafte Checkliste, ein Ressourcen-Link oder ein standortspezifischer Hinweis korrigiert ist. Direct Updates sorgen dafür, dass der Web-Layer live geht, sobald der Fix freigegeben ist.

FEMA-App-Icon WETTER

FEMA

Notfallhinweise, bei denen kleine Inhaltsfehler schnell kritisch werden können.

Google Play-Installationen
1,6 Mio.
Store-Bewertung
4.0
Conecte SUS App-Icon MEDIZIN

SUS verbinden

Gesundheitsakten und Informationsangebote, bei denen freigegebene Textänderungen schnell ausgeliefert werden müssen.

Google Play-Installationen
27,7 Mio.
Store-Bewertung
4.6
e-Título-App-Icon SOZIAL

e-Titel

Workflows für digitale Identitäten, bei denen versionssichere Hinweise geräteübergreifend entscheidend sind.

Google Play-Installationen
54,9 Mio.
Store-Bewertung
4.8

Kundenstimmen

Das sagen Teams, die mit Capgo deployen

5.0/5 von Entwicklerteams bewertet 9,400+ Teams Bewertungen lesen

Kapil

Gründer, NuTriQ

“Die Möglichkeit, produktive OTA-Updates sofort zu pushen, ohne auf die kompletten Review-Zyklen des App Store warten zu müssen, war ein enormer operativer Vorteil.”

Porträt von Sergiu S

Sergiu S

Lead Developer, drivolino GmbH

„Das Capgo Capacitor Updater-Plugin hat komplett verändert, wie wir Updates ausliefern. Was früher Tage dauerte, dauert jetzt nur noch Minuten.“

Porträt von Luis Dominguez

Luis Dominguez

Wer zahlt, bestimmt.

“Seit ich Capgo nutze, ist alles schneller, und ich kann meinen Usern die Zeit geben, die sie verdienen, ohne meinen Alltag zu vernachlässigen.”

FAQ

Fragen zu Direct Updates

Wann du sie einsetzt, wie du sie einrichtest und was sie zum Launch kosten.

Sollten wir Direct Updates oder den Standard-Background-Modus nutzen?

Nutze den Standard für die meisten Releases: Beim Launch gibt es keine Wartezeit, und Nutzer bekommen das Update eine Session später. Nutze einen Direct Mode, wenn die Session, die nach deinem Upload startet, den neuen code ausführen muss – etwa bei einem defekten Checkout oder einem Security-Fix im Web-Layer.

Doku zum Update-Verhalten

Was ist der Unterschied zwischen atInstall, onLaunch und always?

atInstall wendet ein Update nur direkt nach einer Neuinstallation oder einem Store-Update der nativen App sofort an und verhält sich danach wie der Standard. onLaunch wendet es sofort an, wenn die App aus einem beendeten Zustand startet. always prüft bei jedem Foreground-Wechsel und wendet es an, sobald der Download fertig ist – selbst während der Nutzer in der App ist.

Updater-Einstellungen

Warum ist das Splash Screen Plugin erforderlich?

Direct Modes wenden das Update an, während der Nutzer wartet. Ohne @capacitor/splash-screen, autoSplashscreen: true und launchAutoHide: false kann es vor dem Reload flackern oder die alte UI zu sehen sein. Mit diesen Einstellungen bleibt der Splash Screen aktiv, bis das Update angewendet wurde oder der Updater weiß, dass keines nötig ist.

Splash-Screen-Handling

Können wir Direct Updates mit einem live update aktivieren?

Nein, autoUpdate steht in der capacitor.config, die beim Build in die native App eingelesen wird. Veröffentliche die neue Einstellung mit einem Store-Release. Danach folgt jedes live update dem neuen Modus.

Doku zur nativen Kompatibilität

Unsere Config nutzt directUpdate. Wird das noch unterstützt?

directUpdate ist deprecated, wird aber noch erkannt. Die Werte entsprechen den autoUpdate-Modi atInstall, onLaunch und always. Verschiebe die Einstellung in deinem nächsten nativen Release auf autoUpdate.

Updater-Einstellungen

Bring deinen nächsten Fix auf den ersten Screen

Teste einen Direct-Update-Modus in einem Test-Build während der Testphase und miss die Wartezeit beim Start in deiner eigenen App.

14 Tage kostenlos testen. Keine Kreditkarte erforderlich.