[Flex/AIR] ApplicationUpdater 클래스로 Adobe AIR 자동 업데이트 삽질

에어(AIR) 2010. 5. 7. 17:11

air어플을 만들어야할 것 같아서(근데 이제 취소된 듯-_-), ApplicationUpdater를 삽질해봤습니다.

일단 air 어플리케이션은 수정사항이 있으면 자동적으로 업데이트를 체크해서 어플을 업데이트하는 기능이 꼭 들어가야합니다. 그래서 ApplicationUpdater클래스를 이용해 삽질을 해봤습니다.

보면 ApplicationUpdaterUI라는 클래스도 있는데, 이건 ui적으로 기능이 이미 구현이 되어있는 것입니다. 사용자가 이런 ui를 새롭게 꾸미려면 ApplicationUpdater클래스를 이용해서 내부적으로 처리를 하고, 나머지 ui는 직접 꾸밀 수가 있습니다. 그래서 사용자가 직접 새로운 업데이트air파일을 받는 모습과 업데이트체크를 해서 현재 업데이트가 있는지 등을 구현할 수 있습니다.

사실 과정은 applicationUpdater.checkNow()한번 때려버리면 업데이트가 있으면, 논스톱으로 강제 업데이트를 시켜버리긴합니다만-_- 강제업데이트말고, 사용자에게 업데이트 과정을 알려주기 위해서 과정을 삽질해봤습니다.

강제 업데이트를 중지하려면 각각 프로세스별로 event 중지를 시켜야합니다.

[code]
<?xml version="1.0" encoding="utf-8"?>
<mx:WindowedApplication xmlns:mx="http://www.adobe.com/2006/mxml"
layout="vertical"
title="Sample Version Checker Application"
applicationComplete="applicationCompleteHandler()">
<mx:Script>
<![CDATA[
import air.update.events.DownloadErrorEvent;
import air.update.events.StatusUpdateErrorEvent;
import air.update.events.StatusUpdateEvent;
import air.update.events.UpdateEvent;
import air.update.ApplicationUpdater;

private var applicationUpdater:ApplicationUpdater;

private function applicationCompleteHandler():void
{
// 현재버전 찍기
   var appXml:XML = NativeApplication.nativeApplication.applicationDescriptor;
var ns:Namespace = appXml.namespace();
var appVersion:String = appXml.ns::version[0];
log.text += "현재 어플리케이션버전 : " + appVersion + "\n";

// ApplicationUpdater초기화
applicationUpdater = new ApplicationUpdater();
applicationUpdater.configurationFile = new File("app:/update.xml");

// initialize할 때
applicationUpdater.addEventListener(UpdateEvent.INITIALIZED, initializedUpdateEventHandler);
applicationUpdater.addEventListener(ErrorEvent.ERROR, errorErrorEventHandler);

// checkNow할 때
applicationUpdater.addEventListener(StatusUpdateEvent.UPDATE_STATUS, updateStatusStatusUpdateEventHandler);
applicationUpdater.addEventListener(UpdateEvent.CHECK_FOR_UPDATE, checkForUpdateUpdateEventHandler);
applicationUpdater.addEventListener(StatusUpdateErrorEvent.UPDATE_ERROR, updateErrorStatusUpdateEventHandler);

// downloadUpdate할 때
applicationUpdater.addEventListener(UpdateEvent.DOWNLOAD_START, downloadStartUpdateEventHandler);
applicationUpdater.addEventListener(ProgressEvent.PROGRESS, progressProgressEventHandler);
applicationUpdater.addEventListener(UpdateEvent.DOWNLOAD_COMPLETE, downloadCompleteUpdateEventHandler);
applicationUpdater.addEventListener(DownloadErrorEvent.DOWNLOAD_ERROR, downloadErrorDownloadErrorEventHandler);

// installUpdate할 때
applicationUpdater.addEventListener(UpdateEvent.BEFORE_INSTALL, beforeInstallUpdateEventHandler);

// 초기화
applicationUpdater.initialize();
}

private function initializedUpdateEventHandler(event:UpdateEvent):void
{
log.text += "initialized : " + applicationUpdater.currentState +"\n";
applicationUpdater.checkNow();
}

private function errorErrorEventHandler(event:ErrorEvent):void
{
log.text += "error : " + applicationUpdater.currentState + "\n";
}

private function updateStatusStatusUpdateEventHandler(event:StatusUpdateEvent):void
{
event.preventDefault();
log.text += "update_status : " + applicationUpdater.currentState +"\n";
log.text += "version : " + event.version + "\n";
log.text += "available : " + event.available + "\n";

if (event.available)
{
applicationUpdater.downloadUpdate();
}
}

private function updateErrorStatusUpdateEventHandler(event:StatusUpdateEvent):void
{
log.text += "update_error : " + applicationUpdater.currentState + "\n";
}

private function checkForUpdateUpdateEventHandler(event:UpdateEvent):void
{
log.text += "check_for_update : " + applicationUpdater.currentState + "\n";
}

private function downloadStartUpdateEventHandler(event:UpdateEvent):void
{
log.text += "download_start : " + applicationUpdater.currentState + "\n";
}

private function progressProgressEventHandler(event:ProgressEvent):void
{
log.text += "progress : " + event.bytesLoaded + "/" + event.bytesTotal + "\n";
}

private function downloadCompleteUpdateEventHandler(event:UpdateEvent):void
{
event.preventDefault();
log.text += "download_complete : " + applicationUpdater.currentState + "\n";
btnInstall.visible = true;
}

private function downloadErrorDownloadErrorEventHandler(event:DownloadErrorEvent):void
{
log.text += "download_error : " + applicationUpdater.currentState + "\n";
}

private function beforeInstallUpdateEventHandler(event:UpdateEvent):void
{
log.text += "before_install : " + applicationUpdater.currentState + "\n";
}

private function clickInstallHandler(event:MouseEvent):void
{
applicationUpdater.installUpdate();
}
]]>
</mx:Script>
<mx:TextArea id="log" width="100%" height="100%" />
<mx:Button id="btnInstall" click="clickInstallHandler(event)" visible="false" label="설치"/>
</mx:WindowedApplication>
[/code]

air안에 있는 update.xml파일
[code]<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0" >
   <url>웹에있는update.xml파일 주소</url>
   <delay>1</delay>
</configuration>[/code]

web에 올려진 update.xml파일
[code]<?xml version="1.0" encoding="utf-8"?>
<update xmlns="http://ns.adobe.com/air/framework/update/description/1.0">
<version>1.5</version>
<url>업데이트할 air파일 주소</url>
<description>
<![CDATA[update! 1.5!]]>
</description>
</update>
[/code]

과정은 initialize()한다음에 checkNow()를 호출하면....
현재 업데이트가 있는지 update_status가 발생하면, 그 event변수에 version과 available값이 오는데, 거기에 available이 true면 업데이트가 있는 겁니다.
downloadUpdate()를 호출하면 파일을 막 다운로드하는데, 파일 받는 과정을 progressevent로 받을 수 있습니다.
완료가 되면 downloadComplete이벤트가 발생해서 installUpdate()를 때려주면 어플이 종료되고 업데이트를 시작합니다.