Umgang mit Updates am Manifest der Web-App in Chrome

So ändern Sie Symbole, Verknüpfungen, Farben und andere Metadaten für Ihre PWA

Adriana Jara
François Beaufort
François Beaufort
GitHub
Pete LePage

Wenn eine PWA installiert ist, verwendet der Browser die Informationen aus dem Web-App-Manifest für den App-Namen, die Symbole, die die App verwenden soll, und die URL, die beim Starten der App geöffnet werden soll. Aber was ist, wenn Sie App-Verknüpfungen aktualisieren oder eine neue Designfarbe ausprobieren müssen? Wann und wie werden diese Änderungen im Browser wiedergegeben?

In den meisten Fällen sollten Änderungen innerhalb von ein oder zwei Tagen nach dem Start der PWA berücksichtigt werden, nachdem das Manifest aktualisiert wurde.

Updates für den Chrome-Browser auf dem Computer

Wenn die PWA gestartet oder in einem Browsertab geöffnet wird, ermittelt Chrome, wann das lokale Manifest zuletzt auf Änderungen geprüft wurde. Wenn das Manifest seit dem letzten Start des Browsers nicht überprüft wurde oder in den letzten 24 Stunden nicht geprüft wurde, stellt Chrome eine Netzwerkanfrage für das Manifest und vergleicht diese mit der lokalen Kopie.

Wenn sich bestimmte Eigenschaften im Manifest geändert haben (siehe Liste unten), stellt Chrome das neue Manifest in die Warteschlange und installiert es, nachdem alle Fenster geschlossen wurden. Nach der Installation werden alle Felder aus dem neuen Manifest aktualisiert (außer name, short_name und icons).

Welche Properties lösen ein Update aus?

  • display (siehe unten)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers

Was passiert, wenn das Feld display aktualisiert wird?

Wenn Sie den Anzeigemodus Ihrer App von browser auf standalone aktualisieren, werden die Apps Ihrer vorhandenen Nutzer nach dem Update nicht in einem Fenster geöffnet. Für eine Webanwendung gibt es zwei Anzeigeeinstellungen: die über das Manifest, das Sie steuern, und eine Einstellung für das Fenster/Browsertab, die vom Nutzer gesteuert wird. Die Nutzerpräferenz wird immer berücksichtigt.

Manifestaktualisierungen testen

Die Seite chrome://web-app-internals (verfügbar in Chrome 85 oder höher) enthält detaillierte Informationen zu allen auf dem Gerät installierten PWAs. Außerdem können Sie beispielsweise nachvollziehen, wann das Manifest zuletzt oder wie oft es aktualisiert wurde.

Wenn Sie manuell erzwingen möchten, dass Chrome nach einem aktualisierten Manifest sucht, können Sie Chrome entweder mit dem Befehlszeilen-Flag --disable-manifest-update-throttle oder neu starten (über about://restart). Dadurch wird der Timer zurückgesetzt, sodass Chrome beim nächsten Start der PWA nach einem aktualisierten Manifest sucht. Starten Sie dann die PWA. Nachdem die PWA geschlossen wurde, sollte sie mit den neuen Manifesteigenschaften aktualisiert werden.

Verweise

Updates zu Chrome für Android

Wenn die PWA gestartet wird, ermittelt Chrome, wann das lokale Manifest zuletzt auf Änderungen geprüft wurde. Wenn das Manifest in den letzten 24 Stunden nicht geprüft wurde, plant Chrome eine Netzwerkanfrage für das Manifest und vergleicht sie mit der lokalen Kopie.

Wenn sich bestimmte Eigenschaften im Manifest geändert haben (siehe Liste unten), stellt Chrome das neue Manifest in die Warteschlange. Nachdem alle Fenster der PWA geschlossen wurden, das Gerät angeschlossen und mit dem WLAN verbunden ist, fordert Chrome ein aktualisiertes WebAPK vom Server an. Nach der Aktualisierung werden alle Felder des neuen Manifests verwendet.

Welche Properties lösen ein Update aus?

  • background_color
  • display
  • orientation
  • scope
  • shortcuts
  • start_url
  • theme_color
  • web_share_target

Wenn Chrome kein aktualisiertes Manifest vom Server abrufen kann, kann die Zeit zwischen den Prüfungen auf 30 Tage erhöht werden.

Manifestaktualisierungen testen

Die Seite about://webapks enthält detaillierte Informationen zu allen auf dem Gerät installierten PWAs. Außerdem können Sie unter anderem angeben, wann das Manifest zuletzt oder wie oft es aktualisiert wurde.

Wenn Sie manuell eine Aktualisierung des Manifests planen möchten, überschreiben Sie den Timer und das lokale Manifest so:

  1. Schließen Sie das Gerät an die Stromversorgung an und achten Sie darauf, dass es mit dem WLAN verbunden ist.
  2. Verwenden Sie den Android-Task-Manager, um die PWA zu beenden, und dann in den Android-Einstellungen das App-Steuerfeld, um das Beenden der PWA zu erzwingen.
  3. Öffnen Sie in Chrome about://webapks und klicken Sie für die PWA auf die Schaltfläche „Aktualisieren“. Der „Update-Status“ sollte sich in „Ausstehend“ ändern.
  4. Starten Sie die PWA und prüfen Sie, ob sie richtig geladen wird.
  5. Verwenden Sie den Android-Task-Manager, um die PWA zu beenden, und dann in den Android-Einstellungen das App-Steuerfeld, um das Beenden der PWA zu erzwingen.

Die PWA wird in der Regel innerhalb weniger Minuten aktualisiert. Sobald das Update abgeschlossen ist, sollte sich der „Updatestatus“ zu „Erfolgreich“ ändern.

Verweise