browser_specific_settings

Typ Object
Verpflichtend Normalerweise nein (aber 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 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-Unterschlüssel unterstützt folgende Eigenschaften:

id

Die Erweiterungs-ID. Wenn angegeben, darf diese Eigenschaft maximal 80 Zeichen enthalten. Siehe Extensions and the Add-on ID, um zu bestimmen, wann die ID angegeben werden muss.

strict_min_version

Minimale Version von Gecko, 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 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 Version von Gecko, 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 ausgeführt. Standardmäßig "*", was die Überprüfung auf eine maximale Version deaktiviert.

update_url

Ein Link zu einem Erweiterungs-Update-Manifest. Beachten Sie, dass der Link mit "https" beginnen muss. Dieser Schlüssel ist für die Verwaltung von Erweiterungs-Updates durch Sie selbst (d.h. nicht über AMO).

Der gecko_android-Unterschlüssel unterstützt folgende Eigenschaften:

strict_min_version

Minimale Version von Gecko, 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 ausgeführt. Wenn nicht angegeben, wird standardmäßig die durch gecko.strict_min_version bestimmte Version verwendet. "*" ist in diesem Feld nicht zulässig.

strict_max_version

Maximale Version 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 durch gecko.strict_max_version bestimmte Version verwendet.

Siehe die Liste der gültigen Gecko-Versionen.

Um Firefox für Android ohne Angabe eines Versionsbereichs zu unterstützen, muss der gecko_android-Unterschlüssel ein leerer Objekt sein, d.h. "gecko_android": {}. Andernfalls wird die Erweiterung nur in der Desktop-Version von Firefox verfügbar gemacht.

Format der Erweiterungs-ID

Die Erweiterungs-ID muss eines der folgenden Formate haben:

  • GUID
  • Eine Zeichenkette, die wie eine E-Mail-Adresse formatiert ist: extensionname@example.org

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

Beispielsweise:

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

Safari Eigenschaften

Safari speichert seine browserspezifischen Einstellungen im safari-Unterschlüssel, der folgende 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

BCD tables only load in the browser