Formato de archivo de manifiesto para extensiones

  • Artículo

Cada extensión de Microsoft Edge tiene un archivo de manifiesto con formato JSON, denominado manifest.json. El archivo de manifiesto es el plano técnico de la extensión. El archivo de manifiesto incluye información como:

  • Número de versión de la extensión.
  • Título de la extensión.
  • Permisos necesarios para que se ejecute la extensión.

El manifiesto V2 está en desuso

Use Manifiesto V3 para el nuevo código. El formato para manifest.json las extensiones se está moviendo de Manifiesto V2 a Manifiesto V3. Ambos formatos se muestran aquí. Para migrar una extensión de manifiesto V2 al manifiesto V3, consulte Migración de una extensión del manifiesto V2 a V3.

Formato de manifest.json para extensiones

En el código siguiente se muestran los campos admitidos en manifest.json para las extensiones, para un paquete De manifiesto V3 o V2.

Para obtener información de referencia sobre cada campo, vea Formato de archivo de manifiesto en Referencia de extensiones> de Chrome y, a continuación, haga clic en los vínculos de los campos.

{
  // Required
  "manifest_version": 3,
  "name": "My V3 Extension",
  "version": "versionString",

  // Recommended
  "action": {...},
  "default_locale": "en",
  "description": "A plain-text description",
  "icons": {...},

  // Optional
  "action": ...,
  "author": ...,
  "automation": ...,
  "background": {
    // If `background` is included, `service_ worker` is required
    "service_worker": ...
  },
  "chrome_settings_overrides": {...},
  "chrome_url_overrides": {...},
  "commands": {...},
  "content_capabilities": ...,
  "content_scripts": [{...}],
  "content_security_policy": "policyString",
  "converted_from_user_script": ...,
  "current_locale": ...,
  "declarative_net_request": ...,
  "devtools_page": "devtools.html",
  "differential_fingerprint": ...,
  "event_rules": [{...}],
  "externally_connectable": {
    "matches": ["*://*.contoso.com/*"]
  },
  "file_browser_handlers": [...],
  "file_system_provider_capabilities": {
    "configurable": true,
    "multiple_mounts": true,
    "source": "network"
  },
  "homepage_url": "http://path/to/homepage",
  "host_permissions": [...],
  "import": [{"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}],
  "incognito": "spanning, split, or not_allowed",
  "input_components": ...,
  "key": "publicKey",
  "minimum_chrome_version": "versionString",
  "nacl_modules": [...],
  "natively_connectable": ...,
  "oauth2": ...,
  "offline_enabled": true,
  "omnibox": {
    "keyword": "aString"
  },
  "optional_permissions": ["tabs"],
  "options_page": "options.html",
  "options_ui": {
    "chrome_style": true,
    "page": "options.html"
  },
  "permissions": ["..."],
  "platforms": ...,
  "replacement_web_app": ...,
  "requirements": {...},
  "sandbox": [...],
  "short_name": "Short Name",
  "side_panel": {...},
  "storage": {
    "managed_schema": "schema.json"
  },
  "system_indicator": ...,
  "tts_engine": {...},
  "update_url": "http://path/to/updateInfo.xml",
  "version_name": "aString",
  "web_accessible_resources": [...]
}

Cambios en manifest.json V3 frente a V2

V3 V2
"manifest_version": 3, "manifest_version": 2,
"action": {...}, "browser_action": {...},
"action": {...}, "page_action": {...},
eliminado "persistent": false,
Si background se incluye, service_ worker es necesario Si background se incluye, es opcional. service_ worker
Separados en dos claves diferentes: "permissions": [...], "host_permissions": [...], "permissions": [...],

Vea también

Nota:

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por Google y usadas según los términos descritos en la licencia internacional creative Commons Attribution 4.0. La página original se encuentra aquí.

Licencia de Creative Commons Esta obra está licenciada bajo una Licencia Internacional Creative Commons Attribution 4.0.