FAQ zur Einstellung der Inline-Installation

Seit dem 12.06.2018 ist die Inline-Installation veraltet. Weitere Informationen finden Sie in unserem Chromium-Blogpost.

Fragen zum Zeitplan

Was ändert sich am 12.06.2018?

Die Inline-Installation ist für alle Chrome Web Store-Elemente deaktiviert, z. B. Erweiterungen und Apps, die am oder nach dem 12.06.2018 veröffentlicht wurden. „Deaktiviert“ bedeutet, dass Inline-Installationsversuchen automatisch zur Detailseite des Artikels im Chrome Web Store weitergeleitet werden, wo der Nutzer die Installation abschließen kann. Für bereits im Store vorhandene Artikel, die vor diesem Datum erstmals veröffentlicht wurden, ändert sich nichts.

Was ändert sich am 12.09.2018?

Die Deaktivierung gilt für ALLE Elemente, unabhängig vom Veröffentlichungsdatum. 100% der Inline-Installationsversuche für alle Artikel werden zum Chrome Web Store weitergeleitet, wo Nutzer die Installation abschließen können.

Was muss ich vor dem 12.09.2018 tun?

Sie müssen nichts ändern. Wir empfehlen Ihnen jedoch, den Installationsablauf zu prüfen und den chrome.webstore.install()-Aufruf durch eine direkte Navigation zum Chrome Web Store-Eintrag Ihres Artikels zu ersetzen. So können Sie überprüfen, ob die Website optimal genutzt werden kann.

Wir empfehlen außerdem, das neue Chrome Web Store-Downloadlogo in den Installationsablauf auf deiner Website aufzunehmen.

Was ändert sich in M71 (Dezember 2018)?

Ab M71 wird die Methode chrome.webstore.install() in Chrome nicht mehr unterstützt. Ein Aufruf dieser Methode wird daher fehlschlagen, was zu einem fehlerhaften Installationsvorgang auf Ihrer Website führt. An dieser Stelle wird durch API-Aufrufe ein JavaScript TypeError ausgelöst. Sie sollten vor diesem Datum alle Aufrufe der API-Methode entfernen.

Nach Deaktivierung der Inline-Installation

Wie sieht der Installationsablauf aus?

Wenn Ihre Website chrome.webstore.install() aufruft, löst Chrome nicht mehr sofort ein Dialogfeld aus, sondern öffnet stattdessen einen neuen Tab im Vordergrund mit der Detailseite des Chrome Web Store (z. B. https://chrome.google.com/webstore/detail/EXTENSION_ID). Von dort kann der Nutzer die Standardinstallation durchführen, indem er auf „Installieren“ klickt. In einem Dialogfeld wird er dann aufgefordert, die Berechtigungen zu lesen und die App zu installieren oder abzubrechen. Nach dem Schließen des Dialogfelds verbleibt der Tab im Chrome Web Store.

Woher weiß ich, ob die Installation erfolgreich war?

Wenn Sie chrome.webstore.install() aufrufen, wird „failCallback“ mit der Fehlermeldung ausgelöst, dass der Nutzer zum Chrome Web Store weitergeleitet wurde. Es zeigt nicht an, ob die Installation erfolgreich war oder nicht. Ab Chrome 71 schlagen Aufrufe von chrome.webstore.install() fehl, sodass „failedCallback“ nie ausgeführt wird.

Ohne diese API kann Ihre Website trotzdem erkennen, ob Ihr Artikel bereits installiert ist, indem die Erweiterung mit Ihrer Website kommuniziert. Dies kann über Erweiterungsnachrichten und die Eigenschaft externally_connectable im Manifest erfolgen.

"externally_connectable": {
  "matches": ["https://www.example.com/*"]
}
// JS running on https://example.com
try {
  chrome.runtime.sendMessage('EXTENSION_ID', MESSAGE, function() {
    if (chrome.runtime.lastError) {
      // Extension is not installed.
    }
  });
} catch (e) {
  // Extension is not installed.
}

Ersetzen Sie Folgendes:

  • EXTENSION_ID: Die ID Ihrer Erweiterung.
  • MESSAGE: Nachrichtenstring oder -objekt, das an die Erweiterung gesendet werden soll

Wie kann ich nach der Installation eine Informationsseite anzeigen lassen?

Verwenden Sie das Ereignis chrome.runtime und öffnen Sie nach der Installation einen neuen Tab. Hier ist ein Beispiel für Ihre Hintergrundseite:

chrome.runtime.onInstalled.addListener(function listener(details) {
  if (details.reason === chrome.runtime.OnInstalledReason.INSTALL) {
    chrome.tabs.create({url: "https://www.example.com/"});
    chrome.runtime.onInstalled.removeListener(listener);
  }
});

Kann ich eine Ausnahme beantragen?

Nein. Diese Richtlinienänderung gilt ausnahmslos für alle Artikel im Chrome Web Store.