Das Manifestmitgliedid wird verwendet, um eine eindeutige Kennung für Ihre Webanwendung anzugeben.

Syntax

/* Absolute URL */"id": "https://example.com/myapp"/* Relative URL */"id": "myapp/v2"/* URL with query parameters */"id": "myapp?version=2&mode=trial"

Werte

id

Ein String, der die Form einer URL annimmt.Die URL muss denselben Ursprung wie diestart_url Ihrer Webanwendung haben.Wennid eine relative URL ist, wird sie unter Verwendung des Ursprungs vonstart_url aufgelöst. Jegliches Fragment in derid wird immer ignoriert.Wennid nicht angegeben wird oder der Wert in irgendeiner Weise ungültig ist (z. B. nicht ein String, keine gültige URL, nicht denselben Ursprung wiestart_url), wird der Wert vonstart_url verwendet.

Beschreibung

Das Manifestmitgliedid dient als eindeutige Kennung für Ihre Webanwendung. Es erlaubt Browsern, zwischen verschiedenen Anwendungen zu unterscheiden:

• Wenn ein Browser auf ein App-Manifest mit einerid trifft, die nicht einer bereits installierten Anwendung entspricht, behandelt er dieses Manifest als Beschreibung einer eigenständigen Anwendung, selbst wenn es von derselben URL wie eine andere Anwendung bereitgestellt wird.
• Wenn ein Browser auf ein App-Manifest mit einerid trifft, die mit der Identität einer bereits installierten Anwendung übereinstimmt, behandelt er das neue Manifest als Ersatz für das bestehende Manifest der App, selbst wenn die App von einer anderen URL als der zuvor installierten bereitgestellt wird.

Dieid kann auch von Diensten verwendet werden, die Sammlungen von Web-Apps führen, um Anwendungen eindeutig zu identifizieren.

Nutzungshinweise

Einige wichtige Punkte, die bei der Verwendung desid Mitglieds zu beachten sind:

• Es wird als empfohlene Praxis angesehen, ein führendes/ zu verwenden, um anzugeben, dassid ein root-relativer URL-Pfad ist.
• Daid relativ zum Ursprung derstart_url aufgelöst wird, führenid Werte wie../foo,foo,/foo und./foo alle zur gleichen Kennung relativ zum Ursprung. Zum Beispiel, wennstart_urlhttps://example.com/app/ ist, werden all dieseid Werte zuhttps://example.com/foo/ aufgelöst.
• Standardregeln zur URL-Codierung und -Decodierung gelten beim Auflösen desid Werts.
• Fragmente in derid werden während der Verarbeitung entfernt. Zum Beispiel, wennid auffoo#bar gesetzt ist, wird sie alsfoo aufgelöst. Ebenso, wennid nicht definiert ist undstart_urlhttps://example.com/app/#home ist, wirdid zuhttps://example.com/app/ aufgelöst.
• Abfrageparameter in derid werden beibehalten und in die endgültige aufgelöste Kennung eingeschlossen.

Verständnis derid Auflösung

Angenommen, diestart_url für Ihre App isthttps://example.com/my-app/home. Die folgende Tabelle zeigt, wie verschiedeneid Werte im Manifest aufgelöst werden:

Beispiele

Erstellung einer eigenständigen App-Version

Angenommen, Sie erstellen eine Webanwendung mit folgendem Manifest:

{  "name": "My Weather Application",  "id": "https://example.com/weatherapp/v1",  "start_url": "https://example.com/app"}

Wenn Sie später eine andere Version dieser App mit erheblichen Änderungen erstellen und möchten, dass sie als eine andere App behandelt wird, können Sie das Manifest wie folgt hinzufügen:

{  "name": "My Weather Application",  "id": "https://example.com/weatherapp/v2",  "start_url": "https://example.com/app"}

In diesem Fall werden die neuen Manifestdateien von den Browsern als Beschreibung einer eigenständigen Anwendung behandelt, da dieids unterschiedlich sind. Dadurch können Benutzer beide Versionen gleichzeitig installiert haben.

Aktualisierung einer bestehenden App

Betrachten Sie ein Szenario, in dem Sie eine Webanwendung mit folgendem Manifest bereitstellen:

{  "name": "My Weather Application",  "id": "https://example.com/weatherapp/",  "start_url": "https://example.com/old-app"}

Entscheiden Sie sich später, die App auf einen anderen Pfad zu verschieben, aktualisieren Sie das Manifest wie folgt:

{  "name": "My Weather Application",  "id": "https://example.com/weatherapp/",  "start_url": "https://example.com/new-app"}

Browser werden dieses neue Manifest als Aktualisierung der bestehenden App behandeln, da dieid Werte übereinstimmen. In diesem Fall erhalten Benutzer ein Update ihrer bestehenden App, anstatt zur Installation einer neuen App aufgefordert zu werden.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• scope Manifestmitglied
• start_url Manifestmitglied