browser_specific_settings

Type Object
Obligatoire

Habituellement, non (mais voir aussi Quand avez-vous besoin d'un identifiant complémentaire?). Obligatoire avant Firefox 48 (desktop) et Firefox pour Android.

Example
json
"browser_specific_settings": {
  "gecko": {
    "id": "addon@example.com",
    "strict_min_version": "42.0"
  }
}

Description

La clé browser_specific_settings contient des clés qui sont spécifiques à certaines applications hôtes.

Propriétés (Gecko) Firefox

Actuellement, elle contient uniquement une clé, gecko, qui est structurée ainsi :

  • id est l'ID de l'extension. Facultatif à partir de Firefox 48, obligatoire avant Firefox 48. Voir les WebExtensions et l'ID des extensions pour voir quand vous devez spécifier un identifiant complémentaire.
  • strict_min_version : la version minimum de Gecko supportée. Les versions contenant un "*" ne sont pas valides dans ce domaine. Par défaut, c'est "42a1".
  • strict_max_version : la version maximum de Gecko supportée. Si la version de Firefox sur laquelle l'extension est en cours d'installation ou d'exécution est au-dessus de cette version, l'extension sera désactivée ou ne sera pas autorisée à être installée. Par défaut, c'est "*", qui désactive la vérification d'une version maximale.
  • update_url est lien vers un manifeste de mise à jour personnalisé. Notez que le lien doit commencer par "https". Cette clé consiste à gérer vous-même les mises à jour d'extension (c'est-à-dire pas via AMO).

Vois la liste des versions Gecko valides.

Format d'ID d'extension

L'ID d'extension doit être l'un des suivants :

  • GUID
  • Une chaîne formatée comme une adresse e-mail : extensionname@example.org

Ce dernier format est plus facile à générer et à manipuler. Sachez que l'utilisation d'une véritable adresse e-mail ici peut attirer des spams.

Par exemple :

json
"id": "extensionname@example.org"
json
"id": "{daf44bf7-a45e-4450-979c-91cf07434c3d}"

Propriétés Microsoft Edge

Attention : L'ajout de propriétés spécifiques à Edge au manifeste a causé une erreur avant Firefox 69 qui peut empêcher l'extension de s'installer.

Microsoft Edge stocke les paramètres spécifiques à son navigateur dans la sous-clé edge, qui possède les propriétés suivantes :

browser_action_next_to_addressbar

Propriété booléenne qui contrôle le placement de l'action du navigateur.

Exemples

Exemple avec toutes les clés possibles. Notez que vous n'incluez normalement ni une version strict_max_version ni une clé update_url.

json
"browser_specific_settings": {
  "gecko": {
    "id": "addon@example.com",
    "strict_min_version": "42.0",
    "strict_max_version": "50.*",
    "update_url": "https://example.com/updates.json"
  },
  "edge": {
    "browser_action_next_to_addressbar": true
  }
}

Compatibilité des navigateurs

BCD tables only load in the browser