browser_specific_settings

Typ Object
Verpflichtend Normalerweise nein (siehe auch Wann benötigen Sie eine Add-on-ID?). Verpflichtend, wenn die Erweiterungs-ID nicht bestimmt werden kann, siehe browser_specific_settings.gecko.id.
Beispiel
json
"browser_specific_settings": {
  "gecko": {
    "id": "addon@example.com",
    "strict_min_version": "58.0"
  }
}

Beschreibung

Der Schlüssel browser_specific_settings enthält Schlüssel, die spezifisch für eine bestimmte Host-Anwendung sind.

Firefox (Gecko) Eigenschaften

Firefox speichert browserspezifische Einstellungen in diesen Unterschlüsseln:

  • gecko für die Desktop-Version von Firefox.
  • gecko_android für die Android-Version von Firefox.

Der Unterschlüssel gecko unterstützt folgende Eigenschaften:

id

Die Erweiterungs-ID. Wenn angegeben, darf diese Eigenschaft nicht mehr als 80 Zeichen enthalten. Siehe Extensions and the Add-on ID, um festzustellen, wann die ID angegeben werden muss.

strict_min_version

Mindestversion von Gecko zur Unterstützung. Wenn die Firefox-Version, auf der die Erweiterung installiert oder ausgeführt wird, unter dieser Version liegt, wird die Erweiterung nicht installiert oder ausgeführt. Wenn nicht angegeben, werden alle Versionen früher als strict_max_version unterstützt. "*" ist in diesem Feld nicht zulässig.

strict_max_version

Höchstversion von Gecko zur Unterstützung. Wenn die Firefox-Version, auf der die Erweiterung installiert oder ausgeführt wird, über dieser Version liegt, wird die Erweiterung nicht installiert oder ausgeführt. Standardmäßig "*", was die Prüfung auf eine Höchstversion deaktiviert.

update_url

Ein Link zu einem Erweiterungs-Update-Manifest. Beachten Sie, dass der Link mit "https" beginnen muss. Dieser Schlüssel dient zur eigenständigen Verwaltung von Erweiterungs-Updates (d.h. nicht über AMO).

Der Unterschlüssel gecko_android unterstützt folgende Eigenschaften:

strict_min_version

Mindestversion von Gecko, die auf Android unterstützt wird. Wenn die Version von Firefox für Android, auf der die Erweiterung installiert oder ausgeführt wird, unter dieser Version liegt, wird die Erweiterung nicht installiert oder ausgeführt. Wenn nicht angegeben, wird standardmäßig die Version bestimmt durch gecko.strict_min_version. "*" ist in diesem Feld nicht zulässig.

strict_max_version

Höchstversion von Gecko, die auf Android unterstützt wird. Wenn die Firefox-Version, auf der die Erweiterung installiert oder ausgeführt wird, über dieser Version liegt, wird die Erweiterung nicht installiert oder ausgeführt. Standardmäßig wird die Version bestimmt durch gecko.strict_max_version.

Siehe die Liste der gültigen Gecko-Versionen.

Um Firefox für Android zu unterstützen, ohne einen Versionsbereich anzugeben, muss der Unterschlüssel gecko_android ein leeres Objekt sein, z. B. "gecko_android": {}. Andernfalls ist die Erweiterung nur auf dem Desktop-Firefox verfügbar.

Format der Erweiterungs-ID

Die Erweiterungs-ID muss eine der folgenden sein:

  • GUID
  • Eine Zeichenfolge im Format einer E-Mail-Adresse: extensionname@example.org

Letzteres Format ist einfacher zu erstellen und zu bearbeiten. Beachten Sie, dass die Verwendung einer realen E-Mail-Adresse hier Spam anziehen kann.

Zum Beispiel:

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

Safari Eigenschaften

Safari speichert seine browserspezifischen Einstellungen im Unterschlüssel safari, der folgende Eigenschaften hat:

strict_min_version

Mindestversion von Safari zur Unterstützung.

strict_max_version

Höchstversion von Safari zur Unterstützung.

Beispiele

Beispiel mit allen möglichen Schlüsseln. Beachten Sie, dass die meisten Erweiterungen strict_max_version und update_url weglassen.

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"
  },
  "safari": {
    "strict_min_version": "14",
    "strict_max_version": "20"
  }
}

Browser-Kompatibilität