Installierbar machen

Auf das Ereignis „beforeinstallprompt“ warten

Wenn der Browser das Ereignis beforeinstallprompt auslöst, ist das ein Hinweis darauf, dass die Web-App installiert werden kann und dem Nutzer eine Installationsschaltfläche angezeigt werden kann. Das Ereignis beforeinstallprompt wird ausgelöst, wenn die App die Kriterien für die Installierbarkeit erfüllt.

Durch das Erfassen des Ereignisses können Entwickler die Installation anpassen und den Nutzer auffordern, die Installation zu starten, wenn sie es für den besten Zeitpunkt halten.

  1. Klicken Sie auf Remix erstellen, um zu bearbeiten, um das Projekt bearbeitbar zu machen.
  2. Fügen Sie dem window-Objekt einen beforeinstallprompt-Event-Handler hinzu.
  3. Speichern Sie die event als globale Variable. Sie wird später benötigt, um die Aufforderung anzuzeigen.
  4. Blenden Sie die Schaltfläche „Installieren“ ein.

Code:

window.addEventListener('beforeinstallprompt', (event) => {
  // Prevent the mini-infobar from appearing on mobile.
  event.preventDefault();
  console.log('👍', 'beforeinstallprompt', event);
  // Stash the event so it can be triggered later.
  window.deferredPrompt = event;
  // Remove the 'hidden' class from the install button container.
  divInstall.classList.toggle('hidden', false);
});

Klicken auf die Installationsschaltfläche verarbeiten

Wenn Sie die Installationsaufforderung anzeigen möchten, rufen Sie prompt() für das gespeicherte beforeinstallprompt-Ereignis auf. Der Aufruf von prompt() erfolgt im Klick-Handler des Installations-Buttons, da prompt() über eine Nutzergeste aufgerufen werden muss.

  1. Fügen Sie einen Click-Event-Handler für die Installationsschaltfläche hinzu.
  2. Rufen Sie prompt() für das gespeicherte beforeinstallprompt-Ereignis auf.
  3. Loggen Sie die Ergebnisse des Prompts.
  4. Setzen Sie das gespeicherte beforeinstallprompt-Ereignis auf „null“.
  5. Blenden Sie die Schaltfläche „Installieren“ aus.

Code:

butInstall.addEventListener('click', async () => {
  console.log('👍', 'butInstall-clicked');
  const promptEvent = window.deferredPrompt;
  if (!promptEvent) {
    // The deferred prompt isn't available.
    return;
  }
  // Show the install prompt.
  promptEvent.prompt();
  // Log the result
  const result = await promptEvent.userChoice;
  console.log('👍', 'userChoice', result);
  // Reset the deferred prompt variable, since
  // prompt() can only be called once.
  window.deferredPrompt = null;
  // Hide the install button.
  divInstall.classList.toggle('hidden', true);
});

Installationsereignis erfassen

Die Installation einer Web-App über eine Installationsschaltfläche ist nur eine Möglichkeit, wie Nutzer sie installieren können. Sie können auch das Chrome-Menü, die Mini-Infoleiste und ein Symbol in der Omnibox verwenden. Sie können alle diese Installationsmethoden erfassen, indem Sie auf das Ereignis appinstalled warten.

  1. Fügen Sie dem window-Objekt einen appinstalled-Event-Handler hinzu.
  2. Protokollieren Sie das Installationsereignis in Analytics oder einem anderen Mechanismus.

Code:

window.addEventListener('appinstalled', (event) => {
  console.log('👍', 'appinstalled', event);
  // Clear the deferredPrompt so it can be garbage collected
  window.deferredPrompt = null;
});

Weitere Informationen

Glückwunsch, deine App kann jetzt installiert werden.

Hier sind einige zusätzliche Dinge, die Sie tun können: