Changes

Jump to: navigation, search

Software Update:updates.xml Format

1,870 bytes added, 01:35, 8 November 2005
Elements & Attributes
<table>
<tr><tdvalign="top">'''type'''</td><td><code>major</code> or <code>minor</code>. Major updates are for major application number revs, minor for security releases or incremental updates.</td></tr> <tr><td valign="top">'''version'''</td><td>A string in FVF format advertising the version of this application update.</td></tr> <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. This will be shown in the UI 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)</td></tr> <tr><td valign="top">'''isSecurityUpdate'''</td><td><code>true</code> for security updates, to present a scarier warning to users, <code>false</code> if the update is not a security update</td></tr> <tr><td valign="top">'''buildID'''</td><td>The BuildID of the build being offered</td></tr>
</table>
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: <table> <tr><td valign="top">'''type'''</td><td><code>partial</code> or <code>complete</code>, depending on the patch. </td></tr> <tr><td valign="top">'''url'''</td><td>A URL to the remote patch file.</td></tr> <tr><td valign="top">'''hashfunction'''</td><td>The name of the hash function to execute to verify the integrity of the patch.</td></tr> <tr><td valign="top">'''hashvalue'''</td><td>The server-generated hash generated for the file. If the client generated value does not match this, the integrity check fails after download.</td></tr> <tr><td valign="top">'''size'''</td><td>The size of the update, in bytes.</td></tr></table>
== Additional Client Metadata ==
525
edits

Navigation menu