업데이트 설명자 파일 정의 및 웹 서버에 AIR 파일 추가

AIR 업데이트 프레임워크를 사용할 때는 웹 서버에 저장된 업데이트 설명자 파일에 사용 가능한 업데이트에 대한 기본 정보를 정의합니다. 업데이트 설명자 파일은 간단한 XML 파일입니다. 응용 프로그램에 포함된 업데이트 프레임워크는 이 파일을 확인하여 새 버전이 업로드되었는지 확인합니다.

업데이트 설명자 파일의 포맷은 AIR 2.5에서 변경되었습니다. 새로운 포맷은 다른 네임스페이스를 사용합니다. 원래의 네임스페이스는 “http://ns.adobe.com/air/framework/update/description/1.0”입니다. AIR 2.5 네임스페이스는 “http://ns.adobe.com/air/framework/update/description/2.5”입니다.

AIR 2.5 이전에 생성된 AIR 응용 프로그램은 버전 1.0 업데이트 설명자만 읽을 수 있습니다. AIR 2.5 이상에 포함된 업데이터 프레임워크를 사용하여 생성된 AIR 응용 프로그램은 버전 2.5 업데이트 설명자만 읽을 수 있습니다. 이러한 버전 비호환성 때문에 종종 두 개의 업데이트 설명자 파일을 만들어야 합니다. AIR 2.5 버전의 응용 프로그램에 있는 업데이트 논리는 새 포맷을 사용하는 업데이트 설명자를 다운로드해야 합니다. 이전 버전의 AIR 응용 프로그램은 계속 원래의 포맷을 사용해야 합니다. AIR 2.5 이전에 만든 버전에 대한 지원을 중지하기 전까지 업데이트를 릴리스할 때마다 두 파일을 모두 수정해야 합니다.

업데이트 설명자 파일에는 다음 데이터가 포함됩니다.

  • versionNumber - AIR 응용 프로그램의 새 버전입니다. AIR 2.5 응용 프로그램을 업데이트하는 데 사용된 업데이트 설명자에서 versionNumber 요소를 사용합니다. 이 값은 새 AIR 응용 프로그램 설명자 파일의 versionNumber 요소에 사용된 것과 동일한 문자열이어야 합니다. 업데이트 설명자 파일의 버전 번호가 업데이트 AIR 파일의 버전 번호와 일치하지 않으면 업데이트 프레임워크에서 예외가 발생합니다.

  • version - AIR 응용 프로그램의 새 버전입니다. AIR 2.5 이전에 만든 응용 프로그램을 업데이트하는 데 사용된 업데이트 설명자에서 version 요소를 사용합니다. 이 값은 새 AIR 응용 프로그램 설명자 파일의 version 요소에 사용된 것과 동일한 문자열이어야 합니다. 업데이트 설명자 파일의 버전이 업데이트 AIR 파일의 버전과 일치하지 않으면 업데이트 프레임워크에서 예외가 발생합니다.

  • versionLabel - 사용자에게 표시하기 위한 목적의, 사람이 읽을 수 있는 버전 문자열입니다. versionLabel 은 선택 사항이지만, 버전 2.5 업데이트 설명자 파일에서만 지정될 수 있습니다. 응용 프로그램 설명자에서 versionLabel 을 사용하는 경우에만 사용하고 같은 값으로 설정하십시오.

  • url - 업데이트 AIR 파일의 위치입니다. 이 파일은 AIR 응용 프로그램의 업데이트 버전을 포함합니다.

  • description - 새 버전과 관련된 세부 사항입니다. 이 정보는 업데이트 프로세스 중에 사용자에게 표시될 수 있습니다.

version 및 url 요소는 필수이고, description 요소는 선택 사항입니다.

다음은 샘플 버전 2.5 업데이트 설명자 파일입니다. 

<?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/2.5"> 
       <versionNumber>1.1.1</versionNumber> 
       <url>http://example.com/updates/sample_1.1.1.air</url> 
       <description>This is the latest version of the Sample application.</description> 
    </update>

그리고 다음은 샘플 버전 1.0 업데이트 설명자 파일입니다. 

<?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/1.0"> 
       <version>1.1.1</version> 
       <url>http://example.com/updates/sample_1.1.1.air</url> 
       <description>This is the latest version of the Sample application.</description> 
    </update>

여러 언어를 사용하여 description 태그를 정의하려면 lang 특성을 정의하는 여러 text 요소를 사용합니다. 

<?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/2.5"> 
       <versionNumber>1.1.1</versionNumber> 
       <url>http://example.com/updates/sample_1.1.1.air</url> 
       <description> 
           <text xml:lang="en">English description</text> 
           <text xml:lang="fr">French description</text> 
           <text xml:lang="ro">Romanian description</text> 
       </description> 
    </update>

업데이트 설명자 파일을 업데이트 AIR 파일과 함께 웹 서버에 배치합니다.

업데이트 설명자에 포함된 templates 디렉토리에는 샘플 업데이트 설명자 파일이 포함됩니다. 여기에는 단일 언어 버전과 여러 언어 버전이 모두 포함됩니다.