Providing updates to people who use your AIR apps can be a bit of a hassle. The actual Updater code only takes one or two lines, but you essentially have to write your own framework around it to consider it full-featured (check, compare, download, install). Some have supplied examples in ActionScript and JavaScript, but Adobe made it even easier in AIR 1.5. Here's the way I use the new ApplicationUpdaterUI framework in JavaScript.
<script type="text/javascript" src="lib/air/AIRAliases.js"></script>
<script type="application/x-shockwave-flash" src="lib/air/applicationupdater_ui.swf"></script>
<!-- This is the file described below. -->
<script type="text/javascript" src="_UpdaterUI.js"></script>
<!-- Include the rest of your application however you normally would. -->
<script type="text/javascript" src="your-application-files.js"></script>
If you're using the Aptana or Dreamweaver extensions for Adobe AIR, your IDE should be generate applicationupdater_ui.swf as part of a new Adobe AIR project. You may have to check an option to create it.
// _UpdaterUI.js
_UpdaterUI = function() {
var _ = {
/**
* Don't change these directly!
* Instead, use _UpdaterUI.init("http://your.web.site/path/to/version.xml");
*/
url : false, // address of version.xml
updater : false // ApplicationUpdaterUI object
};
function onUpdate(e) {
if (_.updater) {
_.updater.checkNow();
}
}
function onError(e) {
air.trace(e); // replace this to log or handle as necessary for your app
}
return {
init : function(url) {
_.url = (typeof url == "string") ? url : false;
_.updater = (_.url) ? function() {
try {
var u = new runtime.air.update.ApplicationUpdaterUI();
u.updateURL = _.url;
u.isCheckForUpdateVisible = false; // if true: Ask user before checking
u.isFileUpdateVisible = false; // if true: Ask user where to save .air file
u.isInstallUpdateVisible = true; // if true: Ask user whether to update now or on restart
u.addEventListener(runtime.air.update.events.UpdateEvent.INITIALIZED, onUpdate);
u.addEventListener(runtime.flash.events.ErrorEvent.ERROR, onError);
u.initialize();
} catch (e) {
air.trace(e);
}
return u;
}() : false;
}
};
}();
I basically encapsulated and "unobtrusified" (no, that's not really a word) the example from Adobe's AIR Developer Center,
so that I could reuse it across multiple projects with minimal effort. You simply include the above file from your initial HTML
document, then call _UpdaterUI.init("http://your.web.site/path/to/version.xml").
Your version.xml file should have the same overall format as the Adobe example, reproduced below:
<?xml version="1.0" encoding="utf-8"?>
<update xmlns="http://ns.adobe.com/air/framework/update/description/1.0">
<version>1.23</version>
<url>http://your.web.site/path/to/YourApplication.air</url>
<description><![CDATA[
This version has fixes for the
following known issues:
*First issue
*Second issue
]]></description>
</update>
Enjoy!
I'm a Front-End Engineer at Yahoo! working on the Mail and Messenger teams. I blog about web design and development topics including accessibility, usability, performance, and developing HTML / CSS / JavaScript applications on Appcelerator Titanium and Adobe AIR.
If you're a web developer, you might enjoy Jelo, my JavaScript library.
A few panoramic shots I took at SDCC 2010. #geek http://bit.ly/bwX6GB
JS version of Regex prime number checker:
function isPrime(n) {
return Array(n + 1).join("1")
.search(/^1?$|^(11+?)\1+$/) == -1;
}
Погрузился в пучину EcmaScript5, местами увлекательно, местами нудно =)
Modernizr http://ow.ly/18njQ1
A Collection of 20 HTML5 Video Players - a round-up of JavaScript and html5 alternatives to Flash-based media player... http://ow.ly/18njQ2
jQuery TOOLS - The missing UI library for the Web http://ow.ly/18njQ3
Contactable - A jQuery Plugin | the odin http://ow.ly/18njQ4
Giants vs Dodgers, sweet seats. http://twitpic.com/2ag9pa
@snookca That'll be fixed next week. I promise.
@snookca I was tryna not name names ;) But really that was just par for the course today, pretty hectic day. As I'm sure you know.
Who breaks major stuff after 4pm on Friday? On the last day of the sprint, no less. Tsk. (wasn't me)
Awesome live git tracker for teams: http://www.utsup.com/
RT @DerrenBrown: Blog post: Camera Software Lets You See Into the Past http://bit.ly/9kjVg5
10 invites to the new version of Digg: http://bit.ly/dqM8EV
Threaded vs Evented Servers, great look at the whats and whys. http://bit.ly/bDUEjn #geek
Nav, Context menus, "app-style" toolbars in sample chapter http://bit.ly/csTRY8 of new YUI book http://bit.ly/cJINoV
Add a side-mounted End Call button to your iPhone 4: http://bit.ly/cGxPBD #funny #geekAll original work on this site is covered by a Creative Commons Attribution 3.0 license unless otherwise specified.
You may share or use any code or images from this site in any manner, for free, so long as reasonable effort has been made to give credit where due.
The views expressed in the posts and comments on this blog do not necessarily reflect the views of Yahoo!