Updater  - AS3

현재 플랫폼에서 Updater 클래스를 사용할 수 있으면 isSupported 속성이 true로 설정되고, 그렇지 않으면 false로 설정됩니다.

Updater 클래스의 생성자 함수입니다. update() 메서드는 클래스의 static 멤버가 아닙니다. Updater 객체를 인스턴스화하고 이 객체에서 update() 메서드를 호출해야 합니다.

지정된 AIR 파일에 있는 응용 프로그램의 버전으로 현재 실행 중인 응용 프로그램을 업데이트합니다. AIR 파일에 있는 응용 프로그램과 현재 실행 중인 응용 프로그램의 응용 프로그램 식별자(appID)가 동일해야 합니다.

이 메서드를 호출하면 현재 응용 프로그램이 종료됩니다(NativeApplication.exit() 메서드가 호출된 것과 같은 효과). 응용 프로그램이 실행 중인 동안에는 Adobe AIR에서 응용 프로그램을 완전히 업데이트할 수 없기 때문에 이러한 과정이 필요합니다. 응용 프로그램의 새 버전이 설치되면 응용 프로그램이 실행됩니다. 런타임에서 새 버전을 설치할 수 없으면(예: 해당 응용 프로그램 ID가 기존 버전과 일치하지 않는 경우) AIR 설치 프로그램이 사용자에게 오류 메시지를 표시하고 이전 버전이 다시 실행됩니다.

업데이트 성공 여부에 관계없이 업데이트 프로세스는 응용 프로그램을 다시 실행합니다. 업데이트는 다양한 원인으로 실패할 수 있습니다. 이 중에는 응용 프로그램에서 제어할 수 없는 원인이 있을 수도 있습니다(예: 사용자가 응용 프로그램을 설치하는 데 필요한 권한이 없는 경우). 응용 프로그램은 오류를 감지하고 동일한 업데이트 실패를 반복적으로 재시도하지 않도록 해야 합니다. 그러한 무한 루프는 응용 프로그램을 실질적으로 사용 불가능하게 만듭니다. 업데이트가 성공했는지 확인할 수 있는 한 가지 방법은 업데이트를 시작하기 전에 현재 버전 번호를 파일에 기록해 놓은 다음 응용 프로그램이 다시 실행될 때의 버전 번호와 비교하는 것입니다.

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

Mac OS에서는 업데이트된 버전의 응용 프로그램을 설치하려면 사용자가 응용 프로그램 디렉토리에 설치할 수 있는 적절한 시스템 권한을 가지고 있어야 합니다. Windows 또는 Linux에서는 사용자에게 관리 권한이 있어야 합니다.

업데이트된 버전의 응용 프로그램에 업데이트된 버전의 런타임이 필요한 경우에는 새 런타임 버전이 설치됩니다. 런타임을 업데이트하려면 사용자가 컴퓨터에 대한 관리 권한을 가지고 있어야 합니다.

참고: 보안상의 이유로 version 매개 변수를 반드시 지정해야 합니다. 응용 프로그램이 AIR 파일에서 버전 번호를 확인하도록 하면 이미 수정된 보안 취약점을 가지고 있는 이전 버전을 응용 프로그램이 잘못 설치하는 일이 발생하지 않습니다.

매개 변수

관련 API 요소

import flash.fileSystem.File;
import flash.desktop.Updater;
 
var updater:Updater = new Updater();
var airFile:File = File.applicationStorageDirectory.resolvePath("Example Application.air");
var version:String = "2.01";
updater.update(airFile, version);