XML 구성 파일에서 업데이트 설정 정의

업데이트 구성 파일은 XML 파일이며, 다음 요소를 포함할 수 있습니다.

updateURL - 문자열입니다. 원격 서버에 있는 업데이트 설명자의 위치를 나타냅니다. 유효한 URLRequest 위치를 사용할 수 있습니다. 구성 파일이나 스크립트를 통해 updateURL 속성을 정의해야 합니다( 업데이트 설명자 파일 정의 및 웹 서버에 AIR 파일 추가 참조). 업데이트 프로그램을 사용하기 전에 즉, 업데이트 프로그램 초기화 에서 설명한 대로 업데이트 프로그램 객체의 initialize() 메서드를 호출하기 전에 이 속성을 정의해야 합니다.
delay - 숫자입니다. 업데이트를 확인하는 시간 간격(일)입니다. 예를 들어 0.25 와 같은 값을 사용할 수 있습니다. 값이 0(기본값)이면 업데이트 프로그램이 자동 정기 확인을 수행하지 않습니다.

ApplicationUpdaterUI의 구성 파일에는 updateURL 및 delay 요소와 함께 다음 요소가 포함될 수 있습니다.

defaultUI : dialog 요소 목록입니다. 각 dialog 요소에는 사용자 인터페이스의 대화 상자에 해당하는 name 특성이 있습니다. 각 dialog 요소에는 대화 상자가 표시되는지 여부를 정의하는 visible 특성이 있습니다. 기본값은 true 입니다. name 특성에 사용할 수 있는 값은 다음과 같습니다.
- "checkForUpdate" - 업데이트 확인, 업데이트 없음 및 업데이트 오류 대화 상자에 해당합니다.
- "downloadUpdate" - 업데이트 다운로드 대화 상자에 해당합니다.
- "downloadProgress" - 다운로드 진행률 및 다운로드 오류 대화 상자에 해당합니다.
- "installUpdate" - 업데이트 설치 대화 상자에 해당합니다.
- "fileUpdate" - 파일 업데이트, 파일 업데이트 없음 및 파일 오류 대화 상자에 해당합니다.
"unexpectedError" - 예기치 않은 오류 대화 상자에 해당합니다.

false 로 설정할 경우 해당하는 대화 상자가 업데이트 절차의 일부로 표시되지 않습니다.

다음은 ApplicationUpdater 프레임워크의 구성 파일 예제입니다.

<?xml version="1.0" encoding="utf-8"?> 
<configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0"> 
      <url>http://example.com/updates/update.xml</url> 
      <delay>1</delay> 
</configuration>

다음은 defaultUI 요소에 대한 정의를 포함하는 ApplicationUpdaterUI 프레임워크의 구성 파일 예제입니다.

<?xml version="1.0" encoding="utf-8"?> 
<configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0"> 
      <url>http://example.com/updates/update.xml</url> 
      <delay>1</delay> 
      <defaultUI> 
         <dialog name="checkForUpdate" visible="false" /> 
         <dialog name="downloadUpdate" visible="false" /> 
         <dialog name="downloadProgress" visible="false" /> 
      </defaultUI> 
</configuration>

configurationFile 속성을 해당 파일의 위치로 지정합니다.

ActionScript 예제:

appUpdater.configurationFile = new File("app:/cfg/updateConfig.xml");

JavaScript 예제:

appUpdater.configurationFile = new air.File("app:/cfg/updateConfig.xml");

업데이트 프레임워크의 templates 디렉토리에는 샘플 구성 파일 config-template.xml이 포함됩니다.