OLD | NEW |
1 <div id="pageData-name" class="pageData">Formats: Manifest Files</div> | 1 <div id="pageData-name" class="pageData">Formats: Manifest Files</div> |
2 <div id="pageData-showTOC" class="pageData">true</div> | 2 <div id="pageData-showTOC" class="pageData">true</div> |
3 | 3 |
4 <p> | 4 <p> |
5 Every extension has a | 5 Every extension has a |
6 <a href="http://www.json.org">JSON</a>-formatted manifest file, | 6 <a href="http://www.json.org">JSON</a>-formatted manifest file, |
7 named <code>manifest.json</code>, | 7 named <code>manifest.json</code>, |
8 that provides important information about the extension. | 8 that provides important information about the extension. |
9 </p> | 9 </p> |
10 | 10 |
11 <h2 id="overview"> Field summary </h2> | 11 <h2 id="overview"> Field summary </h2> |
12 | 12 |
13 <p> | 13 <p> |
14 The following code shows the supported manifest fields, | 14 The following code shows the supported manifest fields, |
15 with links to the page that discusses each field. | 15 with links to the page that discusses each field. |
16 The only fields that are required for every extension | 16 The only fields that are required for every extension |
17 are <b>name</b> and <b>version</b>. | 17 are <b>name</b> and <b>version</b>. |
18 </p> | 18 </p> |
19 | 19 |
20 <pre> | 20 <pre> |
21 { | 21 { |
22 <em>// Required</em> | 22 <em>// Required</em> |
23 "<a href="#name">name</a>": "<em>My Extension</em>", | 23 "<a href="#name">name</a>": "<em>My Extension</em>", |
24 "<a href="#version">version</a>": "<em>versionString</em>", | 24 "<a href="#version">version</a>": "<em>versionString</em>", |
25 | 25 |
26 <em>// Recommended</em> | 26 <em>// Recommended</em> |
27 "<a href="#description">description</a>": "<em>A plain text description</em>", | 27 "<a href="#description">description</a>": "<em>A plain text description</em>", |
28 "<a href="#icons">icons</a>": { ... }, | 28 "<a href="#icons">icons</a>": { ... }, |
| 29 "<a href="#default_locale">default_locale</a>": "en", |
29 | 30 |
30 <em>// Pick one (or none)</em> | 31 <em>// Pick one (or none)</em> |
31 "<a href="browserAction.html">browser_action</a>": {...}, | 32 "<a href="browserAction.html">browser_action</a>": {...}, |
32 "<a href="pageAction.html">page_action</a>": {...}, | 33 "<a href="pageAction.html">page_action</a>": {...}, |
33 "<a href="themes.html">theme</a>": {...}, | 34 "<a href="themes.html">theme</a>": {...}, |
34 | 35 |
35 <em>// Add any of these that you need</em> | 36 <em>// Add any of these that you need</em> |
36 "<a href="background_pages.html">background_page</a>": "<em>aFile</em>.html", | 37 "<a href="background_pages.html">background_page</a>": "<em>aFile</em>.html", |
37 "<a href="override.html">chrome_url_overrides</a>": {...}, | 38 "<a href="override.html">chrome_url_overrides</a>": {...}, |
38 "<a href="content_scripts.html">content_scripts</a>": [...], | 39 "<a href="content_scripts.html">content_scripts</a>": [...], |
(...skipping 56 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
95 If you submit your extension to the | 96 If you submit your extension to the |
96 <a href="https://chrome.google.com/extensions">gallery</a>, | 97 <a href="https://chrome.google.com/extensions">gallery</a>, |
97 you'll need to upload additional images, | 98 you'll need to upload additional images, |
98 including a 32x32-pixel logo | 99 including a 32x32-pixel logo |
99 and at least one screenshot of your extension. | 100 and at least one screenshot of your extension. |
100 For more information on gallery requirements, | 101 For more information on gallery requirements, |
101 see the | 102 see the |
102 <a href="http://www.google.com/support/chrome/bin/answer.py?answer=113909">galle
ry help</a>. | 103 <a href="http://www.google.com/support/chrome/bin/answer.py?answer=113909">galle
ry help</a>. |
103 </p> | 104 </p> |
104 | 105 |
| 106 <h3 id="default_locale">default_locale</h3> |
| 107 |
| 108 <p> |
| 109 Specifies the subdirectory of <code>_locales</code> |
| 110 that contains the default strings for this extension. |
| 111 This field is <b>required</b> in extensions |
| 112 that have a <code>_locales</code> directory; |
| 113 it <b>must be absent</b> in extensions |
| 114 that have no <code>_locales</code> directory. |
| 115 For details, see |
| 116 <a href="i18n.html">Internationalization</a>. |
| 117 </p> |
| 118 |
105 <h3 id="name">name</h3> | 119 <h3 id="name">name</h3> |
106 | 120 |
107 <p> | 121 <p> |
108 A short, plain text string | 122 A short, plain text string |
109 (no more than 45 characters) | 123 (no more than 45 characters) |
110 that identifies the extension. | 124 that identifies the extension. |
111 The name is used in the install dialog, | 125 The name is used in the install dialog, |
112 extension management UI, | 126 extension management UI, |
113 and the <a href="https://chrome.google.com/extensions">extension gallery</a>. | 127 and the <a href="https://chrome.google.com/extensions">extension gallery</a>. |
114 </p> | 128 </p> |
(...skipping 91 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
206 A missing integer is equal to zero. | 220 A missing integer is equal to zero. |
207 For example, 1.1.9.9999 is newer than 1.1. | 221 For example, 1.1.9.9999 is newer than 1.1. |
208 </p> | 222 </p> |
209 | 223 |
210 <p> | 224 <p> |
211 For more information, see | 225 For more information, see |
212 <a href="autoupdate.html">Autoupdating</a>. | 226 <a href="autoupdate.html">Autoupdating</a>. |
213 </p> | 227 </p> |
214 | 228 |
215 <!-- [PENDING: Possibly: point to the gallery and make a big deal of the fact th
at autoupdating is free if you use the gallery.] --> | 229 <!-- [PENDING: Possibly: point to the gallery and make a big deal of the fact th
at autoupdating is free if you use the gallery.] --> |
OLD | NEW |