데스크톱 응용 프로그램 속성 설정

응용 프로그램 설명자 파일에서 기본 응용 프로그램 속성을 설정합니다. 이 섹션에서는 데스크톱 AIR 응용 프로그램과 관련된 속성을 다룹니다. 응용 프로그램 설명자 파일의 요소는 AIR 응용 프로그램 설명자 파일 에서 자세히 설명합니다.

필요한 AIR 런타임 버전

응용 프로그램 설명자 파일의 네임스페이스를 사용하여 응용 프로그램에 필요한 AIR 런타임의 버전을 지정합니다.

응용 프로그램에서 사용할 수 있는 기능을 결정하는 데 가장 큰 영향을 미치는 것은 application 요소에 할당된 네임스페이스입니다. 예를 들어 응용 프로그램에서 AIR 1.5 네임스페이스를 사용하고 사용자에게 AIR 3.0가 설치되어 있는 경우 응용 프로그램은 AIR 1.5 비헤이비어를 인식하며, 이는 해당 비헤이비어가 AIR 3.0에서 변경된 경우에도 마찬가지입니다. 네임스페이스를 변경하고 업데이트를 제작할 경우에만 응용 프로그램이 새로운 비헤이비어 및 기능에 액세스하게 됩니다. 이 정책의 주요 예외는 보안 및 WebKit 변경 사항입니다.

루트 application 요소의 xmlns 특성을 사용하여 네임스페이스를 지정합니다. 

<application xmlns="http://ns.adobe.com/air/application/3.0">

응용 프로그램 ID

제작하는 각 응용 프로그램에 대해 여러 설정이 고유해야 합니다. 고유 설정에는 ID, 이름 및 파일 이름이 포함됩니다. 

<id>com.example.MyApplication</id> 
<name>My Application</name> 
<filename>MyApplication</filename>

응용 프로그램 버전

AIR 2.5 미만의 AIR 버전에서는 version 요소에서 응용 프로그램을 지정합니다. 어떠한 문자열이라도 사용할 수 있습니다. AIR 런타임은 문자열을 해석하지 않습니다. 따라서 “2.0”은 “1.0”보다 높은 버전으로 취급되지 않습니다. 

<!-- AIR 2 or earlier --> 
<version>1.23 Beta 7</version>

AIR 2.5 이상에서는 versionNumber 요소에서 응용 프로그램 버전을 지정합니다. version 요소는 더 이상 사용할 수 없습니다. versionNumber 값을 지정할 때는 최대 세 개의 숫자로 이루어진 시퀀스를 사용해야 하며 이때 각 숫자는 점으로 분리해야 합니다(예: “0.1.2”). 버전 번호의 각 세그먼트는 최대 세 자리까지 가능합니다. 즉, “999.999.999”가 허용되는 가장 큰 버전 번호입니다. 번호에 세 세그먼트를 모두 포함해야 하는 것은 아닙니다. 따라서 “1” 및 “1.0”도 유효한 버전 번호입니다.

versionLabel 요소를 사용하여 버전에 대한 레이블을 지정할 수도 있습니다. 버전 레이블을 추가하면 AIR 응용 프로그램 설치 대화 상자 등의 위치에서 버전 번호 대신 표시됩니다. 

<!-- AIR 2.5 and later --> 
<versionNumber>1.23.7<versionNumber> 
<versionLabel>1.23 Beta 7</versionLabel>

기본 윈도우 속성

AIR는 데스크톱에서 응용 프로그램을 시작할 때 윈도우를 만들고 기본 SWF 파일 또는 HTML 페이지를 그 안에 로드합니다. AIR는 initialWindow 요소의 자식 요소를 사용하여 이 초기 응용 프로그램 윈도우의 모양 및 비헤이비어를 제어합니다.

  • content - initalWindow 요소의 content 자식에 있는 기본 응용 프로그램 SWF 파일입니다. 데스크톱 프로파일에 있는 장치를 대상으로 지정하는 경우 SWF 또는 HTML 파일을 사용할 수 있습니다. 

    <initialWindow> 
    <content>MyApplication.swf</content> 
</initialWindow>

    파일을 AIR 패키지에 포함해야 합니다(ADT 또는 IDE 사용). 단순히 응용 프로그램 설명자에 있는 이름을 참조하는 것만으로는 파일이 패키지에 자동으로 포함되지 않습니다.

  • depthAndStencil - 심도 또는 스텐실 버퍼를 사용하도록 지정합니다. 일반적으로 이러한 버퍼는 3D 내용으로 작업하는 경우에 사용합니다. 

    <depthAndStencil>true</depthAndStencil>

  • height - 초기 윈도우의 높이입니다.

  • maximizable - 윈도우를 최대화하기 위한 시스템 크롬이 표시되는지 여부입니다.

  • maxSize - 허용되는 최대 크기입니다.

  • minimizable - 윈도우를 최소화하기 위한 시스템 크롬이 표시되는지 여부입니다.

  • minSize - 허용되는 최소 크기입니다.

  • renderMode - AIR 3 이상에서 데스크톱 응용 프로그램에 대한 렌더링 모드를 auto , cpu , direct 또는 gpu 로 설정할 수 있습니다. 이전 버전 AIR의 경우 이 설정은 데스크톱 플랫폼에서 무시됩니다. 런타임에는 renderMode 설정을 변경할 수 없습니다.

    • auto - 기본적으로 cpu 모드와 동일합니다.

    • cpu - 표시 객체가 소프트웨어의 표시 메모리에 렌더링 및 복사됩니다. 윈도우가 전체 화면 모드인 경우에만 StageVideo를 사용할 수 있습니다. Stage3D는 소프트웨어 렌더러를 사용합니다.

    • direct - 표시 객체는 런타임 소프트웨어에 의해 렌더링되지만 렌더링된 프레임을 표시 메모리에 복사(블록 전송)하는 것은 하드웨어 가속을 통해 수행됩니다. StageVideo를 사용할 수 있습니다. Stage3D는 가능한 경우 하드웨어 가속을 사용합니다. 윈도우 투명도가 true로 설정된 경우 윈도우는 소프트웨어 렌더링 및 블록 전송으로 변경됩니다.

      참고: 모바일 플랫폼용 AIR와 함께 Flash 내용의 GPU 가속 기능을 활용하려면 renderMode="gpu" 대신 renderMode="direct"(즉, Stage3D)를 사용하는 것이 좋습니다. Adobe에서는 Stage3D 기반 프레임워크인 Starling(2D)과 Away3D(3D)를 공식적으로 지원 및 권장합니다. Stage3D와 Starling/Away3D에 대한 자세한 내용은 http://gaming.adobe.com/getstarted/ 를 참조하십시오.

    • gpu - 가능한 경우 하드웨어 가속이 사용됩니다.

  • requestedDisplayResolution - 고해상도 화면을 사용하는 MacBook Pro 컴퓨터에서 응용 프로그램이 표준 해상도를 사용할 것인지 고 해상도를 사용할 것인지를 지정합니다. 그 외 모든 플랫폼에서는 이 값이 무시됩니다. 값이 standard 이면 화면의 각 스테이지 픽셀이 네 픽셀로 렌더링됩니다. 값이 high 이면 화면의 각 스테이지 픽셀이 물리적인 한 픽셀에 해당합니다. 지정된 값은 모든 응용 프로그램 윈도우에 사용됩니다. 데스크톱 AIR 응용 프로그램에 requestedDisplayResolution 요소를 intialWindow 요소의 자식으로 사용하는 것은 AIR 3.6 이상에서 가능합니다.

  • resizable - 윈도우 크기를 조정하기 위한 시스템 크롬이 표시되는지 여부입니다.

  • systemChrome - 표준 운영 체제 윈도우 드레싱이 사용되는지 여부입니다. 런타임에는 윈도우의 systemChrome 설정을 변경할 수 없습니다.

  • title - 윈도우의 제목입니다.

  • transparent - 윈도우가 배경에 대해 알파-블렌드되는지 여부입니다. 투명도가 설정되어 있으면 윈도우가 시스템 크롬을 사용할 수 없습니다. 런타임에는 윈도우의 transparent 설정을 변경할 수 없습니다.

  • visible - 윈도우가 생성되는 즉시 표시되는지 여부입니다. 기본적으로 처음에는 윈도우가 표시되지 않는데, 이를 통해 응용 프로그램에서는 윈도우를 표시하기 전에 먼저 내용을 그릴 수 있습니다.

  • width - 윈도우의 폭입니다.

  • x - 윈도우의 가로 위치입니다.

  • y - 윈도우의 세로 위치입니다.

데스크톱 기능

다음 요소는 데스크톱 설치 및 업데이트 기능을 제어합니다.

  • customUpdateUI - 응용 프로그램을 업데이트하기 위한 대화 상자를 직접 만들어서 제공할 수 있도록 합니다. 기본값인 false 로 설정되어 있으면 표준 AIR 대화 상자가 사용됩니다.

  • fileTypes - 응용 프로그램에서 기본 시작 응용 프로그램으로 등록할 파일의 유형을 지정합니다. 다른 응용 프로그램이 이미 해당 파일 유형의 시작 응용 프로그램인 경우 AIR는 기존 등록을 무시하지 않습니다. 하지만 응용 프로그램은 NativeApplication 객체의 setAsDefaultApplication() 메서드를 사용하여 런타임에 등록을 무시할 수 있습니다. 기존 파일 유형 관계를 무시하기 전에 사용자의 허가를 구하는 것이 좋습니다.

    참고: 응용 프로그램을 전용 런타임 번들로 패키지화할 경우( -bundle 대상 사용) 파일 형식 등록이 무시됩니다. 지정된 파일 형식을 등록하려면 등록을 수행하는 설치 프로그램을 만들어야 합니다.

  • installFolder - 응용 프로그램이 설치되는 표준 응용 프로그램 설치 폴더에 상대적인 경로를 지정합니다. 이 설정을 사용하여 사용자 정의 폴더 이름을 제공하고 여러 응용 프로그램을 공통 폴더 안에 그룹화할 수 있습니다.

  • programMenuFolder - Windows [모든 프로그램] 메뉴의 메뉴 계층 구조를 지정합니다. 이 설정을 사용하여 여러 응용 프로그램을 공통 메뉴 안에 그룹화할 수 있습니다. 메뉴 폴더가 지정되어 있지 않으면 응용 프로그램 단축키가 기본 메뉴에 바로 추가됩니다.

지원되는 프로파일

응용 프로그램이 데스크톱에만 적합한 경우 지원되는 프로파일 목록에서 해당 프로파일을 제외하는 방식으로 다른 프로파일에 있는 장치에 설치되지 않도록 할 수 있습니다. 응용 프로그램에서 NativeProcess 클래스 또는 기본 확장을 사용하는 경우 extendedDesktop 프로파일을 지원해야 합니다.

응용 프로그램 설명자에 supportedProfile 요소를 넣지 않으면 응용 프로그램이 정의된 모든 프로파일을 지원하는 것으로 가정합니다. 특정 프로파일 목록으로 응용 프로그램을 제한하려면 프로파일을 공백으로 분리하여 나열하십시오. 

<supportedProfiles>desktop extendedDesktop</supportedProfiles>

desktop 및 extendedDesktop 프로파일에서 지원되는 ActionScript 클래스의 목록에 대해서는 각 프로파일의 기능 을 참조하십시오.

필수 기본 확장

extendedDesktop 프로파일을 지원하는 응용 프로그램에서는 기본 확장을 사용할 수 있습니다.

응용 프로그램 설명자에서 AIR 응용 프로그램이 사용하는 모든 기본 확장을 선언합니다. 다음 예제에서는 두 개의 필수 기본 확장을 지정하기 위한 구문을 보여 줍니다. 

<extensions> 
     <extensionID>com.example.extendedFeature</extensionID> 
    <extensionID>com.example.anotherFeature</extensionID> 
</extensions>

extensionID 요소의 값은 확장 설명자 파일에서 id 요소의 값과 동일합니다. 확장 설명자 파일은 extension.xml이라는 XML 파일로, 이 파일은 기본 확장 개발자로부터 받는 ANE 파일에 패키지화되어 있습니다.

응용 프로그램 아이콘

데스크톱에서 응용 프로그램 설명자로 지정된 아이콘은 응용 프로그램 파일, 단축키 및 프로그램 메뉴 아이콘으로 사용됩니다. 응용 프로그램 아이콘은 16x16, 32x32, 48x48 및 128x128 픽셀 PNG 이미지 집합으로 제공되어야 합니다. 응용 프로그램 설명자 파일의 아이콘 요소에서 아이콘 파일의 경로를 지정합니다. 

<icon> 
    <image16x16>assets/icon16.png</image16x16> 
    <image32x32>assets/icon32.png</image32x32> 
    <image48x48>assets/icon48.png</image48x48> 
    <image128x128>assets/icon128.png</image128x128> 
</icon>

지정된 크기의 아이콘을 제공하지 않으면 그 다음으로 가장 큰 아이콘이 지정된 크기에 맞게 조정되어 사용됩니다. 아이콘을 하나도 제공하지 않으면 기본 시스템 아이콘이 사용됩니다.

무시되는 설정

데스크톱의 응용 프로그램은 모바일 프로파일 기능에 적용되는 응용 프로그램 설정을 무시합니다. 무시되는 설정은 다음과 같습니다.

  • android

  • aspectRatio

  • autoOrients

  • fullScreen

  • iPhone

  • renderMode(AIR 3 이전)

  • requestedDisplayResolution

  • softKeyboardBehavior