Questions fréquentes sur la migration après l'abandon des installations intégrées

Depuis le 12/06/2018, l'installation intégrée est obsolète. Pour en savoir plus, consultez notre blog Chromium post.

Questions sur l'historique de vos trajets

Qu'est-ce qui va changer le 12/06/2018 ?

Les articles du Chrome Web Store (extensions et applications, par exemple) publiés pour la première fois à partir du 12 juin 2018 sur lesquels l'installation intégrée est désactivée. "Désactivé" les tentatives d'installation intégrées automatiquement redirigé vers la page d'informations de l'article sur le Chrome Web Store, où l'utilisateur peut terminer l'installation. Rien ne changera pour les premiers articles de la boutique publiées avant cette date.

Qu'est-ce qui va changer le 12/09/2018 ?

La désactivation s'appliquera à TOUS les éléments, quelle que soit la date de publication. 100% de l'installation intégrée tentatives pour tous les éléments sont redirigés vers le Chrome Web Store, où les utilisateurs peuvent effectuer la l'installation.

Que dois-je faire avant le 12/09/2018 ?

Aucune modification n'est nécessaire, mais nous vous conseillons de vérifier le processus d'installation et de remplacer Appel chrome.webstore.install() avec navigation directement vers la fiche Chrome Web Store de votre article. Vous pouvez ainsi vérifier que la qualité de l'expérience utilisateur est optimale.

Nous vous recommandons également d'intégrer le nouveau badge de téléchargement du Chrome Web Store à votre le flux d'installation sur votre site.

Qu'est-ce qui va changer dans M71 (décembre 2018) ?

À partir de M71, Chrome n'acceptera plus la méthode chrome.webstore.install() ni les appels il échouera, ce qui entraînera un flux d'installation interrompu sur votre site. À ce stade, les appels à l'API génère une erreur de type JavaScript. Vous devez supprimer tous les appels à la méthode API avant cette date.

Après la désactivation de l'installation intégrée

Comment se déroulera le processus d'installation ?

Lorsque votre site appelle chrome.webstore.install(), Chrome ne déclenche plus de boîte de dialogue immédiatement mais un nouvel onglet au premier plan s'ouvre et affiche la page d'informations du Chrome Web Store (par exemple, https://chrome.google.com/webstore/detail/EXTENSION_ID). L'utilisateur peut alors passer par d'installation standard en cliquant sur "Installer". Une boîte de dialogue s'affiche alors pour inviter l'utilisateur à lire les autorisations et l’installation ou l’annulation. Une fois la boîte de dialogue fermée, l'onglet reste dans Chrome Web Store.

Comment savoir si l'installation a réussi ?

Lorsque vous appelez chrome.webstore.install(), échecCallback est déclenché avec une erreur indiquant que l'utilisateur a été redirigé vers le Chrome Web Store. Il n'indique pas si le l'installation a réussi ou non. N'oubliez pas qu'à partir de Chrome 71, les appels vers chrome.webstore.install() échouera. Le rappel échecCallback ne sera donc jamais exécuté.

Sans cette API, votre site peut toujours détecter si votre article est déjà installé en communiquant entre l'extension et votre site Web. Pour cela, utilisez les messages d'extension externally_connectable dans le fichier manifeste.

"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.
}

Remplacez les éléments suivants :

  • EXTENSION_ID: ID de votre extension.
  • MESSAGE: chaîne ou objet de message à envoyer à l'extension.

Comment afficher une page d'informations après l'installation ?

Utilisez l'événement chrome.runtime et ouvrez un nouvel onglet après l'installation. Voici un exemple à utiliser dans votre page en arrière-plan:

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);
  }
});

Puis-je bénéficier d'une exception ?

Non. Cette modification des règles s'applique à tous les articles du Chrome Web Store, sans exception.