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 wird, verwendet der Browser Informationen aus dem Manifest der Webanwendung für den App-Namen, die Symbole, die von der App verwendet werden sollen, 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öchten? Wann und wie werden diese Änderungen im Browser berücksichtigt?

In den meisten Fällen sollten Änderungen innerhalb von ein bis zwei Tagen nach der Einführung der PWA, nachdem das Manifest aktualisiert wurde, übernommen werden.

Updates in der Desktopversion von Chrome

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 oder in den letzten 24 Stunden nicht geprüft wurde, sendet Chrome eine Netzwerkanfrage an das Manifest und vergleicht es dann mit der lokalen Kopie.

Wenn sich ausgewählte 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 mit Ausnahme von icons aktualisiert.

Welche Properties lösen ein Update aus?

  • name
  • short_name
  • 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 bestehenden Nutzer nach dem Update nicht mehr in einem Fenster geöffnet. Für eine Webanwendung gibt es zwei Anzeigeeinstellungen: die aus dem Manifest (die Sie steuern) und eine vom Nutzer gesteuerte Einstellung für Fenster/Browser-Tabs. Die Nutzereinstellungen werden immer berücksichtigt.

Manifestupdates 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. Sie können unter anderem sehen, wann das Manifest zuletzt aktualisiert wurde und wie oft es aktualisiert wird.

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

Verweise

Updates in 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 einen Netzwerkzugriff auf das Manifest und vergleicht es dann mit der lokalen Kopie.

Wenn sich ausgewählte 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 eine aktualisierte WebAPK vom Server an. Nach der Aktualisierung werden alle Felder aus dem neuen Manifest verwendet.

Welche Properties lösen ein Update aus?

  • name
  • short_name
  • icons
  • background_color
  • display
  • orientation
  • scope
  • shortcuts
  • start_url
  • theme_color
  • web_share_target

Wenn Chrome kein aktualisiertes Manifest vom Server abrufen kann, wird der Zeitraum zwischen den Prüfungen möglicherweise auf 30 Tage erhöht.

Manifestupdates testen

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

So planen Sie ein manuelles Update des Manifests, indem Sie den Timer und das lokale Manifest überschreiben:

  1. Schließen Sie das Gerät an und prüfen Sie, ob es mit dem WLAN verbunden ist.
  2. Verwenden Sie den Android-Task-Manager, um die PWA zu beenden, und dann das App-Steuerfeld in den Android-Einstellungen, um die PWA zu beenden.
  3. Öffnen Sie in Chrome about://webapks und klicken Sie auf die Schaltfläche „Aktualisieren“ für die PWA. Der Status „Update Status“ sollte zu „Ausstehend“ wechseln.
  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 das App-Steuerfeld in den Android-Einstellungen, um die PWA zu beenden.

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

Verweise