234
edits
Changes
→Elements & Attributes
<tr><td valign="top">'''extensionVersion'''</td><td>A string in FVF format advertising the version of the extension API that this application update supplies</td></tr>
<tr><td valign="top">'''detailsURL'''</td><td>A URL string to a web page with more information about the specified update. For minor releases, this URL appears as a link (with text like "View more information about this update") in the UI shown to the user when they are presented with the option to upgrade. For major releases, this URL is loaded "in line" in the UI shown to the user when they are presented with the option to upgrade.</td></tr>
<tr><td valign="top">'''licenseURL'''</td><td>A URL string to a web page with additional license terms that need to be accepted before the update can be installed (optional, do NOT provide it if this is going to be empty). '''Note:''' this attribute is only heeded for major releases. For minor releases, this attribute is ignored by the client. For major releases, this URL is loaded "in line" in the UI shown to the user when they are presented with the option to upgrade. If specified, the licenseURL must successfully load "in line" and the user must agree to it in order to proceed with the upgrade.</td></tr>
<tr><td valign="top">'''<strike>isSecurityUpdate</strike>'''</td><td><strike><code>true</code> for security updates, to present a scarier warning to users, <code>false</code> if the update is not a security update.</strike> '''Note:''' The client is not and has not heeded this boolean value, and AUS has never set it. [https://bugzilla.mozilla.org/show_bug.cgi?id=329729#c75 See bug #329729 for details.]</td></tr>
<tr><td valign="top">'''buildID'''</td><td>The BuildID of the build being offered</td></tr>
</table>
The schemes for the URL strings specified by the <code>licenseURL</code> and <code>detailsURL</code> attributes must be <code>http:/</ code> or <code>https:/</code>. For security concerns, the web pages pointed to by the <code>licenseURL</code> and <code>detailsURL</code> attributes will be unable to execute JS, prompt for auth, execute plugins, or have subframes. (Meta redirects and images are allowed.) If specified, the <code>licenseURL</code> must successfully load "in line" before the user can agree to it. The user must agree to it in order to proceed with the upgrade. (If the <code>licenseURL</code> fails to load, the user will be unable to agree to it, and therefore unable to upgrade.) '''Note:''' if the <code>licenseURL</code> attribute does not change between major releases, the user will end up agreeing to the same license twice. [https://bugzilla.mozilla.org/show_bug.cgi?id=348389#c44 See bug #348389 for more details.]
Within an <code>update</code> element there must be at least one and no more than two <code>patch</code> elements. The <code>patch</code> element describes a patch file that lives on a remote server that must be downloaded and applied to the application to update it to that version. They describe either binary differences between versions of the application (partial patches), or complete updates that replace and remove files as necessary. The attributes for <code>patch</code> are as follows:
