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
|
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:
"id": "extensionname@example.org"
"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.
"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"
}
}