aboutsummaryrefslogtreecommitdiff
path: root/files/ja/mozilla/add-ons/webextensions/manifest.json/browser_specific_settings/index.html
blob: 577e491a54996fd40e1ac49b00e96958064467f4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
---
title: browser_specific_settings
slug: Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings
tags:
  - Add-ons
  - Extensions
  - WebExtensions
  - manifest.json
translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings
---
<div>{{AddonSidebar}}</div>

<table class="fullwidth-table standard-table">
 <tbody>
  <tr>
   <th scope="row" style="width: 30%;"></th>
   <td><code>Object</code></td>
  </tr>
  <tr>
   <th scope="row">必須</th>
   <td>
    <p>通常は不要です (<a href="https://developer.mozilla.org/ja/Add-ons/WebExtensions/WebExtensions_and_the_Add-on_ID#When_do_you_need_an_Add-on_ID"> いつ Add-on ID が必要か?</a>を参考に) 。Firefox 48 より前と Android版Firefox では必須です。</p>
   </td>
  </tr>
  <tr>
   <th scope="row"></th>
   <td>
    <pre class="brush: json no-line-numbers  language-json">
<code class="language-json"><span class="key token">"browser_specific_settings":</span> <span class="punctuation token">{</span>
  <span class="key token">"gecko":</span> <span class="punctuation token">{</span>
    <span class="key token">"id":</span> <span class="string token">"addon@example.com"</span><span class="punctuation token">,</span>
    <span class="key token">"strict_min_version":</span> <span class="string token">"42.0"</span>
  <span class="punctuation token">}</span>
<span class="punctuation token">}</span></code></pre>
   </td>
  </tr>
 </tbody>
</table>

<h2 id="Description" name="Description">説明</h2>

<p><code>browser_specific_settings</code> キーは、特定のホストアプリケーションのキーを含みます。</p>

<h3 id="Firefox_(Gecko)_プロパティ">Firefox (Gecko) プロパティ</h3>

<p>現在、4 つの文字列属性を含む <code>gecko</code> キーのみが存在します。</p>

<ul>
 <li><code>id</code><a href="https://developer.mozilla.org/ja/Add-ons/Install_Manifests#id">拡張機能ID</a> です。Firefox 48 からオプションですが、Firefox 48 より前では必須です。いつ特定の add-on ID が必要になるかについては、<a href="/ja/docs/Mozilla/Add-ons/WebExtensions/WebExtensions_and_the_Add-on_ID">拡張機能と Add-on ID</a> を見てください。</li>
 <li><code>strict_min_version</code>: サポートする Gecko の最小バージョンです。"*" を含むバージョンは、このフィールドでは無効です。既定は "42a1" です。</li>
 <li><code>strict_max_version</code>: サポートする Gecko の最大バージョンです。拡張機能がこのバージョンを超えた Firefox のバージョンにインストールや実行された場合、拡張機能は無効または、インストールが許可されません。既定は "*" で、最大バージョンのチェックは無効です。</li>
 <li><code>update_url</code><a href="/ja/Add-ons/Updates">add-on update manifest</a> へのリンクです。リンクは "https" で始まっている必要があることに注意してください。このキーは拡張機能が自分自身で更新を管理するためのものです(つまり AMO以外で)。</li>
</ul>

<p><a href="https://addons.mozilla.org/en-US/firefox/pages/appversions/">有効な Gecko バージョン</a>のリストを見てください。</p>

<h3 id="Extension_ID_format" name="Extension_ID_format">拡張機能 ID フォーマット</h3>

<p>拡張機能 ID は次のどれかでなければなりません:</p>

<ul>
 <li><a href="https://en.wikipedia.org/wiki/Universally_unique_identifier" title="Generating_GUIDs">GUID</a></li>
 <li>メールアドレスのような文字列フォーマット: <code class="plain">extensionname@example.org</code></li>
</ul>

<p>後者のフォーマットは生成したり扱うのが簡単です。本当のメールアドレスをここで使うと SPAM を呼びかねないのに気を払ってください。</p>

<p>例えば:</p>

<pre class="brush:json;auto-links:false no-line-numbers  language-json"><code class="language-json"><span class="key token">"id":</span> <span class="string token">"extensionname@example.org"</span><span class="punctuation token">,</span>

<span class="key token">"id":</span> <span class="string token">"{daf44bf7-a45e-4450-979c-91cf07434c3d}"</span></code></pre>

<h2 id="Examples" name="Examples"></h2>

<p>使用可能なキーをすべて使用した例です。たいていの拡張機能では <code>strict_max_version</code><code>update_url</code> は省略するのに注意してください。</p>

<pre class="brush: json">"applications": {
  "gecko": {
    "id": "addon@example.com",
    "strict_min_version": "42.0",
    "strict_max_version": "50.*",
    "update_url": "https://example.com/updates.json"
  }
}</pre>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ実装状況</h2>

<p>{{Compat("webextensions.manifest.browser_specific_settings")}}</p>