AIR 응용 프로그램 설명자 요소

다음의 요소 사전에서는 AIR 응용 프로그램 설명자 파일의 각 유효 요소에 대해 설명합니다.

allowBrowserInvocation

AIR 인 브라우저 API가 응용 프로그램을 감지하고 실행할 수 있도록 합니다.

이 값을 true로 설정하는 경우 보안 영향을 고려해야 합니다. 이러한 보안 영향은 브라우저에서 AIR 응용 프로그램 호출(ActionScript 개발자용) 및 Invoking an AIR application from the browser(HTML 개발자용)에 설명되어 있습니다.

자세한 내용은 브라우저에서 설치된 AIR 응용 프로그램 시작을 참조하십시오.

부모 요소:application

자식 요소: 없음

내용

true 또는 false(기본값)

예제

<allowBrowserInvocation>true</allowBrowserInvocation>

android

Android 매니페스트 파일에 요소를 추가할 수 있도록 합니다. AIR는 모든 APK 패키지에 대해 AndroidManifest.xml 파일을 만듭니다. AIR 응용 프로그램 설명자에서 android 요소를 사용하여 항목을 더 추가할 수 있습니다. Android를 제외한 모든 플랫폼에서 무시됩니다.

부모 요소:application

자식 요소:

내용

Android 응용 프로그램 매니페스트에 추가할 Android 관련 속성을 정의하는 요소

예제

<android> 
    <manifestAdditions> 
        ... 
    </manifestAdditions> 
</android>

application

AIR 응용 프로그램 설명자 문서의 루트 요소입니다.

부모 요소: 없음

자식 요소:

특성

minimumPatchLevel - 이 응용 프로그램에 필요한 AIR 런타임 최소 패치 수준입니다.

xmlns - 이 XML 네임스페이스 특성에 따라 응용 프로그램의 필수 AIR 런타임 버전이 결정됩니다.

이 네임스페이스는 보조 패치가 아니라 AIR의 주요 릴리스가 출시될 때마다 변경됩니다. "3.0"과 같은 네임스페이스의 마지막 세그먼트는 응용 프로그램에 필요한 런타임 버전을 나타냅니다.

주요 AIR 릴리스의 xmlns 값은 다음과 같습니다.

xmlns="http://ns.adobe.com/air/application/1.0" 
xmlns="http://ns.adobe.com/air/application/1.1" 
xmlns="http://ns.adobe.com/air/application/1.5" 
xmlns="http://ns.adobe.com/air/application/1.5.2" 
xmlns="http://ns.adobe.com/air/application/1.5.3" 
xmlns="http://ns.adobe.com/air/application/2.0" 
xmlns="http://ns.adobe.com/air/application/2.5" 
xmlns="http://ns.adobe.com/air/application/2.6" 
xmlns="http://ns.adobe.com/air/application/2.7" 
xmlns="http://ns.adobe.com/air/application/3.0" 
xmlns="http://ns.adobe.com/air/application/3.1" 
xmlns="http://ns.adobe.com/air/application/3.2" 
xmlns="http://ns.adobe.com/air/application/3,3" 
xmlns="http://ns.adobe.com/air/application/3.4" 
xmlns="http://ns.adobe.com/air/application/3.5" 
xmlns="http://ns.adobe.com/air/application/3.6" 
xmlns="http://ns.adobe.com/air/application/3.7"

SWF 기반 응용 프로그램의 경우 응용 프로그램 설명자에 지정된 AIR 런타임 버전에 따라 응용 프로그램의 초기 내용으로 로드할 수 있는 최대 SWF 버전이 결정됩니다. AIR 1.0 또는 AIR 1.1이 지정된 응용 프로그램에서는 AIR 2 런타임을 사용하여 실행하는 경우에도 초기 내용으로 SWF9(Flash Player 9) 파일만 사용할 수 있습니다. AIR 1.5(또는 그 이상)가 지정된 응용 프로그램에서는 초기 내용으로 SWF9 또는 SWF10(Flash Player 10) 파일을 사용할 수 있습니다.

SWF 버전에 따라 사용할 수 있는 AIR 및 Flash Player API 버전이 달라집니다. SWF9 파일이 AIR 1.5 응용 프로그램의 초기 내용으로 사용되는 경우 응용 프로그램에서 AIR 1.1 및 Flash Player 9 API에만 액세스할 수 있습니다. 이 경우 AIR 2.0 또는 Flash Player 10.1에서 기존 API에 이루어진 비헤이비어 변경 사항도 적용되지 않습니다. 단, API에 대한 중요한 보안 관련 변경 사항은 이 원칙에 대한 예외로서 현재 또는 향후 런타임 패치에서 소급 적용할 수 있습니다.

HTML 기반 응용 프로그램의 경우 응용 프로그램 설명자에 지정된 런타임 버전으로 응용 프로그램에 사용할 수 있는 AIR 및 Flash Player API 버전이 결정됩니다. HTML, CSS 및 JavaScript 비헤이비어는 응용 프로그램 설명자에 의해 결정되는 것이 아니라 항상 설치된 AIR 런타임에 사용된 Webkit 버전에 의해 결정됩니다.

AIR 응용 프로그램에서 SWF 내용을 로드할 때 해당 내용에 사용할 수 있는 AIR 및 Flash Player API 버전은 내용을 로드하는 방법에 따라 달라집니다. 유효한 버전은 응용 프로그램 설명자 네임스페이스로 결정되거나, 로딩하는 내용의 버전에 따라 결정되거나, 로드된 내용의 버전에 따라 결정됩니다. 다음 표에서는 내용을 로드하는 방법에 따라 API 버전이 어떻게 결정되는지 보여 줍니다.

내용 로드 방법

API 버전 결정 방법

초기 내용, SWF 기반 응용 프로그램

로드되는 SWF 파일 버전

초기 내용, HTML 기반 응용 프로그램

응용 프로그램 설명자 네임스페이스

SWF 내용에서 로드되는 SWF

로드하는 내용의 버전

<script> 태그를 사용하여 HTML 내용에서 로드되는 SWF 라이브러리

응용 프로그램 설명자 네임스페이스

AIR 또는 Flash Player API(예: flash.display.Loader)를 사용하여 HTML에서 로드되는 SWF

응용 프로그램 설명자 네임스페이스

<object> 또는 <embed> 태그(또는 이에 해당하는 JavaScript API)를 사용하여 HTML 내용에서 로드되는 SWF

로드되는 SWF 파일 버전

로드하는 내용과 다른 버전의 SWF 파일을 로드할 경우 두 가지 문제가 발생할 수 있습니다.

  • 이전 버전의 SWF를 통해 최신 버전의 SWF 로드 - 로드된 내용에 있는 최신 버전의 AIR 및 Flash Player에 추가된 API에 대한 참조가 확인되지 않습니다.

  • 최신 버전의 SWF를 통해 이전 버전의 SWF 로드 - 최신 버전의 AIR 및 Flash Player에서 변경된 API가 로드된 내용에 불필요한 방식으로 작동할 수 있습니다.

내용

application 요소에는 AIR 응용 프로그램의 속성을 정의하는 자식 요소가 포함되어 있습니다.

예제

<?xml version="1.0" encoding="utf-8" ?> 
<application xmlns="http://ns.adobe.com/air/application/3.0"> 
    <id>HelloWorld</id> 
    <version>2.0</version> 
    <filename>Hello World</filename> 
    <name>Example Co. AIR Hello World</name> 
     <description> 
        <text xml:lang="en">This is an example.</text> 
        <text xml:lang="fr">C'est un exemple.</text> 
        <text xml:lang="es">Esto es un ejemplo.</text> 
    </description> 
    <copyright>Copyright (c) 2010 Example Co.</copyright> 
    <initialWindow> 
        <title>Hello World</title> 
        <content> 
            HelloWorld.swf 
        </content> 
        <systemChrome>none</systemChrome> 
        <transparent>true</transparent> 
        <visible>true</visible> 
        <minSize>320 240</minSize> 
    </initialWindow>  
    <installFolder>Example Co/Hello World</installFolder> 
    <programMenuFolder>Example Co</programMenuFolder> 
    <icon> 
        <image16x16>icons/smallIcon.png</image16x16> 
        <image32x32>icons/mediumIcon.png</image32x32> 
        <image48x48>icons/bigIcon.png</image48x48> 
        <image128x128>icons/biggestIcon.png</image128x128>  
    </icon> 
    <customUpdateUI>true</customUpdateUI> 
    <allowBrowserInvocation>false</allowBrowserInvocation> 
    <fileTypes> 
        <fileType> 
            <name>adobe.VideoFile</name> 
            <extension>avf</extension> 
            <description>Adobe Video File</description> 
            <contentType>application/vnd.adobe.video-file</contentType> 
            <icon> 
                <image16x16>icons/avfIcon_16.png</image16x16> 
                <image32x32>icons/avfIcon_32.png</image32x32> 
                <image48x48>icons/avfIcon_48.png</image48x48> 
                <image128x128>icons/avfIcon_128.png</image128x128> 
            </icon> 
        </fileType> 
    </fileTypes> 
</application>

aspectRatio

응용 프로그램의 종횡비를 지정합니다.

지정하지 않으면 응용 프로그램이 장치의 “기본” 종횡비 및 방향으로 열립니다. 기본 방향은 장치마다 다릅니다. 일반적으로 휴대폰과 같은 화면이 작은 장치에서는 세로 종횡비입니다. iPad 타블렛 같은 일부 장치에서는 응용 프로그램이 현재 방향으로 열립니다. AIR 3.3 이상에서는 초기 표시뿐 아니라 전체 응용 프로그램에 이 점이 적용됩니다.

부모 요소:initialWindow

자식 요소: 없음

내용

portrait, landscape 또는 any

예제

<aspectRatio>landscape</aspectRatio>

autoOrients

장치 자체의 실제 방향이 변경되는 경우 응용 프로그램 내 내용의 방향이 자동으로 조정되도록 할지 여부를 지정합니다. 자세한 내용은 스테이지 방향을 참조하십시오.

자동 방향을 사용하는 경우에는 Stage의 alignscaleMode 속성을 다음과 같이 설정하는 것이 좋습니다.

stage.align = StageAlign.TOP_LEFT; 
stage.scaleMode = StageScaleMode.NO_SCALE;

이러한 설정은 응용 프로그램이 왼쪽 위 모서리를 중심으로 회전하도록 하고 응용 프로그램 내용의 크기가 자동으로 조절되는 것을 방지합니다. 다른 크기 조절 모드는 회전한 스테이지 크기에 맞게 내용을 조정하기는 하지만 해당 내용을 잘라내거나, 왜곡하거나, 과도하게 축소할 수 있습니다. 거의 언제나 내용을 직접 다시 그리거나 배치함으로써 더 나은 결과를 얻을 수 있습니다.

부모 요소:initialWindow

자식 요소: 없음

내용

true 또는 false(기본값)

예제

<autoOrients>true</autoOrients>

colorDepth

16비트 색상을 사용할지 아니면 32비트 색상을 사용할지를 지정합니다.

16비트 색상을 사용하면 렌더링 성능이 증가하지만 색상 충실도가 떨어질 수 있습니다. AIR 3 이전에는 Android에 항상 16비트 색상이 사용되지만, AIR 3에서는 기본적으로 32비트 색상이 사용됩니다.

참고: 응용 프로그램에서 StageVideo 클래스를 사용하는 경우 32비트 색상을 사용해야 합니다.

부모 요소:android

자식 요소: 없음

내용

다음 값 중 하나:

  • 16비트

  • 32비트

예제

<android> 
    <colorDepth>16bit</colorDepth> 
    <manifestAdditions>...</manifestAdditions> 
</android>

containsVideo

응용 프로그램에 비디오 내용이 포함될지 여부를 지정합니다.

부모 요소:android

자식 요소: 없음

내용

다음 값 중 하나:

  • true

  • false

예제

<android> 
    <containsVideo>true</containsVideo> 
    <manifestAdditions>...</manifestAdditions> 
</android>

content

content 요소에 대해 지정되는 값은 응용 프로그램의 기본 내용 파일에 대한 URL입니다. 이는 SWF 파일 또는 HTML 파일일 수 있습니다. URL은 응용 프로그램 설치 폴더의 루트를 기준으로 지정됩니다. ADL을 사용하여 AIR 응용 프로그램을 실행하는 경우 URL은 응용 프로그램 설명자 파일이 포함된 폴더를 기준으로 합니다. ADL의 root-dir 매개 변수를 사용하여 다른 루트 디렉토리를 지정할 수 있습니다.

부모 요소:initialWindow

자식 요소: 없음

내용

응용 프로그램 디렉토리에 상대적인 URL. content 요소의 값이 URL로 처리되기 때문에 내용 파일의 이름에 사용된 문자는 RFC 1738에 정의된 규칙에 따라 URL로 인코딩해야 합니다. 예를 들어 공백 문자는 %20으로 인코딩해야 합니다.

예제

<content>TravelPlanner.swf</content>

contentType

contentType은 AIR 1.5부터 필수입니다(AIR 1.0 및 1.1에서는 선택 사항이었음). 이 속성은 일부 운영 체제에서 파일을 여는 데 가장 적합한 응용 프로그램을 손쉽게 찾을 수 있도록 합니다. 값은 파일 내용의 MIME 유형이어야 합니다. 해당 파일 형식이 이미 등록되어 있고 지정된 MIME 유형을 갖는 경우 Linux에서 값이 무시됩니다.

부모 요소:fileType

자식 요소: 없음

내용

MIME 유형 및 하위 유형. MIME 유형에 대한 자세한 내용은 RFC2045를 참조하십시오.

예제

<contentType>text/plain</contentType>

copyright

AIR 응용 프로그램에 대한 저작권 정보입니다. Mac OS에서 저작권 텍스트는 설치된 응용 프로그램의 [정보] 대화 상자에 나타납니다. Mac OS에서는 저작권 정보가 응용 프로그램에 대한 Info.plist 파일의 NSHumanReadableCopyright 필드에도 사용됩니다.

부모 요소:application

자식 요소: 없음

내용

응용 프로그램 저작권 정보를 포함하는 문자열

예제

<copyright>© 2010, Examples, Inc.All rights reserved.</copyright>

customUpdateUI

응용 프로그램에서 자체적인 업데이트 대화 상자를 제공할지 여부를 나타냅니다. false인 경우 AIR는 사용자에게 표준 업데이트 대화 상자를 표시합니다. AIR 파일로 배포된 응용 프로그램만 내장된 AIR 업데이트 시스템을 사용할 수 있습니다.

설치된 응용 프로그램 버전의 customUpdateUI 요소가 true로 설정된 상태에서 사용자가 새 버전에 대한 AIR 파일을 두 번 클릭하거나 연속 설치 기능을 사용하여 응용 프로그램의 업데이트를 설치하면 런타임은 설치된 버전의 응용 프로그램을 열며, 기본 AIR 설치 프로그램은 열지 않습니다. 그러면 응용 프로그램 논리에서 업데이트 작업의 진행 방법을 결정할 수 있습니다. AIR 파일의 응용 프로그램 ID 및 제작자 ID가 설치된 응용 프로그램의 해당 값과 일치해야 업그레이드를 진행할 수 있습니다.

참고: 응용 프로그램이 이미 설치되어 있으며 사용자가 업데이트가 포함된 AIR 설치 파일을 두 번 클릭하거나 연속 설치 기능을 사용하여 응용 프로그램의 업데이트를 설치하는 경우에만 customUpdateUI 메커니즘이 작동합니다. customUpdateUItrue인지 여부에 관계없이 필요에 따라 사용자 정의 UI를 표시하며 고유한 응용 프로그램 논리를 통해 업데이트를 다운로드 및 시작할 수 있습니다.

자세한 내용은 AIR 응용 프로그램 업데이트를 참조하십시오.

부모 요소:application

자식 요소: 없음

내용

true 또는 false(기본값)

예제

<customUpdateUI>true</customUpdateUI>

depthAndStencil

응용 프로그램에서 심도 또는 스텐실 버퍼를 사용해야 한다는 것을 나타냅니다. 일반적으로 이러한 버퍼는 3D 내용으로 작업하는 경우에 사용합니다. 기본적으로 이 요소의 값은 심도 및 스텐실 버퍼를 비활성화하는 false입니다. 이 요소가 필요한 이유는 응용 프로그램 시작 시 내용이 로드되기 전에 버퍼를 할당해야 하기 때문입니다.

이 요소의 설정은 enableDepthAndStencil 인수에 대해 Context3D.configureBackBuffer() 메서드로 전달되는 값과 일치해야 합니다. 값이 일치하지 않으면 AIR에서 오류가 발생합니다.

이 요소는 renderModedirect인 경우에만 적용할 수 있습니다. renderModedirect가 아닌 경우에는 ADT에서 오류 118이 발생합니다.

<depthAndStencil> element unexpected for render mode cpu.  It requires "direct" render mode.

부모 요소:initialWindow

자식 요소: 없음

내용

true 또는 false(기본값)

예제

<depthAndStencil>true</depthAndStencil>

description

AIR 응용 프로그램 설치 프로그램에 표시되는 응용 프로그램에 대한 설명입니다.

다중 text 요소 대신 단일 텍스트 노드를 지정하는 경우 AIR 응용 프로그램 설치 프로그램은 시스템 언어와 상관없이 이 설명을 사용합니다. 그렇지 않은 경우 AIR 응용 프로그램 설치 프로그램은 사용되는 운영 체제의 사용자 인터페이스 언어에 가장 가까운 설명을 사용합니다. 예를 들어 응용 프로그램 설명자 파일의 description 요소에 en(영어) 로캘의 값이 포함된 설치를 살펴보면 사용자 시스템이 en(영어)을 사용자 인터페이스 언어로 식별하는 경우 AIR 응용 프로그램 설치 프로그램은 en 설명을 사용합니다. 시스템 사용자 인터페이스 언어가 en-US(미국 영어)인 경우에도 en 설명이 사용됩니다. 그러나 시스템 사용자 인터페이스 언어가 en-US이며 응용 프로그램 설명자 파일이 en-US 이름과 en-GB 이름을 모두 정의하는 경우 AIR 응용 프로그램 설치 프로그램은 en-US 값을 사용합니다. 응용 프로그램이 시스템 사용자 인터페이스 언어와 일치하는 설명을 정의하지 않는 경우 AIR 응용 프로그램 설치 프로그램은 응용 프로그램 설명자 파일에 정의된 첫 번째 description 값을 사용합니다.

다중 언어 응용 프로그램을 개발하는 방법에 대한 자세한 내용은 AIR 응용 프로그램 지역화를 참조하십시오.

부모 요소:application

자식 요소:text

내용

AIR 1.0 응용 프로그램 설명자 스키마를 사용하면 이름에 대해 여러 text 요소가 아닌 하나의 간단한 텍스트 노드만 정의할 수 있습니다.

AIR 1.1 이상에서는 description 요소에 다중 언어를 지정할 수 있습니다. 각 text 요소에 대한 xml:lang 특성은 RFC4646(http://www.ietf.org/rfc/rfc4646.txt)에 정의된 언어 코드를 지정합니다.

예제

간단한 텍스트 노드가 있는 설명:

<description>This is a sample AIR application.</description> 

영어, 프랑스어 및 스페인어에 대한 지역화된 text 요소가 있는 설명(AIR 1.1 이상에서 유효):

<description> 
    <text xml:lang="en">This is an example.</text> 
    <text xml:lang="fr">C'est un exemple.</text> 
    <text xml:lang="es">Esto es un ejemplo.</text> 
</description> 

description

파일 유형 설명은 운영 체제를 통해 사용자에게 표시됩니다. 파일 유형 설명은 지역화할 수 없습니다.

참조: application 요소의 자식으로 사용될 때의 description

부모 요소:fileType

자식 요소: 없음

내용

파일 내용을 설명하는 문자열

예제

<description>PNG image</description>

embedFonts

AIR 응용 프로그램에서 StageText에 사용자 정의 글꼴을 사용할 수 있습니다. 이 요소는 선택 사항입니다.

부모 요소:application

자식 요소:글꼴

내용

embedFonts 요소는 font 요소를 개수에 관계없이 포함할 수 있습니다.

예제

<embedFonts> 
   <font> 
      <fontPath>ttf/space age.ttf</fontPath>
      <fontName>space age</fontName> 
   </font>
   <font> 
      <fontPath>ttf/xminus.ttf</fontPath>
      <fontName>xminus</fontName> 
   </font>
</embedFonts>

Entitlements

iOS에서는 entitlements라는 속성을 사용하여 응용 프로그램이 추가 리소스 및 기능에 액세스하도록 지원합니다. Entitlements 요소를 사용하면 모바일 iOS 응용 프로그램에서 이 정보를 지정할 수 있습니다.

부모 요소:iPhone

자식 요소: iOS Entitlements.plist 요소

내용

응용 프로그램의 Entitlements.plist 설정으로 사용할 키-값 쌍을 지정하는 자식 요소가 포함됩니다. Entitlements 요소의 내용은 CDATA 블록으로 둘러싸여야 합니다. 자세한 내용은 iOS 개발자 라이브러리에서 Entitlement 키 참조를 검토하십시오.

예제

<iphone> 
... 
   <Entitlements> 
      <![CDATA[ 
         <key>aps-environment</key> 
         <string>development</string> 
      ]]> 
   </Entitlements> 
</iphone>

extension

파일 유형의 확장자 문자열입니다.

부모 요소:fileType

자식 요소: 없음

내용

파일 확장자 문자를 식별하는 문자열(점, “.” 제외)

예제

<extension>png</extension>

extensionID

응용 프로그램에서 사용하는 ActionScript 확장의 ID를 지정합니다. ID는 확장 설명자 문서에 정의되어 있습니다.

부모 요소:extensions

자식 요소: 없음

내용

ActionScript 확장 ID를 식별하는 문자열

예제

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

extensions

응용 프로그램에서 사용하는 ActionScript 확장을 식별합니다.

부모 요소:application

자식 요소:extensionID

내용

확장 설명자 파일에 있는 ActionScript 확장 ID를 포함하는 자식 extensionID 요소

예제

<extensions> 
    <extensionID>extension.first</extensionID> 
    <extensionID>extension.next</extensionID> 
    <extensionID>extension.last</extensionID> 
</extensions>

externalSwfs

원격 호스팅을 위해 ADT에 구성할 SWF 목록이 포함된 텍스트 파일 이름을 지정합니다. 응용 프로그램에 사용되는 하위 집합의 SWF를 패키지화하고 Loader.load() 메서드를 사용하여 나머지 외부(에셋 전용) SWF를 런타임에 로드하여 초기 응용 프로그램 다운로드 크기를 최소화할 수 있습니다. 이 기능을 사용하려면 ADT가 외부 로드된 SWF 파일에서 기본 응용 프로그램 SWF로 모든 ActionScript ByteCode(ABC)를 이동할 수 있도록 응용 프로그램을 패키지화해야 합니다. 그래야 SWF에는 에셋만 포함됩니다. 이는 응용 프로그램을 설치한 후 어떠한 코드 다운로드도 금지하는 Apple Store의 규칙을 준수합니다.

자세한 내용은 외부 에셋 전용 SWF를 로드하여 다운로드 크기 최소화를 참조하십시오.

부모 요소: iPhone, initialWindow

자식 요소: 없음

내용

원격으로 호스팅되는 SWF 목록(행으로 구분됨)을 포함하는 텍스트 파일 이름입니다.

특성:

없음

예제

iOS:

<iPhone> 
    <externalSwfs>FileContainingListofSWFs.txt</externalSwfs> 
</iPhone>

filename

응용 프로그램을 설치할 때 응용 프로그램의 파일 이름(확장명 제외)으로 사용할 문자열입니다. 이 응용 프로그램 파일은 런타임에 AIR 응용 프로그램을 시작합니다. name 값을 제공하지 않으면 filename이 설치 폴더의 이름으로도 사용됩니다.

부모 요소:application

자식 요소: 없음

내용

filename 속성에는 다양한 파일 시스템에서 파일 이름으로 사용할 수 없는 다음 문자를 제외한 모든 유니코드(UTF-8) 문자를 포함할 수 있습니다.

문자

16진수 코드

다양함

0x00 – x1F

*

x2A

"

x22

:

x3A

>

x3C

<

x3E

?

x3F

\

x5C

|

x7C

filename 값은 마침표로 끝낼 수 없습니다.

예제

<filename>MyApplication</filename>

fileType

응용 프로그램이 등록할 수 있는 단일 파일 유형을 설명합니다.

부모 요소:fileTypes

자식 요소:

내용

파일 유형을 설명하는 요소

예제

<fileType> 
    <name>foo.example</name> 
    <extension>foo</extension> 
    <description>Example file type</description> 
    <contentType>text/plain</contentType> 
    <icon> 
        <image16x16>icons/fooIcon16.png</image16x16> 
        <image48x48>icons/fooIcon48.png</imge48x48> 
    <icon> 
</fileType>

fileTypes

fileTypes 요소를 사용하면 AIR 응용 프로그램을 연결할 수 있는 파일 유형을 선언할 수 있습니다.

AIR 응용 프로그램이 설치되면 선언된 모든 파일 유형이 운영 체제에 등록됩니다. 이러한 파일 유형이 아직 다른 응용 프로그램과 연결되어 있지 않은 경우 AIR 응용 프로그램과 연결됩니다. 파일 유형과 다른 응용 프로그램 간의 기존 연결을 재정의하려면 런타임에 NativeApplication.setAsDefaultApplication() 메서드를 사용합니다. 이때 사용자의 허락을 받는 것이 좋습니다.

참고: 런타임 메서드는 응용 프로그램 설명자에 선언된 파일 유형에 대한 연결만 관리할 수 있습니다.

fileTypes 요소는 선택 사항입니다.

부모 요소:application

자식 요소:fileType

내용

개수에 관계없이 fileType 요소를 포함할 수 있는 fileTypes 요소

예제

<fileTypes> 
    <fileType> 
        <name>adobe.VideoFile</name> 
        <extension>avf</extension> 
        <description>Adobe Video File</description> 
        <contentType>application/vnd.adobe.video-file</contentType> 
        <icon> 
            <image16x16>icons/AIRApp_16.png</image16x16>       
            <image32x32>icons/AIRApp_32.png</image32x32>       
            <image48x48>icons/AIRApp_48.png</image48x48>      
            <image128x128>icons/AIRApp_128.png</image128x128> 
        </icon> 
    </fileType> 
</fileTypes>

글꼴

AIR 응용 프로그램에서 사용할 수 있는 단일 사용자 정의 글꼴에 대해 설명합니다.

부모 요소:embedFonts

자식 요소:fontName, fontPath

내용

사용자 정의 글꼴 이름 및 해당 경로를 지정하는 요소입니다.

예제

<font> 
   <fontPath>ttf/space age.ttf</fontPath>
   <fontName>space age</fontName> 
</font>

fontName

사용자 정의 글꼴 이름을 지정합니다.

부모 요소:글꼴

자식 요소: 없음

내용

StageText.fontFamily에 지정할 사용자 정의 글꼴의 이름입니다.

예제

<fontName>space age</fontName> 

fontPath

사용자 정의 글꼴 파일의 위치를 지정합니다.

부모 요소:글꼴

자식 요소: 없음

내용

소스에 상대적인 사용자 정의 글꼴 파일의 경로입니다.

예제

<fontPath>ttf/space age.ttf</fontPath> 

forceCPURenderModeForDevices

지정한 장치 집합에 CPU 렌더링 모드를 강제 적용합니다. 이 기능은 선택적으로 나머지 iOS 장치에 GPU 렌더링 모드를 사용하려는 경우에 효과적입니다.

이 태그는 iPhone 태그의 자식으로 추가하고, 장치 모델 이름의 목록은 공백으로 구분하여 지정합니다. 유효한 장치 모델 이름으로는 다음이 포함됩니다.

iPad1,1

iPhone1,1

iPod1,1

iPad2,1

iPhone1,2

iPod2,1

iPad2,2

iPhone2,1

iPod3,3

iPad2,3

iPhone3.1

iPod4,1

iPad2,4

iPhone3,2

iPod5,1

iPad2,5

iPhone4,1

 

iPad3,1

iPhone5,1

 

iPad3,2

   

iPad3,3

   

iPad3,4

   

부모 요소: iPhone, initialWindow

자식 요소: 없음

내용

공백으로 구분된 장치 모델 이름 목록입니다.

특성:

없음

예제

iOS:

... 
<renderMode>GPU</renderMode> 
... 
<iPhone> 
... 
   <forceCPURenderModeForDevices>iPad1,1 iPhone1,1 iPhone1,2 iPod1,1 
   </forceCPURenderModeForDevices> 
</iPhone>

fullScreen

응용 프로그램이 전체 화면 모드에서 시작되는지 여부를 지정합니다.

부모 요소:initialWindow

자식 요소: 없음

내용

true 또는 false(기본값)

예제

<fullscreen>true</fullscreen>

height

응용 프로그램 기본 윈도우의 초기 높이입니다.

높이를 설정하지 않으면 루트 SWF 파일의 설정에 의해 결정되며 HTML 기반 AIR 응용 프로그램의 경우에는 운영 체제에 의해 결정됩니다.

AIR 2에서는 윈도우의 최대 높이가 2048픽셀에서 4096픽셀로 변경되었습니다.

부모 요소:initialWindow

자식 요소: 없음

내용

최대값이 4095인 양의 정수

예제

<height>4095</height>

icon

icon 속성은 응용 프로그램에 사용될 하나 이상의 아이콘 파일을 지정합니다. 아이콘 포함은 선택 사항입니다. icon 속성을 지정하지 않으면 운영 체제가 기본 아이콘을 표시합니다.

지정된 경로는 응용 프로그램 루트 디렉토리를 기준으로 합니다. 아이콘 파일은 PNG 형식이어야 합니다. 모든 다음 아이콘 크기를 지정할 수 있습니다.

지정된 크기에 대한 요소가 있는 경우 파일의 이미지는 지정된 크기와 일치해야 합니다. 아무 크기도 제공되지 않은 경우에는 운영 체제에서 가장 근접한 크기가 아이콘의 지정된 용도에 맞게 조절됩니다.

참고: 지정된 아이콘은 AIR 패키지에 자동으로 추가되지 않으며 응용 프로그램이 패키지화될 때 아이콘 파일을 정확한 해당 상대적 위치에 포함해야 합니다.

최적의 결과를 얻으려면 사용 가능한 크기 각각에 대한 이미지를 제공하십시오. 또한 아이콘이 16비트 색상 모드와 32비트 색상 모드에서 제대로 표시되는지 확인하십시오.

부모 요소:application

자식 요소:imageNxN

내용

원하는 각 아이콘 크기에 대한 imageNxN 요소

예제

<icon> 
    <image16x16>icons/smallIcon.png</image16x16> 
    <image32x32>icons/mediumIcon.png</image32x32> 
    <image48x48>icons/bigIcon.png</image48x48> 
    <image128x128>icons/biggestIcon.png</image128x128>  
</icon>

id

응용 프로그램에 대한 식별자 문자열로, 응용 프로그램 ID라고 합니다. 역방향 DNS 스타일 식별자가 종종 사용되지만 이 스타일은 필수가 아닙니다.

부모 요소:application

자식 요소: 없음

내용

ID 값은 다음 문자로 제한됩니다.

  • 0–9

  • a–z

  • A–Z

  • . (도트)

  • -(하이픈)

이 값에는 1-212개의 문자를 포함해야 합니다. 이 요소는 필수 사항입니다.

예제

<id>org.example.application</id>

imageNxN

응용 프로그램 디렉토리에 상대적인 아이콘 경로를 정의합니다.

각각 서로 다른 아이콘 크기를 지정하는 다음과 같은 아이콘 이미지를 사용할 수 있습니다.

  • image16x16

  • image29x29(AIR 2+)

  • image32x32

  • image36x36(AIR 2.5+)

  • image48x48

  • image50x50(AIR 3.4+)

  • image57x57(AIR 2+)

  • image58x58(AIR 3.4+)

  • image72x72(AIR 2+)

  • image100x100(AIR 3.4+)

  • image114x114(AIR 2.6+)

  • image128x128

  • image144x144(AIR 3.4+)

  • image512x512(AIR 2+)

  • image1024x1024(AIR 3.4+)

아이콘은 image 요소가 나타내는 크기와 똑같은 PNG 그래픽이어야 합니다. 아이콘 파일은 응용 프로그램 패키지에 포함되어야 합니다. 응용 프로그램 설명자 문서에서 참조하는 아이콘이 자동으로 포함되지는 않습니다.

부모 요소:application

자식 요소: 없음

내용

아이콘의 파일 경로에는 다양한 파일 시스템에서 파일 이름으로 사용할 수 없는 다음 문자를 제외한 모든 유니코드(UTF-8) 문자가 포함될 수 있습니다.

문자

16진수 코드

다양함

0x00 – x1F

*

x2A

"

x22

:

x3A

>

x3C

<

x3E

?

x3F

\

x5C

|

x7C

예제

<image32x32>icons/icon32.png</image32x32>

InfoAdditions

iOS 응용 프로그램에 대한 추가 속성을 지정할 수 있도록 합니다.

부모 요소:iPhone

자식 요소: iOS Info.plist 요소

내용

응용 프로그램의 Info.plist 설정으로 사용할 키-값 쌍을 지정하는 자식 요소가 포함됩니다. InfoAdditions 요소의 내용은 CDATA 블록으로 둘러싸여야 합니다.

키 값 쌍에 대한 자세한 내용 그리고 XML에서 키 값 쌍을 표현하는 방법에 대해서는 Apple iPhone 참조 라이브러리에서 정보 속성 목록 키 참조를 참조하십시오.

예제

<InfoAdditions> 
    <![CDATA[ 
        <key>UIStatusBarStyle</key> 
        <string>UIStatusBarStyleBlackOpaque</string> 
        <key>UIRequiresPersistentWiFi</key> 
        <string>NO</string> 
    ]]> 
</InfoAdditions>

initialWindow

기본 내용 파일 및 초기 응용 프로그램 모양을 정의합니다.

부모 요소:application

자식 요소: 다음과 같은 모든 요소가 initialWindow 요소의 자식으로 나타날 수 있습니다. 하지만 AIR가 플랫폼에서 윈도우를 지원하는지 여부에 따라 일부 요소는 무시됩니다.

요소

데스크톱

모바일

aspectRatio

무시됨

사용됨

autoOrients

무시됨

사용됨

content

사용됨

사용됨

depthAndStencil

사용됨

사용됨

fullScreen

무시됨

사용됨

height

사용됨

무시됨

maximizable

사용됨

무시됨

maxSize

사용됨

무시됨

minimizable

사용됨

무시됨

minSize

사용됨

무시됨

renderMode

사용됨(AIR 3.0 이상)

사용됨

requestedDisplayResolution

사용됨(AIR 3.6 이상)

무시됨

resizable

사용됨

무시됨

softKeyboardBehavior

무시됨

사용됨

systemChrome

사용됨

무시됨

title

사용됨

무시됨

transparent

사용됨

무시됨

visible

사용됨

무시됨

width

사용됨

무시됨

x

사용됨

무시됨

y

사용됨

무시됨

내용

응용 프로그램 모양 및 비헤이비어를 정의하는 자식 요소

예제

<initialWindow> 
    <title>Hello World</title> 
    <content> 
        HelloWorld.swf 
    </content> 
    <depthAndStencil>true</depthAndStencil> 
    <systemChrome>none</systemChrome> 
    <transparent>true</transparent> 
    <visible>true</visible> 
    <maxSize>1024 800</maxSize> 
    <minSize>320 240</minSize> 
    <maximizable>false</maximizable> 
    <minimizable>false</minimizable> 
    <resizable>true</resizable> 
    <x>20</x> 
    <y>20</y> 
    <height>600</height> 
    <width>800</width> 
    <aspectRatio>landscape</aspectRatio> 
    <autoOrients>true</autoOrients> 
    <fullScreen>false</fullScreen> 
    <renderMode>direct</renderMode> 
</initialWindow>

installFolder

기본 설치 디렉토리의 하위 디렉토리를 식별합니다.

기본 설치 하위 디렉토리는 Windows에서는 Program Files 디렉토리이고, Mac OS에서는 /Applications 디렉토리입니다. Linux에서는 /opt/입니다. 예를 들어 installFolder 속성이 "Acme"로 설정되어 있고 응용 프로그램의 이름이 "ExampleApp"으로 지정되어 있는 경우, 응용 프로그램은 Windows에서는 C:\Program Files\Acme\ExampleApp에, Mac OS에서는 /Applications/Acme/Example.app에, Linux에서는 /opt/Acme/ExampleApp에 설치됩니다.

installFolder 속성은 선택 사항입니다. installFolder 속성을 지정하지 않으면 응용 프로그램이 name 속성을 기반으로 기본 설치 디렉토리의 하위 디렉토리에 설치됩니다.

부모 요소:application

자식 요소: 없음

내용

installFolder 속성에는 다양한 파일 시스템에서 폴더 이름으로 사용할 수 없는 문자를 제외한 모든 유니코드(UTF-8) 문자가 포함될 수 있습니다. 예외 목록은 filename 속성을 참조하십시오.

중첩된 하위 디렉토리를 지정하려면 슬래시(/) 문자를 디렉토리 분리 기호 문자로 사용하십시오.

예제

<installFolder>utilities/toolA</installFolder>

iPhone

iOS 고유의 응용 프로그램 속성을 정의합니다.

부모 요소:application

manifest

응용 프로그램의 Android 매니페스트 파일에 추가할 정보를 지정합니다.

부모 요소:manifestAdditions

자식 요소: Android SDK에 의해 정의됩니다.

내용

manifest 요소는 엄밀히 말하자면 AIR 응용 프로그램 설명자 스킴에 포함되어 있지 않습니다. 오히려 Android 매니페스트 XML 문서의 루트입니다. manifest 요소 안에 넣는 내용은 AndroidManifest.xml 스킴을 준수해야 합니다. AIR 도구를 사용하여 APK 파일을 생성할 때 manifest 요소에 있는 정보는 응용 프로그램의 생성된 AndroidManifest.xml에서 그에 상응하는 부분에 복사됩니다.

AIR에서 직접 지원되는 것보다 최신 버전의 SDK에서만 사용할 수 있는 Android 매니페스트 값을 지정하는 경우 응용 프로그램을 패키지화할 때 -platformsdk 플래그를 ADT로 설정해야 합니다. 추가하려는 값을 지원하는 Android SDK 버전에 대한 파일 시스템 경로로 이 플래그를 설정합니다.

manifest 요소 자체는 AIR 응용 프로그램 설명자 내에서 CDATA 블록으로 둘러싸여야 합니다.

예제

<![CDATA[      
    <manifest android:sharedUserID="1001"> 
        <uses-permission android:name="android.permission.CAMERA"/> 
        <uses-feature android:required="false" android:name="android.hardware.camera"/> 
        <application     android:allowClearUserData="true" 
                    android:enabled="true" 
                    android:persistent="true"/> 
    </manifest> 
]]>

manifestAdditions

Android 매니페스트 파일에 추가할 정보를 지정합니다.

모든 Android 응용 프로그램에는 기본 응용 프로그램 속성을 정의하는 매니페스트 파일이 포함되어 있습니다. Android 매니페스트는 개념적으로 AIR 응용 프로그램 설명자와 비슷합니다. AIR for Android 응용 프로그램에는 응용 프로그램 설명자와 자동으로 생성된 Android 매니페스트 파일이 모두 들어 있습니다. AIR for Android 응용 프로그램이 패키지화될 때 이 manifestAdditions 요소에 있는 정보는 Android 매니페스트 문서의 상응하는 부분에 추가됩니다.

부모 요소:android

자식 요소:manifest

내용

manifestAdditions 요소에 있는 정보가 AndroidManifest XML 문서에 추가됩니다.

AIR는 응용 프로그램 및 런타임 기능이 올바르게 작동하도록 하기 위해 생성된 Android 매니페스트 문서에서 여러 매니페스트 항목을 설정합니다. 다음 설정은 무시할 수 없습니다.

manifest 요소의 다음 특성은 설정할 수 없습니다.

  • package

  • android:versionCode

  • android:versionName

기본 activity 요소의 다음 특성은 설정할 수 없습니다.

  • android:label

  • android:icon

application 요소의 다음 특성은 설정할 수 없습니다.

  • android:theme

  • android:name

  • android:label

  • android:windowSoftInputMode

  • android:configChanges

  • android:screenOrientation

  • android:launchMode

예제

<manifestAdditions> 
    <![CDATA[      
        <manifest android:installLocation="preferExternal"> 
            <uses-permission android:name="android.permission.INTERNET"/> 
            <application     android:allowClearUserData="true" 
                        android:enabled="true" 
                        android:persistent="true"/> 
        </manifest> 
    ]]> 
</manifestAdditions>

maximizable

윈도우를 최대화할 수 있는지 여부를 지정합니다.

참고: 윈도우 최대화가 크기 조절 작업인 Mac OS X와 같은 운영 체제에서 윈도우가 확대/축소 또는 크기 조절되지 않도록 하려면 maximizable과 resizable을 모두 false로 설정해야 합니다.

부모 요소:initialWindow

자식 요소: 없음

내용

true(기본값) 또는 false

예제

<maximizable>false</maximizable>

maxSize

윈도우의 최대 크기입니다. 최대 크기를 설정하지 않으면 운영 체제에 의해 결정됩니다.

부모 요소:initialWindow

자식 요소: 없음

내용

최대 폭 및 높이를 나타내는 두 개의 정수로, 공백에 의해 분리됩니다.

참고: AIR 2에서는 AIR가 지원하는 최대 윈도우 크기가 2048x2048 픽셀에서 4096x4096 픽셀로 늘어났습니다. 스크린 좌표는 0부터 시작되므로 폭 또는 높이에 사용할 수 있는 최대값은 4095입니다.

예제

<maxSize>1024 360</maxSize>

minimizable

윈도우를 최소화할 수 있는지 여부를 지정합니다.

부모 요소:initialWindow

자식 요소: 없음

내용

true(기본값) 또는 false

예제

<minimizable>false</minimizable>

minSize

윈도우에 대해 허용되는 최소 크기를 지정합니다.

부모 요소:initialWindow

자식 요소: 없음

내용

최소 폭 및 높이를 나타내는 두 개의 정수로, 공백에 의해 분리됩니다. 운영 체제에서 정한 최소 크기가 응용 프로그램 설명자에 설정된 값보다 우선합니다.

예제

<minSize>120 60</minSize>

name

AIR 응용 프로그램 설치 프로그램에서 표시하는 응용 프로그램 제목입니다.

name 요소가 지정되어 있지 않은 경우 AIR 응용 프로그램 설치 프로그램은 filename을 응용 프로그램 이름으로 표시합니다.

부모 요소:application

자식 요소:text

내용

다중 <text> 요소 대신 단일 텍스트 노드를 지정하는 경우 AIR 응용 프로그램 설치 프로그램은 시스템 언어와 상관없이 이 이름을 사용합니다.

AIR 1.0 응용 프로그램 설명자 스키마를 사용하면 이름에 대해 여러 text 요소가 아닌 하나의 간단한 텍스트 노드만 정의할 수 있습니다. AIR 1.1 이상에서는 name 요소에 다중 언어를 지정할 수 있습니다.

각 text 요소에 대한 xml:lang 특성은 RFC4646(http://www.ietf.org/rfc/rfc4646.txt)에 정의된 언어 코드를 지정합니다.

AIR 응용 프로그램 설치 프로그램은 사용되는 운영 체제의 사용자 인터페이스 언어에 가장 가까운 이름을 사용합니다. 예를 들어 응용 프로그램 설명자 파일의 name 요소에 en(영어) 로캘의 값이 포함된 설치를 살펴보면 운영 체제가 en(영어)을 사용자 인터페이스 언어로 식별하는 경우 AIR 응용 프로그램 설치 프로그램은 en 이름을 사용합니다. 시스템 사용자 인터페이스 언어가 en-US(미국 영어)인 경우에도 en 이름이 사용됩니다. 그러나 사용자 인터페이스 언어가 en-US이며 응용 프로그램 설명자 파일이 en-US 이름과 en-GB 이름을 모두 정의하는 경우 AIR 응용 프로그램 설치 프로그램은 en-US 값을 사용합니다. 응용 프로그램이 시스템 사용자 인터페이스 언어와 일치하는 이름을 정의하지 않는 경우 AIR 응용 프로그램 설치 프로그램은 응용 프로그램 설명자 파일에 정의된 첫 번째 name 값을 사용합니다.

name 요소는 AIR 응용 프로그램 설치 프로그램에서 사용되는 응용 프로그램 제목만 정의합니다. AIR 응용 프로그램 설치 프로그램은 중국어 번체, 중국어 간체, 체코어, 네덜란드어, 영어, 프랑스어, 독일어, 이탈리아어, 일본어, 한국어, 폴란드어, 포르투갈어(브라질), 러시아어, 스페인어, 스웨덴어, 터키어 등 다양한 언어를 지원합니다. AIR 응용 프로그램 설치 프로그램은 시스템 사용자 인터페이스 언어를 기반으로 응용 프로그램 제목 및 설명 외 텍스트에 대한 표시 언어를 선택합니다. 이러한 언어 선택 작업은 응용 프로그램 설명자 파일의 설정과는 별개로 수행됩니다.

name 요소는 설치되어 실행 중인 응용 프로그램에 대해 사용 가능한 로캘을 정의하지 않습니다. 다중 언어 응용 프로그램을 개발하는 방법에 대한 자세한 내용은 AIR 응용 프로그램 지역화를 참조하십시오.

예제

다음 예제에서는 간단한 텍스트 노드를 사용하여 이름을 정의합니다.

<name>Test Application</name> 

AIR 1.1 이상에서 유효한 다음 예제는 <text> 요소 노드를 사용하여 세 개의 언어(영어, 프랑스 및 스페인어)로 이름을 지정합니다.

<name> 
    <text xml:lang="en">Hello AIR</text> 
    <text xml:lang="fr">Bonjour AIR</text> 
    <text xml:lang="es">Hola AIR</text> 
</name> 

name

파일 유형의 이름을 식별합니다.

부모 요소:fileType

자식 요소: 없음

내용

파일 유형의 이름을 나타내는 문자열입니다.

예제

<name>adobe.VideoFile</name>

programMenuFolder

Windows 운영 체제의 [모든 프로그램] 메뉴 또는 Linux의 [응응 프로그램] 메뉴에서 응용 프로그램에 대한 단축키를 배치할 위치를 식별합니다. 현재 다른 운영 체제에서는 이 설정이 무시됩니다.

부모 요소:application

자식 요소: 없음

내용

programMenuFolder 값에 사용되는 문자열에는 다양한 파일 시스템에서 폴더 이름으로 사용할 수 없는 문자를 제외한 모든 유니코드(UTF-8) 문자가 포함될 수 있습니다. 예외 목록은 filename 요소를 참조하십시오. 이 값의 마지막 문자로 슬래시(/) 문자를 사용하지 마십시오.

예제

<programMenuFolder>Example Company/Sample Application</programMenuFolder>

publisherID

원래 AIR 버전 1.5.2 이하를 사용하여 만든 AIR 응용 프로그램을 업데이트하기 위한 제작자 ID를 식별합니다.

응용 프로그램 업데이트를 만들 때만 제작자 ID를 지정하십시오. publisherID 요소의 값은 이전 버전의 응용 프로그램에 대해 AIR에서 생성한 제작자 ID와 일치해야 합니다. 설치된 응용 프로그램의 경우 제작자 ID는 응용 프로그램이 설치된 폴더에 들어 있는 META-INF/AIR/publisherid 파일에서 확인할 수 있습니다.

AIR 1.5.3 이상을 사용하여 만든 새 응용 프로그램은 제작자 ID를 지정하지 않아야 합니다.

자세한 내용은 AIR 제작자 ID를 참조하십시오.

부모 요소:application

자식 요소: 없음

내용

제작자 ID 문자열

예제

<publisherID>B146A943FBD637B68C334022D304CEA226D129B4.1</publisherID>

renderMode

현재 컴퓨팅 장치에서 지원하는 경우 GPU(Graphics Processing Unit) 가속을 사용할 것인지 여부를 지정합니다.

부모 요소:initialWindow

자식 요소: 없음

내용

다음 값 중 하나:

  • auto(기본값) - 현재 CPU 모드로 설정됩니다.

  • cpu - 하드웨어 가속이 사용되지 않습니다.

  • direct - 렌더링 컴포지션은 CPU에서 발생하고, 블록 전송 시에는 GPU가 사용됩니다. AIR 3 이상에서 사용 가능합니다.

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

    중요: Flex 응용 프로그램에 GPU 렌더링 모드를 사용하지 마십시오.

예제

<renderMode>direct</renderMode>

requestedDisplayResolution

고해상도 화면을 사용하는 장치 또는 컴퓨터 모니터에서 응용 프로그램이 표준 해상도를 사용할 것인지 아니면 고해상도를 사용할 것인지를 지정합니다. 기본값인 standard로 설정하면 해당 응용 프로그램이 표준 해상도 화면으로 나타납니다. high로 설정하면 응용 프로그램에서 각 고해상도 픽셀을 처리할 수 있습니다.

예를 들어 640x960 고해상도 iPhone 화면에서 설정이 standard인 경우 전체 화면 스테이지 크기는 320x480이고 각 응용 프로그램 픽셀은 네 개의 화면 픽셀을 사용하여 렌더링됩니다. 설정이 high이면 전체 화면 스테이지 크기는 640x960입니다.

표준 해상도 화면을 사용하는 장치에서는 어떤 설정을 사용하더라도 스테이지 크기가 화면 크기와 일치합니다.

requestedDisplayResolution 요소가 iPhone 요소에 중첩되어 있는 경우 iOS 장치에 적용됩니다. 이 경우 excludeDevices 특성을 사용하여 설정이 적용되지 않는 장치를 지정할 수 있습니다.

requestedDisplayResolution 요소가 initialWindow 요소에 중첩되어 있는 경우 고해상도 디스플레이를 지원하는 MacBook Pro 컴퓨터의 데스크톱 AIR 응용 프로그램에 적용됩니다. 지정된 값은 응용 프로그램에 사용되는 모든 기본 윈도우에 적용됩니다. requestedDisplayResolution 요소를 initialWindow 요소에 중첩하는 것은 AIR 3.6 이상에서 지원됩니다.

부모 요소: iPhone, initialWindow

자식 요소: 없음

내용

기본값인 standard 또는 high

특성:

excludeDevices - 공백으로 구분된 iOS 모델명 또는 모델명 접두어 목록입니다. 이를 통해 개발자가 어떤 장치는 고해상도를 사용하고 어떤 장치는 표준 해상도를 사용하도록 할 수 있습니다. 이 특성은 iOS에서만 사용할 수 있습니다(requestedDisplayResolution 요소가 iPhone 요소에 중첩됨). excludeDevices 특성은 AIR 3.6 이상에서 사용할 수 있습니다.

모델명이 이 특성에 지정되어 있는 모든 장치는 requestedDisplayResolution 값이 지정된 값의 반대입니다. 즉, requestedDisplayResolution 값이 high이면 예외 장치는 표준 해상도를 사용합니다. requestedDisplayResolution 값이 standard이면 예외 장치는 고해상도를 사용합니다.

값은 iOS 장치 모델명 또는 모델명 접두어입니다. 예를 들어 값 iPad3.1은 구체적으로 Wi-Fi 3세대 iPad를 가리킵니다(그러나 GSM 또는 CDMA 3세대 iPad는 해당되지 않음). 대신 값 iPad3은 모든 3세대 iPad를 가리킵니다. 비공식 iOS 모델명 목록은 iPhone wiki 모델 페이지에서 확인할 수 있습니다.

예제

데스크톱:

<initialWindow> 
    <requestedDisplayResolution>high</requestedDisplayResolution> 
</initialWindow>

iOS:

<iPhone> 
    <requestedDisplayResolution excludeDevices="iPad3 iPad4">high</requestedDisplayResolution> 
</iPhone>

resizable

윈도우 크기를 조절할 수 있는지 여부를 지정합니다.

참고: 윈도우 최대화가 크기 조절 작업인 Mac OS X와 같은 운영 체제에서 윈도우가 확대/축소 또는 크기 조절되지 않도록 하려면 maximizable과 resizable을 모두 false로 설정해야 합니다.

부모 요소:initialWindow

자식 요소:

내용

true(기본값) 또는 false

예제

<resizable>false</resizable>

softKeyboardBehavior

가상 키보드가 표시될 때 응용 프로그램의 기본 비헤이비어를 지정합니다. 기본 비헤이비어는 응용 프로그램을 위로 이동하는 것입니다. 런타임은 포커스가 있는 텍스트 필드 또는 대화형 객체를 화면에 계속 표시합니다. 응용 프로그램에서 자체적인 키보드 처리 논리를 제공하지 않는 경우 pan 옵션을 사용하십시오.

softKeyboardBehavior 요소를 none로 설정함으로써 자동 비헤이비어를 끌 수도 있습니다. 이러한 경우에는 소프트 키보드가 표시될 때 텍스트 필드 및 대화형 객체가 SoftKeyboardEvent를 전달하지만 런타임이 응용 프로그램을 이동하거나 응용 프로그램의 크기를 조절하지 않습니다. 텍스트 입력 영역이 눈에 보이도록 유지하는 동작은 응용 프로그램에서 수행합니다.

부모 요소:initialWindow

자식 요소: 없음

내용

none 또는 pan. 기본값은 pan입니다.

예제

<softKeyboardBehavior>none</softKeyboardBehavior>

supportedLanguages

응용 프로그램에서 지원하는 언어를 식별합니다. 이 요소는 iOS, Mac 전용 런타임 및 Android 응용 프로그램에서만 사용됩니다. 다른 모든 응용 프로그램 유형에서는 이 요소가 무시됩니다.

이 요소를 지정하지 않을 경우 기본적으로 패키지 프로그램은 응용 프로그램 유형에 따라 다음 작업을 수행합니다.

  • iOS - AIR 런타임이 지원하는 모든 언어가 iOS App Store에서 응용 프로그램의 지원되는 언어로 나열됩니다.

  • Mac 전용 런타임 - 전용 번들과 함께 패키지화된 응용 프로그램에 지역화 정보가 없습니다.

  • Android - 응용 프로그램 번들에 AIR 런타임이 지원하는 모든 언어에 대한 리소스가 있습니다.

부모 요소:application

자식 요소: 없음

내용

공백으로 구분된 지원되는 언어 목록입니다. 유효한 언어 값은 AIR 런타임이 지원하는 언어의 ISO 639‑1 값인 en, de, es, fr, it, ja, ko, pt, ru, cs, nl, pl, sv, tr, zh, da, nb, iw입니다.

<supportedLanguages> 요소의 값이 비어 있으면 패키지 프로그램에서 오류가 생성됩니다.

참고: <supportedLanguages> 태그를 사용하는 상황에서 이 태그에 특정 언어가 포함되어 있지 않으면 지역화된 태그(예: 이름 태그)가 해당 언어 값을 무시합니다. 기본 확장에 <supportedLangauges> 태그를 통해 지정되지 않은 언어에 대한 리소스가 있는 경우 경고가 발생하고 해당 언어에 대해 리소스가 무시됩니다.

예제

<supportedLanguages>en ja fr es</supportedLanguages>

supportedProfiles

응용 프로그램에서 지원하는 프로파일을 식별합니다.

부모 요소:application

자식 요소: 없음

내용

supportedProfiles 요소에는 다음 값 중 하나를 사용할 수 있습니다.

  • desktop - 데스크톱 프로파일은 AIR 파일을 사용하여 데스크톱 컴퓨터에 설치되는 AIR 응용 프로그램을 위한 것입니다. 이러한 응용 프로그램은 기본 응용 프로그램과의 통신을 제공하는 NativeProcess 클래스에 액세스할 수 없습니다.

  • extendedDesktop - 확장 데스크톱 프로파일은 기본 응용 프로그램 설치 프로그램을 사용하여 데스크톱 컴퓨터에 설치되는 AIR 응용 프로그램을 위한 것입니다. 이러한 응용 프로그램은 기본 응용 프로그램과의 통신을 제공하는 NativeProcess 클래스에 액세스할 수 있습니다.

  • mobileDevice - 휴대 장치 프로파일은 모바일 응용 프로그램을 위한 것입니다.

  • extendedMobileDevice - 확장 휴대 장치 프로파일은 현재 사용되고 있지 않습니다.

supportedProfiles 속성은 선택 사항입니다. 응용 프로그램 설명자 파일에 이 요소를 포함하지 않으면 모든 프로파일에서 응용 프로그램을 컴파일하고 배포할 수 있습니다.

프로파일을 여러 개 지정하려면 공백 문자로 프로파일을 구분하십시오. 예를 들어, 다음 설정은 응용 프로그램을 데스크톱 및 확장된 프로파일에서만 사용할 수 있도록 지정합니다.

<supportedProfiles>desktop extendedDesktop</supportedProfiles>
참고: ADL을 사용하여 응용 프로그램을 실행하고 ADL -profile 옵션에 대한 값을 지정하지 않으면 응용 프로그램 설명자에 있는 첫 번째 프로파일이 사용됩니다. 응용 프로그램 설명자에 프로파일이 지정되어 있지 않으면 데스크톱 프로파일이 사용됩니다.

예제

<supportedProfiles>desktop mobileDevice</supportedProfiles>

systemChrome

초기 응용 프로그램 윈도우가 운영 체제에서 제공하는 표준 제목 표시줄, 테두리 및 컨트롤과 함께 생성되는지 여부를 지정합니다.

런타임에는 윈도우의 시스템 크롬 설정을 변경할 수 없습니다.

부모 요소:initialWindow

자식 요소: 없음

내용

다음 값 중 하나:

  • none - 시스템 크롬이 제공되지 않습니다. 응용 프로그램(또는 Flex와 같은 응용 프로그램 프레임워크)에서 윈도우 크롬을 정하여 표시해야 합니다.

  • 표준(기본값) - 운영 체제에서 시스템 크롬을 제공합니다.

예제

<systemChrome>standard</systemChrome>

text

지역화된 문자열을 지정합니다.

text 요소의 xml:lang 특성은 RFC4646(http://www.ietf.org/rfc/rfc4646.txt)에 정의된 언어 코드를 지정합니다.

AIR 응용 프로그램 설치 프로그램은 사용되는 운영 체제의 사용자 인터페이스 언어에 가장 가까운 xml:lang 특성 값의 text 요소를 사용합니다.

예를 들어 text 요소에 en(영어) 로캘에 대한 값이 포함되어 있는 설치를 가정해 보십시오. 운영 체제가 en(영어)을 사용자 인터페이스 언어로 식별하는 경우 AIR 응용 프로그램 설치 프로그램은 en 이름을 사용합니다. 시스템 사용자 인터페이스 언어가 en-US(미국 영어)인 경우에도 en 이름이 사용됩니다. 그러나 사용자 인터페이스 언어가 en-US이며 응용 프로그램 설명자 파일이 en-US 이름과 en-GB 이름을 모두 정의하는 경우 AIR 응용 프로그램 설치 프로그램은 en-US 값을 사용합니다.

응용 프로그램이 시스템 사용자 인터페이스 언어와 일치하는 text 요소를 정의하지 않는 경우 AIR 응용 프로그램 설치 프로그램은 응용 프로그램 설명자 파일에 정의된 첫 번째 name 값을 사용합니다.

부모 요소:

자식 요소: 없음

내용

지역화된 텍스트의 로캘 및 문자열을 지정하는 xml:lang 특성

예제

<text xml:lang="fr">Bonjour AIR</text>

title

초기 응용 프로그램 윈도우의 제목 표시줄에 표시되는 제목을 지정합니다.

systemChrome 요소가 standard로 설정된 경우에만 제목이 표시됩니다.

부모 요소:initialWindow

자식 요소: 없음

내용

윈도우 제목을 포함하는 문자열

예제

<title>Example Window Title</title>

transparent

초기 응용 프로그램 윈도우가 데스크톱과 알파-블렌딩되는지 여부를 지정합니다.

투명도를 사용하는 윈도우는 보다 느리게 그려지며 더 많은 메모리가 필요할 수 있습니다. 런타임에는 투명 설정을 변경할 수 없습니다.

중요: systemChromenone인 경우에만 transparenttrue로 설정할 수 있습니다.

부모 요소:initialWindow

자식 요소: 없음

내용

true 또는 false(기본값)

예제

<transparent>true</transparent>

version

응용 프로그램에 대한 버전 정보를 지정합니다.

버전 문자열은 응용 프로그램이 정의하는 지정자입니다. AIR는 어떤 방식으로도 버전 문자열을 해석하지 않습니다. 따라서 "3.0" 버전이 "2.0" 버전보다 최신 버전이라고 가정할 수 없습니다. 몇 가지 예로는 "1.0", ".4", "0.5", "4.9", "1.3.4a" 등을 들 수 있습니다.

AIR 2.5 이상에서는 version 요소가 versionNumberversionLabel 요소로 대체됩니다.

부모 요소:application

자식 요소: 없음

내용

응용 프로그램 버전을 포함하는 문자열

예제

<version>0.1 Alpha</version>

versionLabel

사람이 읽을 수 있는 버전의 문자열을 지정합니다.

설치 대화 상자에서 versionNumber 요소의 값 대신 버전 레이블의 값이 표시됩니다. versionLabel이 사용되지 않으면 둘 다에 대해 versionNumber가 사용됩니다.

부모 요소:application

자식 요소: 없음

내용

공개적으로 표시되는 버전 텍스트를 포함하는 문자열

예제

<versionLabel>0.9 Beta</versionlabel>

versionNumber

응용 프로그램 버전 번호입니다.

부모 요소:application

자식 요소: 없음

내용

버전 번호는 마침표로 분리된 최대 세 개의 정수를 포함할 수 있습니다. 각 정수는 0에서 999 사이(포함)의 숫자여야 합니다.

예제

<versionNumber>1.0.657</versionNumber> 
 
<versionNumber>10</versionNumber> 
 
<versionNumber>0.01</versionNumber>

visible

초기 응용 프로그램 윈도우가 생성되는 즉시 표시되는지 여부를 지정합니다.

초기 윈도우를 비롯한 AIR 윈도우는 기본적으로 숨겨진 상태로 생성됩니다. NativeWindow 객체의 activate() 메서드를 호출하거나 visible 속성을 true로 설정하면 윈도우를 표시할 수 있습니다. 윈도우 위치, 윈도우 크기 및 윈도우 내용의 레이아웃에 대한 변경 사항이 표시되지 않도록 처음에는 기본 윈도우를 숨겨 둘 수도 있습니다.

MXML 정의에서 visible 특성이 false로 설정되어 있지 않은 한 Flex mx:WindowedApplication 구성 요소는 applicationComplete 이벤트가 전달되기 직전에 윈도우를 자동으로 표시 및 활성화합니다.

윈도우를 지원하지 않는 모바일 프로파일의 장치에서는 visible 설정이 무시됩니다.

부모 요소:initialWindow

자식 요소: 없음

내용

true 또는 false(기본값)

예제

<visible>true</visible>

width

응용 프로그램 기본 윈도우의 초기 폭입니다.

폭을 설정하지 않으면 루트 SWF 파일의 설정에 의해 결정되며 HTML 기반 AIR 응용 프로그램의 경우에는 운영 체제에 의해 결정됩니다.

AIR 2에서는 윈도우의 최대 폭이 2048픽셀에서 4096픽셀로 변경되었습니다.

부모 요소:initialWindow

자식 요소: 없음

내용

최대값이 4095인 양의 정수

예제

<width>1024</width>

x

초기 응용 프로그램 윈도우의 가로 위치입니다.

대부분의 경우 고정된 값을 할당하는 것보다 운영 체제에서 윈도우의 초기 위치를 결정하도록 하는 것이 좋습니다.

화면 좌표계의 원점(0,0)은 기본 데스크톱 화면(운영 체제에 의해 결정됨)의 왼쪽 위 모서리입니다.

부모 요소:initialWindow

자식 요소: 없음

내용

정수 값입니다.

예제

<x>120</x>

y

초기 응용 프로그램 윈도우의 세로 위치입니다.

대부분의 경우 고정된 값을 할당하는 것보다 운영 체제에서 윈도우의 초기 위치를 결정하도록 하는 것이 좋습니다.

화면 좌표계의 원점(0,0)은 기본 데스크톱 화면(운영 체제에 의해 결정됨)의 왼쪽 위 모서리입니다.

부모 요소:initialWindow

자식 요소: 없음

내용

정수 값입니다.

예제

<y>250</y>