Previously, I showed you how to automatically update your Adobe AIR 1.5 application using Adobe's ApplicationUpdaterUI. What if you don't need (or want) to rely on user interaction at all? While the ApplicationUpdaterUI class provides basic updating functionality and a default user interface, ApplicationUpdater provides update functionality while letting you handle the UI yourself, or providing no update-related UI at all.
<script type="text/javascript" src="lib/air/AIRAliases.js"></script>
<script type="application/x-shockwave-flash" src="lib/air/applicationupdater.swf"></script>
<!-- This is the file described below. -->
<script type="text/javascript" src="Updater.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, applicationupdater.swf should be automatically generated as part of a new Adobe AIR project. You may have to check an option to create it.
// _Updater.js
Updater = function() {
var _ = {
/**
* Don't change these directly!
* Instead, use Updater.init("http://your.web.site/path/to/version.xml");
*/
url : false,
updater : false
};
function error(e) {
air.trace(e); // handle this error as necessary for your app
}
function checkComplete(e) {
if (e.available) {
/**
* The application is now updating, notify other components here if necessary.
*/
} else {
MyApp.start(); // call your application entry point
}
}
return {
init : function(ns, url) {
_.url = (typeof url == "string") ? url : false;
_.updater = (_.url) ? new runtime.air.update.ApplicationUpdater() : false;
this.check();
},
check : function() {
if (_.updater) {
_.updater.delay = 1; // how many days between checks, can be a fraction
_.updater.updateURL = _.url;
assignHandler(runtime.air.update.events.UpdateEvent.INITIALIZED, function() {
_.updater.checkNow(); // have to call the first check manually
});
assignHandler(runtime.flash.events.ErrorEvent.ERROR, error);
assignHandler(runtime.air.update.events.DownloadErrorEvent.DOWNLOAD_ERROR, error);
assignHandler(runtime.air.update.events.StatusUpdateErrorEvent.UPDATE_ERROR, error);
assignHandler(runtime.air.update.events.StatusUpdateEvent.UPDATE_STATUS, checkComplete);
_.updater.initialize();
}
}
};
}();
Simply include the above file in a script tag in your application's main HTML file, then call
_Updater.init("http://your.web.site/path/to/version.xml"). The target XML file should follow the format below, as
per the Adobe example:
<?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!