| 패키지 | air.update |
| 클래스 | public class ApplicationUpdaterUI |
| 상속 | ApplicationUpdaterUI  EventDispatcher Object |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
이 클래스는 Adobe AIR SDK에 포함된 applicationupdater_ui.swc 파일에 포함되어 있습니다. applicationupdater_ui.swc 파일은 AIR SDK의 frameworks/libs/air 디렉토리에 있습니다. AIR 2 SDK의 frameworks/libs/air 디렉토리에 있는 버전은 Flex 4 개발용입니다. Flex 3을 사용하는 경우에는 frameworks/libs/air/flex3 하위 디렉토리의 버전을 사용하십시오.
Adobe® Flex™ Builder™에서는 Adobe AIR용 프로젝트를 만들 때 이 클래스를 자동으로 로드합니다. Adobe® Flex™ SDK를 사용하여 응용 프로그램을 컴파일할 때는 SWC 파일을 포함해야 합니다.
응용 프로그램 업데이트 관리는 간단하지 않습니다. AIR 업데이트 프레임워크에서 제공하는 API를 사용하면 개발자가 AIR 응용 프로그램에 뛰어난 업데이트 기능을 제공할 수 있습니다. 개발자는 AIR 업데이트 프레임워크의 기능을 사용하여 다음을 수행할 수 있습니다.
-
정해진 간격 또는 사용자의 요청에 따라 주기적 업데이트 확인
-
웹 소스에서 AIR 파일(업데이트) 다운로드
-
새로 설치한 버전을 처음 실행할 때 사용자에게 경고
-
사용자가 업데이트 확인을 원하는지 확인
-
사용자에게 새 업데이트 버전에 대한 정보 표시
-
사용자에게 다운로드 진행률 및 오류 정보 표시
AIR 업데이트 프레임워크를 사용하면 AIR 응용 프로그램의 업데이트 버전 정보를 간단한 XML 구성 파일에 저장할 수 있습니다. 대부분의 응용 프로그램에서는 이러한 구성 파일을 설정하고 일부 기본 코드를 포함하여 최종 사용자가 쉽게 업데이트 작업을 수행하도록 할 수 있습니다.
AIRUpdateUI 클래스는 응용 프로그램에서 사용할 수 있는 기본 사용자 인터페이스를 구현합니다. 사용자에게 응용 프로그램 업데이트에 대한 기본 정보와 옵션을 제공합니다.
업데이트 프로세스는 일련의 단계로 이루어집니다.
| 상태 | 설명 |
|---|---|
| Uninitialized | 업데이트 프로그램이 초기화되지 않았습니다. |
| Initializing | 업데이트 프로그램이 초기화하는 중입니다. |
| Ready | 업데이트 프로그램이 초기화되었습니다. |
| Before checking | 업데이트 프로그램이 업데이트 설명자 파일을 아직 확인하지 않았습니다. |
| Checking | 업데이트 프로그램이 업데이트 설명자 파일을 확인하는 중입니다. |
| Available | 업데이트 설명자 파일을 사용할 수 있습니다. |
| Downloading | 업데이트 프로그램이 AIR 파일을 다운로드하는 중입니다. |
| Downloaded | 업데이트 프로그램이 AIR 파일을 다운로드했습니다. |
| Installing | 업데이트 프로그램이 AIR 파일을 설치하는 중입니다. |
| Pending install | 업데이트 프로그램이 초기화되었고 대기 중인 업데이트가 있습니다. |
ADL(AIR Debug Launcher) 응용 프로그램을 사용하여 응용 프로그램을 테스트할 때 응용 프로그램을 업데이트하면 IllegalOperationError 예외가 발생합니다.
AIR 업데이트 프레임워크는 데스크톱 프로파일에서만 지원되며, 확장 데스크톱 응용 프로그램(기본 설치 프로그램을 사용하여 설치한 응용 프로그램)과 모바일 프로파일(ActionScript 3.0으로 작성한 iPhone 응용 프로그램)에서는 지원되지 않습니다. 업데이트 프레임워크가 지원되는지 보려면 런타임에 Updater.isSupported 속성을 확인하십시오.
AIR 업데이트 프레임워크를 사용하는 방법에 대한 자세한 내용은 Adobe AIR 응용 프로그램 만들기의 "AIR 응용 프로그램 업데이트" 장을 참조하십시오.
관련 API 요소
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
| configurationFile : File
delay 및 updateURL 속성에 대한 값을 설정하는 구성 파일의 위치입니다. | ApplicationUpdaterUI | ||
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| currentVersion : String [읽기 전용]
응용 프로그램의 현재 버전입니다. | ApplicationUpdaterUI | ||
| delay : Number
새 업데이트의 주기적 검사 간격(일)입니다. | ApplicationUpdaterUI | ||
| isCheckForUpdateVisible : Boolean
[업데이트 확인], [업데이트 없음] 및 [업데이트 오류] 대화 상자의 가시성을 활성화합니다. | ApplicationUpdaterUI | ||
| isDownloadProgressVisible : Boolean
[다운로드 업데이트] 대화 상자의 가시성을 활성화합니다. | ApplicationUpdaterUI | ||
| isDownloadUpdateVisible : Boolean
[다운로드 업데이트] 대화 상자의 가시성을 활성화합니다. | ApplicationUpdaterUI | ||
| isFileUpdateVisible : Boolean
[파일 업데이트], [파일 업데이트 없음] 및 [파일 오류] 대화 상자의 가시성을 활성화합니다. | ApplicationUpdaterUI | ||
| isFirstRun : Boolean [읽기 전용]
업데이트 성공 후 처음 실행하는 것인지(true) 아닌지(false)를 나타냅니다. | ApplicationUpdaterUI | ||
| isInstallUpdateVisible : Boolean
[업데이트 설치] 대화 상자의 가시성을 활성화합니다. | ApplicationUpdaterUI | ||
| isNewerVersionFunction : Function
업데이트 프로그램이 버전 비교를 수행할 때 사용하는 기능입니다. | ApplicationUpdaterUI | ||
| isUnexpectedErrorVisible : Boolean
[예기치 않은 오류] 대화 상자의 가시성을 활성화합니다. | ApplicationUpdaterUI | ||
| isUpdateInProgress : Boolean [읽기 전용]
업데이트가 실행 중이면 true이고 그렇지 않으면 false인 부울 속성입니다. | ApplicationUpdaterUI | ||
| localeChain : Array
사용자 인터페이스에서 사용하는 로캘 체인을 정의하는 배열입니다. | ApplicationUpdaterUI | ||
| previousApplicationStorageDirectory : File [읽기 전용]
업데이트 후 변경된 경우 응용 프로그램 저장소 디렉토리의 이전 위치입니다. | ApplicationUpdaterUI | ||
| previousVersion : String [읽기 전용]
응용 프로그램의 이전 버전입니다. | ApplicationUpdaterUI | ||
| updateDescriptor : XML [읽기 전용]
업데이트 URL에서 다운로드된 업데이트 설명자 파일의 내용입니다. | ApplicationUpdaterUI | ||
| updateURL : String
업데이트 설명자 파일의 위치입니다. | ApplicationUpdaterUI | ||
| wasPendingUpdate : Boolean [읽기 전용]
연기된 업데이트가 있는 경우 설치에 실패했더라도 true로 설정되고, 그렇지 않으면 false로 설정됩니다. | ApplicationUpdaterUI | ||
| 메서드 | 정의 주체 | ||
|---|---|---|---|
생성자 함수입니다. | ApplicationUpdaterUI | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | |
지정된 언어에 대한 새 리소스 번들을 동적으로 추가합니다. | ApplicationUpdaterUI | ||
업데이트 프로세스를 취소합니다. | ApplicationUpdaterUI | ||
업데이트 프로세스를 시작합니다. | ApplicationUpdaterUI | ||
|
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | |
|
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
업데이트 프로그램을 초기화합니다. | ApplicationUpdaterUI | ||
로컬 AIR 파일을 사용하여 업데이트 프로세스를 시작합니다. | ApplicationUpdaterUI | ||
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | |
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
|
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
| 이벤트 | 요약 | 정의 주체 | ||
|---|---|---|---|---|
| [브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다. | EventDispatcher | ||
| 업데이트를 설치하기 전 installUpdate() 메서드가 호출된 후에 전달됩니다. | ApplicationUpdaterUI | |||
| 업데이트 프로세스가 시작되기 전, 업데이트 설명자 파일을 다운로드하기 직전에 전달됩니다. | ApplicationUpdaterUI | |||
| [브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다. | EventDispatcher | ||
| 업데이트 파일 다운로드가 완료되면 전달됩니다. | ApplicationUpdaterUI | |||
| 업데이트 파일을 연결하거나 다운로드하는 동안 오류가 발생하면 전달됩니다. | ApplicationUpdaterUI | |||
| downloadUpdate() 메서드가 호출되고 서버에 대한 연결이 설정된 후 전달됩니다. | ApplicationUpdaterUI | |||
| 초기화 또는 업데이트 프로세스 중 예기치 못한 오류가 발생하면 전달됩니다. | ApplicationUpdaterUI | |||
| installFromAIRFile() 메서드에 대한 호출에서 airFile 매개 변수로 전달된 파일의 유효성을 검사하는 동안 오류가 발생하면 전달됩니다. | ApplicationUpdaterUI | |||
| 업데이트 프로그램이 installFromAIRFile() 메서드에 대한 호출에서 파일의 유효성을 성공적으로 검사한 후 전달됩니다. | ApplicationUpdaterUI | |||
| 초기화가 완료된 후 전달됩니다. | ApplicationUpdaterUI | |||
| 업데이트 파일이 다운로드되는 동안 전달됩니다. | ApplicationUpdaterUI | |||
| 업데이트 설명자 파일을 다운로드하거나 파싱하는 동안 오류가 발생하면 전달됩니다. | ApplicationUpdaterUI | |||
| 업데이트 프로그램이 업데이트 설명자 파일을 성공적으로 다운로드하고 해석한 후 전달됩니다. | ApplicationUpdaterUI | |||
configurationFile | 속성 |
configurationFile:File| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
delay 및 updateURL 속성에 대한 값을 설정하는 구성 파일의 위치입니다. 또한 응용 프로그램에서 업데이트 프로세스 중 다양한 확인 대화 상자를 표시하는지 여부를 확인하는 설정도 있습니다. 이 속성이 존재하지 않는 파일을 가리킬 때 initialize() 메서드를 호출하면 오류가 발생합니다.
다음 예제 구성 파일을 참조하십시오.
<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0" >
<url>app:/server/update.xml</url>
<delay>1</delay>
<defaultUI>
<dialog name="checkForUpdate" visible="true" />
<dialog name="downloadUpdate" visible="false" />
<dialog name="downloadProgress" visible="true" />
<dialog name="installUpdate" visible="true" />
</defaultUI>
</configuration>구성 파일을 로드하는 대신 ActionScript 코드를 사용하여 ApplicationUpdaterUI 객체의 delay, isCheckForUpdateVisible, isDownloadProgressVisible, isDownloadUpdateVisible, isFileUpdateVisible, isInstallUpdateVisible 및 updateURL 속성을 설정할 수 있습니다.
구현
public function get configurationFile():File public function set configurationFile(value:File):void관련 API 요소
currentVersion | 속성 |
delay | 속성 |
delay:Number| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
새 업데이트의 주기적 검사 간격(일)입니다.
값을 0(기본값)으로 지정하면 타이머가 활성화되지 않으므로 주기적 검사가 수행되지 않습니다. 이 속성 또는 구성 파일을 통해 지연을 설정할 수 있습니다. 두 메서드를 사용하여 값을 설정하면 이 속성을 사용하는 값 설정이 사용됩니다.
기본값: 0.
구현
public function get delay():Number public function set delay(value:Number):void관련 API 요소
isCheckForUpdateVisible | 속성 |
isCheckForUpdateVisible:Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
[업데이트 확인], [업데이트 없음] 및 [업데이트 오류] 대화 상자의 가시성을 활성화합니다. true로 설정하면 업데이트 프로그램에서 업데이트 프로세스의 일부로 이러한 대화 상자를 표시합니다. 업데이트 구성 파일에서도 설정할 수 있습니다. 이 속성을 사용하여 설정한 값은 업데이트 구성 파일의 설정보다 우선합니다.
구현
public function get isCheckForUpdateVisible():Boolean public function set isCheckForUpdateVisible(value:Boolean):void isDownloadProgressVisible | 속성 |
isDownloadProgressVisible:Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
[다운로드 업데이트] 대화 상자의 가시성을 활성화합니다. true로 설정하면 업데이트 프로그램에서 업데이트 프로세스의 일부로 이 대화 상자를 표시합니다. 업데이트 구성 파일에서도 설정할 수 있습니다. 이 속성을 사용하여 설정한 값은 업데이트 구성 파일의 설정보다 우선합니다.
구현
public function get isDownloadProgressVisible():Boolean public function set isDownloadProgressVisible(value:Boolean):void isDownloadUpdateVisible | 속성 |
isDownloadUpdateVisible:Boolean| 런타임 버전: | AIR 1.5 |
[다운로드 업데이트] 대화 상자의 가시성을 활성화합니다. true로 설정하면 업데이트 프로그램에서 업데이트 프로세스의 일부로 이러한 대화 상자를 표시합니다. 업데이트 구성 파일에서도 설정할 수 있습니다. 이 속성을 사용하여 설정한 값은 업데이트 구성 파일의 설정보다 우선합니다.
구현
public function get isDownloadUpdateVisible():Boolean public function set isDownloadUpdateVisible(value:Boolean):void isFileUpdateVisible | 속성 |
isFileUpdateVisible:Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
[파일 업데이트], [파일 업데이트 없음] 및 [파일 오류] 대화 상자의 가시성을 활성화합니다. true로 설정하면 업데이트 프로그램에서 업데이트 프로세스의 일부로 이러한 대화 상자를 표시합니다. 업데이트 구성 파일에서도 설정할 수 있습니다. 이 속성을 사용하여 설정한 값은 업데이트 구성 파일의 설정보다 우선합니다.
구현
public function get isFileUpdateVisible():Boolean public function set isFileUpdateVisible(value:Boolean):void isFirstRun | 속성 |
isInstallUpdateVisible | 속성 |
isInstallUpdateVisible:Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
[업데이트 설치] 대화 상자의 가시성을 활성화합니다. true로 설정하면 업데이트 프로그램에서 업데이트 프로세스의 일부로 이 대화 상자를 표시합니다. 업데이트 구성 파일에서도 설정할 수 있습니다. 이 속성을 사용하여 설정한 값은 업데이트 구성 파일의 설정보다 우선합니다.
구현
public function get isInstallUpdateVisible():Boolean public function set isInstallUpdateVisible(value:Boolean):void isNewerVersionFunction | 속성 |
isNewerVersionFunction:Function| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 프로그램이 버전 비교를 수행할 때 사용하는 기능입니다. 기본적으로 업데이트 프레임워크는 설치된 응용 프로그램의 버전보다 원격 사이트의 버전이 최신인지 확인하기 위해 버전 비교를 수행합니다. 그러나 기본 비교 방법이 개발자의 버전 지정 방법과 맞지 않을 수 있습니다. 비교를 수행하는 새 함수를 제공하려면 이 속성을 설정합니다.
기본 비교 함수는 x.y.z 등의 버전을 사용합니다. 여기서 x, y 및 z에는 문자와 숫자가 포함될 수 있습니다. 기본 비교 함수에서 인식하는 몇 가지 특수 조건이 있습니다. test 함수가 버전 문자열에서 "alpha", "beta" 또는 "rc"를 찾으면 순서가 alpha < beta < rc가 됩니다.
구현
public function get isNewerVersionFunction():Function public function set isNewerVersionFunction(value:Function):void예제 ( 예제 사용 방법 )
appUpdate 업데이트 프로그램 객체에 대해 사용자 정의 함수 customFn을 정의합니다. 예제 함수는 간단합니다. 사용자 정의 함수는 버전 지정 규칙에 따라 부울 값을 반환합니다.
appUpdate.isNewerVersionFunction = customFn;
function customFn (currentVersion:String, updateVersion:String):Boolean
{
return updateVersion > currentVersion;
}
isUnexpectedErrorVisible | 속성 |
isUnexpectedErrorVisible:Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
[예기치 않은 오류] 대화 상자의 가시성을 활성화합니다. true로 설정하면 응용 프로그램 업데이트 프로그램에서 업데이트 프로세스의 일부로 이 대화 상자를 표시합니다. 업데이트 구성 파일에서도 설정할 수 있습니다. 이 속성을 사용하여 설정한 값은 업데이트 구성 파일의 설정보다 우선합니다.
구현
public function get isUnexpectedErrorVisible():Boolean public function set isUnexpectedErrorVisible(value:Boolean):void isUpdateInProgress | 속성 |
localeChain | 속성 |
localeChain:Array| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
사용자 인터페이스에서 사용하는 로캘 체인을 정의하는 배열입니다. 일반적으로 JavaScript(HTML) 개발자만 이 속성을 사용합니다.
Flex 개발자들은 ResourceManager를 사용하여 로캘 체인을 처리합니다.
기본적으로 HTML 기반의 응용 프로그램에서는 언어가 Capabilities.languages 배열의 언어 및 사용자 인터페이스에서 지원하는 10가지 언어 중 하나로 저장됩니다. 일치하는 언어를 찾을 수 없으면 사용자 인터페이스에서 영어를 사용합니다.
이 JavaScript 예제에서는 AIR SDK에 포함된 AIR HTML 지역화 프레임워크를 사용합니다. 언어 목록에 따라 언어를 정렬한 다음 영어를 기본 폴백 언어로 설정합니다.
appUpdater.addResources("ro_RO", {titleCheck: "Titlu", msgCheck: "Mesaj", btnCheck: "Buton"});
appUpdater.addResources("hu", {titleCheck: "Cím", msgCheck: "Üzenet"});
var languages = ["ro", "hu"];
languages = languages.concat(air.Capabilities.languages);
var sortedLanguages = air.Localizer.sortLanguagesByPreference(languages, air.Capabilities.language, "en-US");
sortedLanguages.push("en-US");
appUpdater.localeChain = sortedLanguages;구현
public function get localeChain():Array public function set localeChain(value:Array):void관련 API 요소
previousApplicationStorageDirectory | 속성 |
previousApplicationStorageDirectory:File [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 후 변경된 경우 응용 프로그램 저장소 디렉토리의 이전 위치입니다. 인증서 마이그레이션이 포함된 업그레이드 후에는 응용 프로그램 저장소 디렉토리 위치가 변경됩니다. 인증서 마이그레이션이 없는 경우 사용자가 응용 프로그램을 업데이트할 때 응용 프로그램 저장소 디렉토리가 변경되지 않습니다. 또한 이 속성이 null로 설정됩니다. 이 속성은 initialize() 메서드를 호출하는 동안 설정됩니다.
개발자가 ADT를 사용하여 AIR 파일을 패키지화할 때 -migrate 옵션을 사용할 경우 새 버전의 AIR 응용 프로그램에 새로운 인증서로 서명할 수 있습니다. 새 버전의 AIR 응용 프로그램에서 새 서명 인증서를 사용하는 경우 사용자가 새 버전을 설치하면 응용 프로그램의 로컬 저장소 디렉토리가 변경됩니다. 이 속성을 사용하여 이전 응용 프로그램 저장소 디렉토리에서 새 응용 프로그램 저장소 디렉토리(File.applicationStorageDirectory)로 데이터를 전송합니다. 자세한 내용은 Adobe AIR 개발자 안내서의 "명령줄 도구를 사용하여 AIR 응용 프로그램 만들기" 장에서 "AIR 파일에 서명하여 응용 프로그램 인증서 변경"을 참조하십시오.
구현
public function get previousApplicationStorageDirectory():File previousVersion | 속성 |
updateDescriptor | 속성 |
updateURL | 속성 |
updateURL:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 설명자 파일의 위치입니다. URLRequest 경로에 유효한 위치가 사용됩니다. 업데이트 프로그램에서 필요로 하는 유일한 필수 설정입니다. 이 속성 또는 구성 파일을 통해 업데이트 URL을 설정할 수 있습니다. 두 메서드를 사용하여 값을 설정하면 업데이트 프로그램에서 이 속성을 사용하는 값 설정을 사용합니다.
구현
public function get updateURL():String public function set updateURL(value:String):void관련 API 요소
wasPendingUpdate | 속성 |
wasPendingUpdate:Boolean [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
연기된 업데이트가 있는 경우 설치에 실패했더라도 true로 설정되고, 그렇지 않으면 false로 설정됩니다. 업데이트 프로그램에서 initialize() 메서드를 호출하는 동안 이 속성을 설정합니다. wasPendingUpdate 및 isFirstRun 속성을 사용하여 업데이트를 설치하지 못했는지를 확인합니다. 설치하지 못한 경우 wasPendingUpdate가 true, isFirstRun이 false로 설정됩니다.
구현
public function get wasPendingUpdate():Boolean관련 API 요소
ApplicationUpdaterUI | () | 생성자 |
public function ApplicationUpdaterUI()| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
생성자 함수입니다.
addResources | () | 메서드 |
public function addResources(lang:String, res:Object):void| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
지정된 언어에 대한 새 리소스 번들을 동적으로 추가합니다. JavaScript 개발자는 이 메서드를 사용하여 응용 프로그램 업데이트 프로그램 UI에 표시되는 새 언어를 동적으로 추가합니다. Flex 개발자는 "ApplicationUpdaterDialogs" 리소스 번들에 새 언어를 직접 추가할 수 있습니다.
매개 변수
lang:String — 언어 코드입니다(예: 루마니아어의 경우 "ro").
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
res:Object — 객체에는 키와 변환 값이 포함되어 있습니다. 키는 언어 속성 파일에서 가져온 것입니다. 다음 테이블에는 가능한 키(속성 이름)가 나열됩니다.
|
관련 API 요소
cancelUpdate | () | 메서드 |
public function cancelUpdate():void| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 프로세스를 취소합니다. 이 메서드를 호출하면 대기 중인 다운로드가 취소되고 완료되지 않은 다운로드 파일이 모두 삭제되며 주기적 검사 타이머가 재시작됩니다.
시스템 상태가 "uninitialized" 또는 "initializing"인 경우를 제외하면 언제든지 업데이트 프로세스를 취소할 수 있습니다. "uninitialized" 또는 "initializing" 상태일 때 호출하면 아무런 동작도 일어나지 않습니다.
checkNow | () | 메서드 |
public function checkNow():void| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 프로세스를 시작합니다. 이 메서드를 호출해도 주기적 타이머가 중지되지 않습니다. 그러나 업데이트 프로세스가 실행 중인지 확인하여 현재 반복을 생략합니다.
이 메서드는 현재 상태가 "Ready"인 경우에만 실행됩니다.
이 메서드를 실행하면 업데이트 프로그램 객체에서 다음 이벤트를 전달합니다.
이벤트
checkForUpdate: — 업데이트 프로세스가 시작되기 직전에 전달됩니다.
|
initialize | () | 메서드 |
public function initialize():void| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 프로그램을 초기화합니다. 이 메서드를 호출하면 다음 동작이 일어납니다.
-
업데이트 프레임워크를 초기화하고 대기 중인 업데이트를 자동으로 그리고 동기적으로 설치합니다. 이 메서드를 호출하면 응용 프로그램이 재시작될 수 있으므로 응용 프로그램 설치 전에 호출해야 합니다.
-
연기된 업데이트가 있는지 확인한 다음 설치합니다.
-
이전 업데이트 시 오류가 발생한 경우 저장 영역에서 해당 업데이트 파일과 버전 정보를 지웁니다.
-
주기적 타이머 지연이 만료된 경우 업데이트 프로세스를 시작하고 그렇지 않은 경우 주기적 타이머를 시작합니다. 그러나 ADL(AIR Debug Launcher) 응용 프로그램을 사용하여 응용 프로그램을 테스트할 때 응용 프로그램을 업데이트하면 IllegalOperationError 예외가 발생합니다.
이벤트
initialized: — 설치가 완료되었습니다.
| |
error: — 초기화 중 오류가 발생합니다.
|
installFromAIRFile | () | 메서드 |
public function installFromAIRFile(file:File):void| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
로컬 AIR 파일을 사용하여 업데이트 프로세스를 시작합니다.
업데이트 프로세스가 실행 중일 때, 즉 "Downloaded" 상태가 아닌 경우 이 메서드를 호출하면 아무런 동작도 일어나지 않습니다.
이 함수는 응용 프로그램 설명자 파일에서 customUpdateUI 요소가 true로 설정된 응용 프로그램에 유용합니다.
ADL(AIR Debug Launcher) 응용 프로그램을 사용하여 응용 프로그램을 테스트할 때 이 메서드를 호출하면 IllegalOperationError 예외가 발생합니다.
매개 변수
file:File — 설치할 로컬 AIR 파일입니다.
|
이벤트
fileUpdateStatus: — 업데이트 프로그램에서 AIR 파일의 유효성을 성공적으로 검사한 후 전달됩니다.
| |
updateError: — 업데이트 설명자 파일을 파싱하는 동안 오류가 발생하면 전달됩니다.
|
beforeInstall | 이벤트 |
air.update.events.UpdateEvent속성 UpdateEvent.type =
air.update.events.UpdateEvent.BEFORE_INSTALL| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트를 설치하기 전 installUpdate() 메서드가 호출된 후에 전달됩니다. 사용자가 업데이트를 설치하기 위해 런타임으로 응용 프로그램을 종료하면 현재 작업을 잃을 수 있으므로 업데이트 설치를 나중으로 미뤄야 할 때가 있습니다.
이 이벤트의 preventDefault() 메서드를 호출하면 다음에 재시작할 때까지 설치가 연기됩니다. preventDefault() 메서드를 호출하면 installUpdate() 메서드 호출 또는 주기적 검사로 인해 이 응용 프로그램 세션 동안 추가 업데이트 프로세스를 시작할 수 없습니다.
UpdateEvent.BEFORE_INSTALL 상수는 beforeInstall 이벤트에 대한 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | false |
cancelable | false. 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 업데이트 프로그램 객체입니다. |
checkForUpdate | 이벤트 |
air.update.events.UpdateEvent속성 UpdateEvent.type =
air.update.events.UpdateEvent.CHECK_FOR_UPDATE| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 프로세스가 시작되기 전, 업데이트 설명자 파일을 다운로드하기 직전에 전달됩니다. checkNow() 메서드를 직접 호출하거나 주기적 검사 타이머가 만료된 경우 업데이트 프로그램에서 이 이벤트를 전달합니다.
UpdateEvent.CHECK_FOR_UPDATE 상수는 checkForUpdate 이벤트에 대한 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | false |
cancelable | false. 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 업데이트 프로그램 객체입니다. |
downloadComplete | 이벤트 |
air.update.events.UpdateEvent속성 UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_COMPLETE| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 파일 다운로드가 완료되면 전달됩니다.
UpdateEvent.DOWNLOAD_COMPLETE 상수는 downloadComplete 이벤트에 대한 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | false |
cancelable | false. 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 업데이트 프로그램 객체입니다. |
downloadError | 이벤트 |
air.update.events.DownloadErrorEvent속성 DownloadErrorEvent.type =
air.update.events.DownloadErrorEvent.DOWNLOAD_ERROR| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 파일을 연결하거나 다운로드하는 동안 오류가 발생하면 전달됩니다. HTTP 상태가 잘못된 경우(예: 404 - 파일을 찾을 수 없습니다.)에도 전달됩니다.
이 이벤트가 전달되면 주기적 타이머가 0보다 큰 경우 자동으로 재시작됩니다.
DownloadErrorEvent.DOWNLOAD_ERROR 상수는 downloadError 이벤트에 대한 이벤트 객체의 type 속성 값을 정의합니다.
DownloadErrorEvent 객체의 errorID 속성은 오류 정보를 정의하는 정수입니다(다음 표 참조). 추가 subErrorID 속성은 더 많은 오류 정보를 포함할 수 있습니다.
| errorID 오류 코드 | 설명 |
|---|---|
| 16800 | 다운로드한 업데이트 파일의 유효성을 검사하는 동안 발생합니다. subErrorID 속성은 추가 정보를 포함할 수 있습니다. |
| 16801 | 잘못된 Adobe AIR 파일입니다(application.xml 없음). |
| 16802 | 잘못된 Adobe AIR 파일입니다(MIME 유형 없음). |
| 16803 | 잘못된 Adobe AIR 파일입니다(형식). |
| 16804 | 잘못된 Adobe AIR 파일입니다(잘못된 플래그). |
| 16805 | 잘못된 Adobe AIR 파일입니다(알 수 없는 압축). |
| 16806 | 잘못된 Adobe AIR 파일입니다(잘못된 파일 이름). |
| 16807 | 잘못된 Adobe AIR 파일입니다(손상). |
| 16808 | 구성 파일이 없습니다. |
| 16809 | updateURL 속성이 설정되지 않았습니다. |
| 16810 | 예약된 값입니다. |
| 16811 | 잘못된 구성 파일입니다(알 수 없는 구성 버전). |
| 16812 | 잘못된 구성 파일입니다(URL 없음). |
| 16813 | 잘못된 구성 파일입니다(지연 형식). |
| 16814 | 잘못된 구성 파일입니다(잘못된 defaultUI 값). |
| 16815 | 잘못된 업데이트 설명자입니다(알 수 없는 설명자 버전). |
| 16816 | 잘못된 업데이트 설명자입니다(업데이트 버전 없음). |
| 16817 | 잘못된 업데이트 설명자입니다(잘못된 설명). |
| 16818 | 디스크에 데이터를 저장하는 동안 발생하는 IO 오류입니다. subErrorID 속성은 추가 정보를 제공할 수 있습니다. |
| 16819 | 다운로드하는 동안 발생하는 보안 오류입니다. subErrorID 속성은 추가 정보를 제공할 수 있습니다. |
| 16820 | 잘못된 HTTP 상태 코드입니다. subErrorID 속성은 잘못된 상태 코드를 포함할 수 있습니다. |
| 16821 | 예약된 값입니다. |
| 16822 | 다운로드하는 동안 발생하는 I/O 오류입니다. subErrorID 속성은 추가 정보를 제공할 수 있습니다. |
| 16823 | 디스크에 데이터를 저장하는 동안 발생하는 파일 끝 오류입니다. subErrorID 속성은 추가 정보를 제공할 수 있습니다. |
| 16824 | 잘못된 업데이트 설명자입니다. subErrorID 속성은 추가 정보를 제공할 수 있습니다. |
| 16825 | 업데이트 파일에 응용 프로그램 ID가 다른 응용 프로그램이 포함되어 있습니다. |
| 16826 | 업데이트 파일에 새로운 버전의 응용 프로그램이 포함되어 있지 않습니다. |
| 16827 | 업데이트 파일에 포함되어 있는 버전이 업데이트 설명자의 버전과 일치하지 않습니다. |
| 16828 | 일반적으로 응용 프로그램이 ADL(AIR Debug Launcher)에서 실행하기 때문에 응용 프로그램을 업데이트할 수 없습니다. |
| 16829 | 설치할 때 업데이트 파일이 없습니다. |
downloadStart | 이벤트 |
air.update.events.UpdateEvent속성 UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_START| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
downloadUpdate() 메서드가 호출되고 서버에 대한 연결이 설정된 후 전달됩니다. ApplicationUpdater 라이브러리를 사용할 때 이 이벤트에 대한 이벤트 핸들러를 사용하여 사용자가 다운로드 진행률을 알 수 있도록 진행률 막대를 표시할 수 있습니다.
UpdateEvent.DOWNLOAD_START 상수는 downloadStart 이벤트에 대한 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | false |
cancelable | false. 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 업데이트 프로그램 객체입니다. |
error | 이벤트 |
flash.events.ErrorEvent속성 ErrorEvent.type =
flash.events.ErrorEvent.ERROR| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
초기화 또는 업데이트 프로세스 중 예기치 못한 오류가 발생하면 전달됩니다.
error 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | false |
cancelable | false. 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 네트워크 작업에 실패한 객체입니다. |
text | 오류 메시지로 표시될 텍스트입니다. |
fileUpdateError | 이벤트 |
air.update.events.StatusFileUpdateErrorEvent속성 StatusFileUpdateErrorEvent.type =
air.update.events.StatusFileUpdateErrorEvent.FILE_UPDATE_ERROR| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
installFromAIRFile() 메서드에 대한 호출에서 airFile 매개 변수로 전달된 파일의 유효성을 검사하는 동안 오류가 발생하면 전달됩니다.
StatusUpdateErrorEvent.UPDATE_ERROR 상수는 statusUpdateError 이벤트에 대한 이벤트 객체의 type 속성 값을 정의합니다.
fileUpdateStatus | 이벤트 |
air.update.events.StatusFileUpdateEvent속성 StatusFileUpdateEvent.type =
air.update.events.StatusFileUpdateEvent.FILE_UPDATE_STATUS| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 프로그램이 installFromAIRFile() 메서드에 대한 호출에서 파일의 유효성을 성공적으로 검사한 후 전달됩니다.
StatusUpdateEvent.UPDATE_STATUS 상수는 updateStatus 이벤트에 대한 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
available | 현재 응용 프로그램 중 하나와 다른 버전을 사용할 수 있으면 true이고 동일한 버전만 사용할 수 있으면 false입니다. |
path | installFromAIRFile() 메서드에 대한 호출에서 airFile 매개 변수에 의해 지정된 업데이트 File 객체의 nativePath 속성입니다. |
version | 새 업데이트의 버전을 나타냅니다. |
initialized | 이벤트 |
air.update.events.UpdateEvent속성 UpdateEvent.type =
air.update.events.UpdateEvent.INITIALIZED| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
초기화가 완료된 후 전달됩니다.
이 이벤트에는 다음과 같은 읽기 전용 속성이 있습니다.
-
isFirstRun(Boolean). 업데이트 성공 후 처음 실행하는 경우true이고 그렇지 않으면false입니다. -
previousVersion(String). 업그레이드하기 전의 응용 프로그램 이전 버전입니다(isfirstRun이true인 경우에만 설정됨). -
currentVersion(String). 현재 설치된 버전의 응용 프로그램 설명자 파일의 버전입니다.
UpdateEvent.INITIALIZED 상수는 initialized 이벤트에 대한 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | false |
cancelable | false. 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 업데이트 프로그램 객체입니다. |
progress | 이벤트 |
flash.events.ProgressEvent속성 ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 파일이 다운로드되는 동안 전달됩니다.
progress 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | false |
bytesLoaded | 리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다. |
bytesTotal | 로드 프로세스가 완료되면 최종적으로 로드될 총 바이트 수 또는 항목 수입니다. |
cancelable | false. 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 진행률을 보고하는 객체입니다. |
updateError | 이벤트 |
air.update.events.StatusUpdateErrorEvent속성 StatusUpdateErrorEvent.type =
air.update.events.StatusUpdateErrorEvent.UPDATE_ERROR| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 설명자 파일을 다운로드하거나 파싱하는 동안 오류가 발생하면 전달됩니다.
업데이트 프로그램에서 이 이벤트를 전달하면 주기적 타이머가 0보다 큰 경우 자동으로 재시작됩니다. 응용 프로그램에서는 업데이트 프로그램이 새 checkForUpdate 이벤트를 전달할 때 오류 대화 상자를 숨깁니다.
StatusUpdateErrorEvent.UPDATE_ERROR 상수는 statusUpdateError 이벤트에 대한 이벤트 객체의 type 속성 값을 정의합니다.
updateStatus | 이벤트 |
air.update.events.StatusUpdateEvent속성 StatusUpdateEvent.type =
air.update.events.StatusUpdateEvent.UPDATE_STATUS| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.5 |
업데이트 프로그램이 업데이트 설명자 파일을 성공적으로 다운로드하고 해석한 후 전달됩니다.
StatusUpdateEvent.UPDATE_STATUS 상수는 updateStatus 이벤트에 대한 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
available | 업데이트 설명자 파일에서 현재 응용 프로그램의 버전과 다른 버전을 지정하면 true로 설정하고 동일한 버전만 지정하면 false로 설정합니다. |
version | 사용할 수 있는 새 버전을 나타내는 문자열입니다. |
details | 지원되는 각 언어의 details 문자열을 정의하는 배열입니다. 지역화된 설명이 없는 경우 이는 첫 번째 요소가 빈 문자열("")이고 두 번째 요소가 details 문자열인 배열로 정의됩니다. 지역화된 설명이 있는 경우 배열의 각 요소는 두 개의 요소를 포함하는 배열 자체입니다. 첫 번째 요소는 로캘 코드이고 두 번째 요소는 설명입니다. 예를 들어 다음 배열에는 두 언어(미국 영어 및 프랑스어)에 대한 하위 배열이 있습니다. ["en-US", "Hello World"], ["fr", "Bonjour monde"] 언어는 업데이트 설명자와 동일한 순서로 나열됩니다. 세부 사항 속성의 텍스트는 업데이트 설명자 파일에 지정되어 있습니다. |
versionLabel | (AIR 2.5 이상) 업데이트의 응용 프로그램 설명자에서 가져온 버전 레이블입니다. 버전 대신 버전 레이블이 사용자에게 표시되어야 합니다. 버전 레이블이 지정되어 있지 않은 경우 이 속성은 빈 문자열입니다. |
Tue Jun 12 2018, 03:17 PM Z