Compartilhar via

Formato de ficheiro de manifesto para extensões

  • Artigo

Cada extensão do Microsoft Edge tem um ficheiro de manifesto formatado em JSON, com o nome manifest.json. O ficheiro de manifesto é o esquema da sua extensão. O ficheiro de manifesto inclui informações como:

  • O número da versão da extensão.
  • O título da extensão.
  • As permissões necessárias para que a extensão seja executada.

O manifesto V2 foi preterido

Utilize o Manifesto V3 para o novo código. O formato para manifest.json as extensões está a passar do Manifesto V2 para o Manifesto V3. Ambos os formatos são apresentados aqui. Para migrar uma extensão do Manifesto V2 para o Manifesto V3, veja Migrar uma extensão do Manifesto V2 para o V3.

Formato do manifest.json para extensões

O código seguinte mostra os campos suportados em manifest.json para extensões, para um pacote V3 ou V2 do Manifesto.

Para obter informações de referência sobre cada campo, consulte Formato de ficheiro de manifesto naReferênciade Extensões> do Chrome e, em seguida, clique nas ligações nos 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": [...]
}

Alterações no manifest.json V3 vs. V2

V3 V2
"manifest_version": 3, "manifest_version": 2,
"action": {...}, "browser_action": {...},
"action": {...}, "page_action": {...},
removidas "persistent": false,
Se background estiver incluído, service_ worker é necessário Se background estiver incluído, service_ worker é opcional
Separados em duas teclas diferentes: "permissions": [...], "host_permissions": [...], "permissions": [...],

Confira também

Observação

Partes desta página são modificações baseadas no trabalho criado e partilhado pela Google e utilizado de acordo com os termos descritos na Licença Internacional Creative Commons Attribution 4.0. A página original encontra-se aqui.

Licença Creative Commons Este trabalho é licenciado ao abrigo de uma Licença Internacional creative Commons Attribution 4.0.