Umgang mit Updates am Manifest der Web-App in Chrome

Voraussetzungen zum Ändern von Symbolen, Verknüpfungen, Farben und anderen Metadaten für Ihre PWA

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

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

In den meisten Fällen sind Änderungen innerhalb von ein bis zwei Tagen PWA wird gestartet, nachdem das Manifest aktualisiert wurde.

Updates für Chrome auf dem Computer

Wenn die PWA gestartet oder in einem Browsertab geöffnet wird, ermittelt Chrome, das letzte Mal, dass das lokale Manifest auf Änderungen überprüft wurde. Wenn im Manifest nicht seit dem letzten Browserstart oder im 24 Stunden zurückliegt, sendet Chrome eine Netzwerkanfrage für das Manifest. mit der lokalen Kopie vergleichen.

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

Welche Unterkünfte 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 du den Anzeigemodus deiner App von browser zu standalone aktualisierst, Bei bestehenden Nutzern werden ihre Apps nach dem Update nicht in einem Fenster geöffnet. Es sind zwei Anzeigeeinstellungen für eine Web-App, die aus dem Manifest, Steuerung) und eine Einstellung für den Fenster-/Browser-Tab, die vom Nutzer gesteuert wird. Der Nutzer immer respektiert.

Manifest-Updates testen

Die Seite chrome://web-app-internals (verfügbar in Chrome 85 oder höher) detaillierte Informationen zu allen auf dem Gerät installierten PWAs enthält, Außerdem erfahren Sie, wann das Manifest zuletzt aktualisiert wurde, aktualisiert wird und vieles mehr.

Um Chrome manuell zu einer Prüfung auf ein aktualisiertes Manifest zu zwingen, können Sie entweder Chrome mit dem Befehlszeilen-Flag --disable-manifest-update-throttle oder Chrome neu starten (about://restart verwenden), wird der Timer zurückgesetzt, sodass Chrome sucht beim nächsten Start der PWA nach einem aktualisierten Manifest. Dann starten der PWA. Nach dem Schließen der PWA sollte sie mit dem neuen Manifest aktualisiert werden Eigenschaften.

Verweise

Updates bei Chrome für Android

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

Wenn sich bestimmte Eigenschaften im Manifest geändert haben (siehe Liste unten), wird Chrome stellt 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. Nach der Aktualisierung werden alle Felder des neuen Manifests aktualisiert. verwendet.

Welche Unterkünfte 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, Überprüfungszeit auf 30 Tage erhöhen.

Manifest-Updates testen

Die Seite about://webapks enthält detaillierte Informationen zu allen PWAs, die auf dem Gerät installiert sind, können angeben, wann das Manifest zuletzt verwendet wurde und wie oft er aktualisiert wird.

Wenn Sie die Aktualisierung des Manifests manuell planen möchten, überschreiben Sie den Timer und lokalen Manifest-Datei Folgendes tun:

  1. Schließen Sie das Gerät an die Stromversorgung an und prüfen Sie, ob es mit dem WLAN verbunden ist.
  2. Beenden Sie die PWA über den Android-Task-Manager und verwenden Sie dann das App-Steuerfeld in den Android-Einstellungen, um das Beenden der PWA zu erzwingen.
  3. Öffne in Chrome about://webapks und klicke auf die Schaltfläche „Aktualisieren“ Schaltfläche für die PWA. „Aktualisierungsstatus“ sollte sich in „Ausstehend“ ändern.
  4. Starten Sie die PWA und prüfen Sie, ob sie korrekt geladen wurde.
  5. Beenden Sie die PWA über den Android-Task-Manager und verwenden Sie dann das App-Steuerfeld in den Android-Einstellungen, um das Beenden der PWA zu erzwingen.

Die PWA wird in der Regel innerhalb weniger Minuten nach Abschluss des Updates aktualisiert. „Aktualisierungsstatus“ sollte sich in „Erfolgreich“ ändern

Verweise