ApplicationUpdaterUI  - AS3

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 속성을 설정할 수 있습니다.

관련 API 요소

응용 프로그램의 현재 버전입니다. 이 속성은 initialize() 메서드를 호출하는 동안 설정됩니다. 응용 프로그램 설명자 파일의 버전으로 설정됩니다.

새 업데이트의 주기적 검사 간격(일)입니다.

값을 0(기본값)으로 지정하면 타이머가 활성화되지 않으므로 주기적 검사가 수행되지 않습니다. 이 속성 또는 구성 파일을 통해 지연을 설정할 수 있습니다. 두 메서드를 사용하여 값을 설정하면 이 속성을 사용하는 값 설정이 사용됩니다.

기본값: 0.

관련 API 요소

[업데이트 확인], [업데이트 없음] 및 [업데이트 오류] 대화 상자의 가시성을 활성화합니다. true로 설정하면 업데이트 프로그램에서 업데이트 프로세스의 일부로 이러한 대화 상자를 표시합니다. 업데이트 구성 파일에서도 설정할 수 있습니다. 이 속성을 사용하여 설정한 값은 업데이트 구성 파일의 설정보다 우선합니다.

[다운로드 업데이트] 대화 상자의 가시성을 활성화합니다. true로 설정하면 업데이트 프로그램에서 업데이트 프로세스의 일부로 이 대화 상자를 표시합니다. 업데이트 구성 파일에서도 설정할 수 있습니다. 이 속성을 사용하여 설정한 값은 업데이트 구성 파일의 설정보다 우선합니다.

[다운로드 업데이트] 대화 상자의 가시성을 활성화합니다. true로 설정하면 업데이트 프로그램에서 업데이트 프로세스의 일부로 이러한 대화 상자를 표시합니다. 업데이트 구성 파일에서도 설정할 수 있습니다. 이 속성을 사용하여 설정한 값은 업데이트 구성 파일의 설정보다 우선합니다.

[파일 업데이트], [파일 업데이트 없음] 및 [파일 오류] 대화 상자의 가시성을 활성화합니다. true로 설정하면 업데이트 프로그램에서 업데이트 프로세스의 일부로 이러한 대화 상자를 표시합니다. 업데이트 구성 파일에서도 설정할 수 있습니다. 이 속성을 사용하여 설정한 값은 업데이트 구성 파일의 설정보다 우선합니다.

업데이트 성공 후 처음 실행하는 것인지(true) 아닌지(false)를 나타냅니다. 업데이트 프로그램에서 initialize() 메서드를 호출하는 동안 이 값을 설정합니다. 데이터를 한 버전에서 다른 버전으로 마이그레이션해야 할 경우 개발자는 isFirstRun이 true로 설정되었는지 확인해야 합니다.

관련 API 요소

[업데이트 설치] 대화 상자의 가시성을 활성화합니다. true로 설정하면 업데이트 프로그램에서 업데이트 프로세스의 일부로 이 대화 상자를 표시합니다. 업데이트 구성 파일에서도 설정할 수 있습니다. 이 속성을 사용하여 설정한 값은 업데이트 구성 파일의 설정보다 우선합니다.

업데이트 프로그램이 버전 비교를 수행할 때 사용하는 기능입니다. 기본적으로 업데이트 프레임워크는 설치된 응용 프로그램의 버전보다 원격 사이트의 버전이 최신인지 확인하기 위해 버전 비교를 수행합니다. 그러나 기본 비교 방법이 개발자의 버전 지정 방법과 맞지 않을 수 있습니다. 비교를 수행하는 새 함수를 제공하려면 이 속성을 설정합니다.

기본 비교 함수는 x.y.z 등의 버전을 사용합니다. 여기서 x, y 및 z에는 문자와 숫자가 포함될 수 있습니다. 기본 비교 함수에서 인식하는 몇 가지 특수 조건이 있습니다. test 함수가 버전 문자열에서 "alpha", "beta" 또는 "rc"를 찾으면 순서가 alpha < beta < rc가 됩니다.

appUpdate.isNewerVersionFunction = customFn; 

function customFn (currentVersion:String, updateVersion:String):Boolean 
{
    return updateVersion > currentVersion;
}

[예기치 않은 오류] 대화 상자의 가시성을 활성화합니다. true로 설정하면 응용 프로그램 업데이트 프로그램에서 업데이트 프로세스의 일부로 이 대화 상자를 표시합니다. 업데이트 구성 파일에서도 설정할 수 있습니다. 이 속성을 사용하여 설정한 값은 업데이트 구성 파일의 설정보다 우선합니다.

업데이트가 실행 중이면 true이고 그렇지 않으면 false인 부울 속성입니다.

사용자 인터페이스에서 사용하는 로캘 체인을 정의하는 배열입니다. 일반적으로 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;

관련 API 요소

업데이트 후 변경된 경우 응용 프로그램 저장소 디렉토리의 이전 위치입니다. 인증서 마이그레이션이 포함된 업그레이드 후에는 응용 프로그램 저장소 디렉토리 위치가 변경됩니다. 인증서 마이그레이션이 없는 경우 사용자가 응용 프로그램을 업데이트할 때 응용 프로그램 저장소 디렉토리가 변경되지 않습니다. 또한 이 속성이 null로 설정됩니다. 이 속성은 initialize() 메서드를 호출하는 동안 설정됩니다.

개발자가 ADT를 사용하여 AIR 파일을 패키지화할 때 -migrate 옵션을 사용할 경우 새 버전의 AIR 응용 프로그램에 새로운 인증서로 서명할 수 있습니다. 새 버전의 AIR 응용 프로그램에서 새 서명 인증서를 사용하는 경우 사용자가 새 버전을 설치하면 응용 프로그램의 로컬 저장소 디렉토리가 변경됩니다. 이 속성을 사용하여 이전 응용 프로그램 저장소 디렉토리에서 새 응용 프로그램 저장소 디렉토리(File.applicationStorageDirectory)로 데이터를 전송합니다. 자세한 내용은 Adobe AIR 개발자 안내서의 "명령줄 도구를 사용하여 AIR 응용 프로그램 만들기" 장에서 "AIR 파일에 서명하여 응용 프로그램 인증서 변경"을 참조하십시오.

응용 프로그램의 이전 버전입니다. 이 속성은 initialize() 메서드를 호출하는 동안 설정됩니다. 업그레이드 전 응용 프로그램의 이전 버전을 반환합니다. isfirstRun이 true인 경우에만 설정되고 그렇지 않은 경우 null로 설정됩니다.

업데이트 URL에서 다운로드된 업데이트 설명자 파일의 내용입니다. 이 속성은 업데이트 프로그램 객체가 updateStatus 이벤트를 전달한 후에만 null이 아닙니다.

업데이트 설명자 파일의 위치입니다. URLRequest 경로에 유효한 위치가 사용됩니다. 업데이트 프로그램에서 필요로 하는 유일한 필수 설정입니다. 이 속성 또는 구성 파일을 통해 업데이트 URL을 설정할 수 있습니다. 두 메서드를 사용하여 값을 설정하면 업데이트 프로그램에서 이 속성을 사용하는 값 설정을 사용합니다.

관련 API 요소

연기된 업데이트가 있는 경우 설치에 실패했더라도 true로 설정되고, 그렇지 않으면 false로 설정됩니다. 업데이트 프로그램에서 initialize() 메서드를 호출하는 동안 이 속성을 설정합니다. wasPendingUpdate 및 isFirstRun 속성을 사용하여 업데이트를 설치하지 못했는지를 확인합니다. 설치하지 못한 경우 wasPendingUpdate가 true, isFirstRun이 false로 설정됩니다.

관련 API 요소

생성자 함수입니다.

지정된 언어에 대한 새 리소스 번들을 동적으로 추가합니다. JavaScript 개발자는 이 메서드를 사용하여 응용 프로그램 업데이트 프로그램 UI에 표시되는 새 언어를 동적으로 추가합니다. Flex 개발자는 "ApplicationUpdaterDialogs" 리소스 번들에 새 언어를 직접 추가할 수 있습니다.

매개 변수

관련 API 요소

업데이트 프로세스를 취소합니다. 이 메서드를 호출하면 대기 중인 다운로드가 취소되고 완료되지 않은 다운로드 파일이 모두 삭제되며 주기적 검사 타이머가 재시작됩니다.

시스템 상태가 "uninitialized" 또는 "initializing"인 경우를 제외하면 언제든지 업데이트 프로세스를 취소할 수 있습니다. "uninitialized" 또는 "initializing" 상태일 때 호출하면 아무런 동작도 일어나지 않습니다.

업데이트 프로세스를 시작합니다. 이 메서드를 호출해도 주기적 타이머가 중지되지 않습니다. 그러나 업데이트 프로세스가 실행 중인지 확인하여 현재 반복을 생략합니다.

이 메서드는 현재 상태가 "Ready"인 경우에만 실행됩니다.

이 메서드를 실행하면 업데이트 프로그램 객체에서 다음 이벤트를 전달합니다.

업데이트 프로그램을 초기화합니다. 이 메서드를 호출하면 다음 동작이 일어납니다.

1. 업데이트 프레임워크를 초기화하고 대기 중인 업데이트를 자동으로 그리고 동기적으로 설치합니다. 이 메서드를 호출하면 응용 프로그램이 재시작될 수 있으므로 응용 프로그램 설치 전에 호출해야 합니다.

2. 연기된 업데이트가 있는지 확인한 다음 설치합니다.

3. 이전 업데이트 시 오류가 발생한 경우 저장 영역에서 해당 업데이트 파일과 버전 정보를 지웁니다.

4. 주기적 타이머 지연이 만료된 경우 업데이트 프로세스를 시작하고 그렇지 않은 경우 주기적 타이머를 시작합니다. 그러나 ADL(AIR Debug Launcher) 응용 프로그램을 사용하여 응용 프로그램을 테스트할 때 응용 프로그램을 업데이트하면 IllegalOperationError 예외가 발생합니다.

로컬 AIR 파일을 사용하여 업데이트 프로세스를 시작합니다.

업데이트 프로세스가 실행 중일 때, 즉 "Downloaded" 상태가 아닌 경우 이 메서드를 호출하면 아무런 동작도 일어나지 않습니다.

이 함수는 응용 프로그램 설명자 파일에서 customUpdateUI 요소가 true로 설정된 응용 프로그램에 유용합니다.

ADL(AIR Debug Launcher) 응용 프로그램을 사용하여 응용 프로그램을 테스트할 때 이 메서드를 호출하면 IllegalOperationError 예외가 발생합니다.

매개 변수

업데이트를 설치하기 전 installUpdate() 메서드가 호출된 후에 전달됩니다. 사용자가 업데이트를 설치하기 위해 런타임으로 응용 프로그램을 종료하면 현재 작업을 잃을 수 있으므로 업데이트 설치를 나중으로 미뤄야 할 때가 있습니다.

이 이벤트의 preventDefault() 메서드를 호출하면 다음에 재시작할 때까지 설치가 연기됩니다. preventDefault() 메서드를 호출하면 installUpdate() 메서드 호출 또는 주기적 검사로 인해 이 응용 프로그램 세션 동안 추가 업데이트 프로세스를 시작할 수 없습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

업데이트 프로세스가 시작되기 전, 업데이트 설명자 파일을 다운로드하기 직전에 전달됩니다. checkNow() 메서드를 직접 호출하거나 주기적 검사 타이머가 만료된 경우 업데이트 프로그램에서 이 이벤트를 전달합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

업데이트 파일 다운로드가 완료되면 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

업데이트 파일을 연결하거나 다운로드하는 동안 오류가 발생하면 전달됩니다. HTTP 상태가 잘못된 경우(예: 404 - 파일을 찾을 수 없습니다.)에도 전달됩니다.

이 이벤트가 전달되면 주기적 타이머가 0보다 큰 경우 자동으로 재시작됩니다.

DownloadErrorEvent 객체의 errorID 속성은 오류 정보를 정의하는 정수입니다(다음 표 참조). 추가 subErrorID 속성은 더 많은 오류 정보를 포함할 수 있습니다.

downloadUpdate() 메서드가 호출되고 서버에 대한 연결이 설정된 후 전달됩니다. ApplicationUpdater 라이브러리를 사용할 때 이 이벤트에 대한 이벤트 핸들러를 사용하여 사용자가 다운로드 진행률을 알 수 있도록 진행률 막대를 표시할 수 있습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

초기화 또는 업데이트 프로세스 중 예기치 못한 오류가 발생하면 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

installFromAIRFile() 메서드에 대한 호출에서 airFile 매개 변수로 전달된 파일의 유효성을 검사하는 동안 오류가 발생하면 전달됩니다.

업데이트 프로그램이 installFromAIRFile() 메서드에 대한 호출에서 파일의 유효성을 성공적으로 검사한 후 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

초기화가 완료된 후 전달됩니다.

이 이벤트에는 다음과 같은 읽기 전용 속성이 있습니다.

• isFirstRun(Boolean). 업데이트 성공 후 처음 실행하는 경우 true이고 그렇지 않으면 false입니다.

• previousVersion(String). 업그레이드하기 전의 응용 프로그램 이전 버전입니다(isfirstRun이 true인 경우에만 설정됨).

• currentVersion(String). 현재 설치된 버전의 응용 프로그램 설명자 파일의 버전입니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

업데이트 파일이 다운로드되는 동안 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

업데이트 설명자 파일을 다운로드하거나 파싱하는 동안 오류가 발생하면 전달됩니다.

업데이트 프로그램에서 이 이벤트를 전달하면 주기적 타이머가 0보다 큰 경우 자동으로 재시작됩니다. 응용 프로그램에서는 업데이트 프로그램이 새 checkForUpdate 이벤트를 전달할 때 오류 대화 상자를 숨깁니다.

업데이트 프로그램이 업데이트 설명자 파일을 성공적으로 다운로드하고 해석한 후 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.