| OLD | NEW |
| 1 <h1>Manifest Version</h1> | 1 <h1>Manifest Version</h1> |
| 2 | 2 |
| 3 <style type="text/css"> | 3 <style type="text/css"> |
| 4 #schedule h3 { | 4 #schedule h3 { |
| 5 margin-bottom:0; | 5 margin-bottom:0; |
| 6 } | 6 } |
| 7 | 7 |
| 8 #schedule p { | 8 #schedule p { |
| 9 margin-top:0; | 9 margin-top:0; |
| 10 margin-bottom:1em; | 10 margin-bottom:1em; |
| 11 } | 11 } |
| 12 </style> | 12 </style> |
| 13 | 13 |
| 14 <p> | 14 <p> |
| 15 Extensions, themes, and applications are simply bundles of resources, wrapped | 15 Extensions, themes, and applications are simply bundles of resources, wrapped |
| 16 up with a <a href="manifest.html"><code>manifest.json</code></a> file that | 16 up with a <a href="manifest"><code>manifest.json</code></a> file that |
| 17 describes the package's contents. The format of this file is generally stable, | 17 describes the package's contents. The format of this file is generally stable, |
| 18 but occasionally breaking changes must be made to address important issues. | 18 but occasionally breaking changes must be made to address important issues. |
| 19 Developers should specify which version of the manifest specification their | 19 Developers should specify which version of the manifest specification their |
| 20 package targets by setting a <code>manifest_version</code> key in their | 20 package targets by setting a <code>manifest_version</code> key in their |
| 21 manifests. | 21 manifests. |
| 22 </p> | 22 </p> |
| 23 | 23 |
| 24 <h2 id="current-version">Current Version</h2> | 24 <h2 id="current-version">Current Version</h2> |
| 25 | 25 |
| 26 <p> | 26 <p> |
| (...skipping 59 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 86 </div> | 86 </div> |
| 87 | 87 |
| 88 <h2 id="manifest-v1-changes">Changes between version 1 and 2</h2> | 88 <h2 id="manifest-v1-changes">Changes between version 1 and 2</h2> |
| 89 | 89 |
| 90 <ul> | 90 <ul> |
| 91 <li> | 91 <li> |
| 92 <p> | 92 <p> |
| 93 A content security policy is set to <code>`script-src 'self' | 93 A content security policy is set to <code>`script-src 'self' |
| 94 chrome-extension-resource:; object-src 'self'</code> by default. This has | 94 chrome-extension-resource:; object-src 'self'</code> by default. This has |
| 95 a variety of impacts on developers, described at length in the | 95 a variety of impacts on developers, described at length in the |
| 96 <a href="../extensions/contentSecurityPolicy.html"> | 96 <a href="../extensions/contentSecurityPolicy"> |
| 97 <code>content_security_policy</code></a> documentation. | 97 <code>content_security_policy</code></a> documentation. |
| 98 </p> | 98 </p> |
| 99 </li> | 99 </li> |
| 100 <li> | 100 <li> |
| 101 <p> | 101 <p> |
| 102 A package's resources are no longer available by default to external | 102 A package's resources are no longer available by default to external |
| 103 websites (as the <code>src</code> of an image, or a <code>script</code> | 103 websites (as the <code>src</code> of an image, or a <code>script</code> |
| 104 tag). If you want a website to be able to load a resource contained in | 104 tag). If you want a website to be able to load a resource contained in |
| 105 your package, you'll need to explicitly whitelist it via the | 105 your package, you'll need to explicitly whitelist it via the |
| 106 <a href="manifest/web_accessible_resources.html"> | 106 <a href="manifest/web_accessible_resources"> |
| 107 <code>web_accessible_resources</code> | 107 <code>web_accessible_resources</code> |
| 108 </a> manifest attribute. This is particularly relevant for extensions that | 108 </a> manifest attribute. This is particularly relevant for extensions that |
| 109 build up an interface on a website via injected content scripts. | 109 build up an interface on a website via injected content scripts. |
| 110 </p> | 110 </p> |
| 111 </li> | 111 </li> |
| 112 <li> | 112 <li> |
| 113 <p> | 113 <p> |
| 114 The <code>background_page</code> property has been replaced with a | 114 The <code>background_page</code> property has been replaced with a |
| 115 <code>background</code> property that contains <em>either</em> a | 115 <code>background</code> property that contains <em>either</em> a |
| 116 <code>scripts</code> or <code>page</code> property. Details are available | 116 <code>scripts</code> or <code>page</code> property. Details are available |
| 117 in the <a href="event_pages.html">Event Pages</a> documentation. | 117 in the <a href="event_pages">Event Pages</a> documentation. |
| 118 </p> | 118 </p> |
| 119 </li> | 119 </li> |
| 120 <li> | 120 <li> |
| 121 <p>Browser action changes:</p> | 121 <p>Browser action changes:</p> |
| 122 <ul> | 122 <ul> |
| 123 <li> | 123 <li> |
| 124 <p> | 124 <p> |
| 125 The <code>browser_actions</code> key in the manifest, and the | 125 The <code>browser_actions</code> key in the manifest, and the |
| 126 <code>chrome.browserActions</code> API are gone. Use the singular | 126 <code>chrome.browserActions</code> API are gone. Use the singular |
| 127 <a href="browserAction.html"> | 127 <a href="browserAction"> |
| 128 <code>browser_action</code> and <code>chrome.browserAction</code> | 128 <code>browser_action</code> and <code>chrome.browserAction</code> |
| 129 </a> instead. | 129 </a> instead. |
| 130 </p> | 130 </p> |
| 131 </li> | 131 </li> |
| 132 <li> | 132 <li> |
| 133 <p> | 133 <p> |
| 134 The <code>icons</code> property of <code>browser_action</code> has | 134 The <code>icons</code> property of <code>browser_action</code> has |
| 135 been removed. Use <a href="browserAction.html#manifest"> | 135 been removed. Use <a href="browserAction#manifest"> |
| 136 the <code>default_icon</code> property | 136 the <code>default_icon</code> property |
| 137 </a> or $(ref:browserAction.setIcon) instead. | 137 </a> or $(ref:browserAction.setIcon) instead. |
| 138 </p> | 138 </p> |
| 139 </li> | 139 </li> |
| 140 <li> | 140 <li> |
| 141 <p> | 141 <p> |
| 142 The <code>name</code> property of <code>browser_action</code> has been | 142 The <code>name</code> property of <code>browser_action</code> has been |
| 143 removed. Use <a href="browserAction.html#manifest"> | 143 removed. Use <a href="browserAction#manifest"> |
| 144 the <code>default_title</code> property | 144 the <code>default_title</code> property |
| 145 </a> or $(ref:browserAction.setTitle) instead. | 145 </a> or $(ref:browserAction.setTitle) instead. |
| 146 </p> | 146 </p> |
| 147 </li> | 147 </li> |
| 148 <li> | 148 <li> |
| 149 <p> | 149 <p> |
| 150 The <code>popup</code> property of <code>browser_action</code> has | 150 The <code>popup</code> property of <code>browser_action</code> has |
| 151 been removed. Use <a href="browserAction.html#manifest"> | 151 been removed. Use <a href="browserAction#manifest"> |
| 152 the <code>default_popup</code> property | 152 the <code>default_popup</code> property |
| 153 </a> or $(ref:browserAction.setPopup) instead. | 153 </a> or $(ref:browserAction.setPopup) instead. |
| 154 </p> | 154 </p> |
| 155 </li> | 155 </li> |
| 156 <li> | 156 <li> |
| 157 <p> | 157 <p> |
| 158 The <code>default_popup</code> property of <code>browser_action</code> | 158 The <code>default_popup</code> property of <code>browser_action</code> |
| 159 can no longer be specified as an object. It must be a string. | 159 can no longer be specified as an object. It must be a string. |
| 160 </p> | 160 </p> |
| 161 </li> | 161 </li> |
| 162 </ul> | 162 </ul> |
| 163 </li> | 163 </li> |
| 164 <li> | 164 <li> |
| 165 <p>Page action changes:</p> | 165 <p>Page action changes:</p> |
| 166 <ul> | 166 <ul> |
| 167 <li> | 167 <li> |
| 168 <p> | 168 <p> |
| 169 The <code>page_actions</code> key in the manifest, and the | 169 The <code>page_actions</code> key in the manifest, and the |
| 170 <code>chrome.pageActions</code> API are gone. Use the singular | 170 <code>chrome.pageActions</code> API are gone. Use the singular |
| 171 <a href="pageAction.html"> | 171 <a href="pageAction"> |
| 172 <code>page_action</code> and <code>chrome.pageAction</code> | 172 <code>page_action</code> and <code>chrome.pageAction</code> |
| 173 </a> instead. | 173 </a> instead. |
| 174 </p> | 174 </p> |
| 175 </li> | 175 </li> |
| 176 <li> | 176 <li> |
| 177 <p> | 177 <p> |
| 178 The <code>icons</code> property of <code>page_action</code> has been | 178 The <code>icons</code> property of <code>page_action</code> has been |
| 179 removed. Use <a href="pageAction.html#manifest"> | 179 removed. Use <a href="pageAction#manifest"> |
| 180 the <code>default_icon</code> property | 180 the <code>default_icon</code> property |
| 181 </a> or $(ref:pageAction.setIcon) instead. | 181 </a> or $(ref:pageAction.setIcon) instead. |
| 182 </p> | 182 </p> |
| 183 </li> | 183 </li> |
| 184 <li> | 184 <li> |
| 185 <p> | 185 <p> |
| 186 The <code>name</code> property of <code>page_action</code> has been | 186 The <code>name</code> property of <code>page_action</code> has been |
| 187 removed. Use <a href="pageAction.html#manifest"> | 187 removed. Use <a href="pageAction#manifest"> |
| 188 the <code>default_title</code> property | 188 the <code>default_title</code> property |
| 189 </a> or $(ref:pageAction.setTitle) instead. | 189 </a> or $(ref:pageAction.setTitle) instead. |
| 190 </p> | 190 </p> |
| 191 </li> | 191 </li> |
| 192 <li> | 192 <li> |
| 193 <p> | 193 <p> |
| 194 The <code>popup</code> property of <code>page_action</code> has been | 194 The <code>popup</code> property of <code>page_action</code> has been |
| 195 removed. Use <a href="pageAction.html#manifest"> | 195 removed. Use <a href="pageAction#manifest"> |
| 196 the <code>default_popup</code> property | 196 the <code>default_popup</code> property |
| 197 </a> or $(ref:pageAction.setPopup) instead. | 197 </a> or $(ref:pageAction.setPopup) instead. |
| 198 </p> | 198 </p> |
| 199 </li> | 199 </li> |
| 200 <li> | 200 <li> |
| 201 <p> | 201 <p> |
| 202 The <code>default_popup</code> property of <code>page_action</code> | 202 The <code>default_popup</code> property of <code>page_action</code> |
| 203 can no longer be specified as an object. It must be a string. | 203 can no longer be specified as an object. It must be a string. |
| 204 </p> | 204 </p> |
| 205 </li> | 205 </li> |
| 206 </ul> | 206 </ul> |
| 207 </li> | 207 </li> |
| 208 <li> | 208 <li> |
| 209 <p> | 209 <p> |
| 210 The <code>chrome.self</code> API has been removed. Use | 210 The <code>chrome.self</code> API has been removed. Use |
| 211 <a href="extension.html"><code>chrome.extension</code></a> instead. | 211 <a href="extension"><code>chrome.extension</code></a> instead. |
| 212 </p> | 212 </p> |
| 213 </li> | 213 </li> |
| 214 <li> | 214 <li> |
| 215 <p> | 215 <p> |
| 216 <code>chrome.extension.getTabContentses</code> (!!!) and | 216 <code>chrome.extension.getTabContentses</code> (!!!) and |
| 217 <code>chrome.extension.getExtensionTabs</code> are gone. Use | 217 <code>chrome.extension.getExtensionTabs</code> are gone. Use |
| 218 $(ref:extension.getViews) instead. | 218 $(ref:extension.getViews) instead. |
| 219 </p> | 219 </p> |
| 220 </li> | 220 </li> |
| 221 <li> | 221 <li> |
| 222 <p> | 222 <p> |
| 223 <code>Port.tab</code> is gone. Use | 223 <code>Port.tab</code> is gone. Use |
| 224 $(ref:runtime.Port) | 224 $(ref:runtime.Port) |
| 225 instead. | 225 instead. |
| 226 </p> | 226 </p> |
| 227 </li> | 227 </li> |
| 228 </ul> | 228 </ul> |
| OLD | NEW |