拡張機能のマニフェスト ファイル形式
Microsoft Edge のすべての拡張機能には、 manifest.json
という名前の JSON 形式のマニフェスト ファイルがあります。 マニフェスト ファイルは、拡張機能のブループリントです。 マニフェスト ファイルには、次のような情報が含まれています。
- 拡張機能のバージョン番号。
- 拡張機能のタイトル。
- 拡張機能を実行するために必要なアクセス許可。
マニフェスト V2 は非推奨です
新しいコードにはマニフェスト V3 を使用します。 拡張機能の manifest.json
の形式は、マニフェスト V2 からマニフェスト V3 に移行されます。 どちらの形式もここに表示されます。 マニフェスト V2 拡張機能を Manifest V3 に移行するには、「 マニフェスト V2 から V3 への拡張機能の移行」を参照してください。
拡張機能のmanifest.jsonの形式
次のコードは、マニフェスト V3 または V2 パッケージの拡張機能の manifest.json
でサポートされているフィールドを示しています。
各フィールドのリファレンス情報については、「Chrome 拡張機能のマニフェスト ファイル形式>参照」を参照し、フィールドのリンクをクリックします。
{
// 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": [...]
}
manifest.json V3 と V2 の変更点
V3 | V2 |
---|---|
"manifest_version": 3, |
"manifest_version": 2, |
"action": {...}, |
"browser_action": {...}, |
"action": {...}, |
"page_action": {...}, |
削除 | "persistent": false, |
background が含まれている場合は、service_ worker が必要です |
background が含まれている場合、service_ worker は省略可能です |
2 つの異なるキーに分かれています。 "permissions": [...], "host_permissions": [...], |
"permissions": [...], |
関連項目
- マニフェスト V2 から V3 に拡張機能を移行する
- マニフェスト ファイル形式 - Chrome 拡張機能の V3>Reference。
- Chrome 拡張機能>Reference のマニフェスト ファイル形式 (V2)。
注:
このページの一部は、 Google によって 作成および共有され、 クリエイティブ・コモンズ属性 4.0 国際ライセンスに記載されている条件に従って使用される作業に基づく変更です。 元のページはこちらにあります。