browser_specific_settings

Typ Object
Verpflichtend In der Regel nein (aber siehe auch Wann brauchen 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 Hostanwendung sind.

Firefox (Gecko)-Eigenschaften

Firefox speichert browserspezifische Einstellungen in diesen Unter-Schlüsseln:

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

Der gecko Unter-Schlüssel unterstützt diese Eigenschaften:

id

Die Erweiterungs-ID. Wenn angegeben, darf diese Eigenschaft höchstens 80 Zeichen enthalten. Siehe Erweiterungen und die Add-on-ID, um festzustellen, wann die ID angegeben werden muss.

strict_min_version

Minimale Gecko-Version, die unterstützt wird. Wenn die Firefox-Version, auf der die Erweiterung installiert oder ausgeführt wird, unter dieser Version liegt, wird die Erweiterung nicht installiert oder nicht 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

Maximale Gecko-Version, die 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 nicht ausgeführt. Standardmäßig ist "*", was die Prüfung einer maximalen Version deaktiviert.

update_url

Ein Link zu einer Erweiterungsaktualisierungsdatei. Beachten Sie, dass der Link mit "https" beginnen muss. Dieser Schlüssel ist für die Verwaltung von Erweiterungsupdates selbst gedacht (d.h. nicht über AMO).

Der gecko_android Unter-Schlüssel unterstützt diese Eigenschaften:

strict_min_version

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

strict_max_version

Maximale Gecko-Version, 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 nicht ausgeführt. Standardmäßig wird die durch gecko.strict_max_version bestimmte Version verwendet.

Siehe die Liste der gültigen Gecko-Versionen.

Um Firefox für Android zu unterstützen, ohne einen Versionsbereich anzugeben, muss der gecko_android Unter-Schlüssel ein leeres Objekt sein, d.h. "gecko_android": {}. Andernfalls wird die Erweiterung nur auf dem Desktop Firefox verfügbar gemacht.

Erweiterungs-ID-Format

Die Erweiterungs-ID muss eine der folgenden sein:

  • GUID
  • Ein String im E-Mail-Adressformat: extensionname@example.org

Das letztere Format ist leichter zu erstellen und zu handhaben. Beachten Sie, dass die Verwendung einer echten E-Mail-Adresse hier Spam anziehen könnte.

Zum Beispiel:

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

Safari-Eigenschaften

Safari speichert seine browserspezifischen Einstellungen im safari Unter-Schlüssel, der diese Eigenschaften hat:

strict_min_version

Minimale Version von Safari, die unterstützt wird.

strict_max_version

Maximale Version von Safari, die unterstützt wird.

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