aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/mozilla/add-ons/webextensions/manifest.json/browser_specific_settings/index.html
blob: 5d200de3bddd596ab6bb6a958e59f9b49e3bfe91 (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
---
title: applications
slug: Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings
tags:
  - 插件
  - 附加组件
translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings
---
<div>{{AddonSidebar}}</div>

<div class="note">
<p>注意这个key不被Blink-based浏览器(Google Chrome和Opera)支持。如果你在插件中包含了这个key,当在这些浏览器中调用时虽然能用但是会显示警告。</p>
</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>通常不做强制性要求(详细参见<a href="https://developer.mozilla.org/en-US/Add-ons/WebExtensions/WebExtensions_and_the_Add-on_ID#When_do_you_need_an_Add-on_ID">When do you need an Add-on ID</a><a href="https://developer.mozilla.org/en-US/Add-ons/WebExtensions/manifest.json/applications#When_do_I_need_the_applications_key">?</a>)。在Firefox 48版本之前为强制要求。</td>
  </tr>
  <tr>
   <th scope="row">示例</th>
   <td>
    <pre class="brush: json">
"applications": {
  "gecko": {
    "id": "addon@example.com",
    "strict_min_version": "42.0"
  }
}</pre>
   </td>
  </tr>
 </tbody>
</table>

<p><code>applications</code> key包含特定于主机应用程序的键。</p>

<p>目前只包含了一个key:<code>gecko</code>,其中包含了4个attributes:</p>

<ul>
 <li><code>id</code><a href="https://developer.mozilla.org/zh-CN/Add-ons/Install_Manifests#id">extension ID</a>。从Firefox 48起为可选项,在此之前为强制必须项。参看<a href="/zh-CN/docs/Mozilla/Add-ons/WebExtensions/WebExtensions_and_the_Add-on_ID">WebExtensions and the Add-on ID</a>来确认何时需要定义附加组件ID。</li>
 <li><code>strict_min_version</code>: Gecko所能支持的最小版本号。不允许使用"*"来定义版本号。默认值为 "42a1"。{{gecko_minversion_inline("45")}}</li>
 <li><code>strict_max_version</code>: Gecko所能支持的最大版本号。如果安装或运行附加组件的Firefox版本号高于这个最大版本号,附加组件将不能运行或不允许被安装。默认值为"*",意思为不对最大版本号做检查。{{gecko_minversion_inline("45")}}</li>
 <li><code>update_url</code>为链接到<a href="/zh-CN/Add-ons/Updates">add-on update manifest</a>的链接。注意链接必须以"https"开头。这是为了使你自己就能够管理附加组件的更新(如不通过AMO)。{{gecko_minversion_inline("45")}}</li>
</ul>

<h2 id="Chrome不兼容性">Chrome不兼容性</h2>

<p>你不能在Chrome附加组件中使用这个key。</p>

<h2 id="示例">示例</h2>

<p>示例中包含了所有可能的key。注意你通常不会包含<code>strict_max_version</code><code>update_url</code>key在大部分附加组件中。</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>