다음의 요소 사전에서는 AIR 응용 프로그램 설명자 파일의 각 유효 요소에 대해 설명합니다.
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 파일을 로드할 경우 두 가지 문제가 발생할 수 있습니다.
내용
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의
align
및
scaleMode
속성을 다음과 같이 설정하는 것이 좋습니다.
stage.align = StageAlign.TOP_LEFT;
stage.scaleMode = StageScaleMode.NO_SCALE;
이러한 설정은 응용 프로그램이 왼쪽 위 모서리를 중심으로 회전하도록 하고 응용 프로그램 내용의 크기가 자동으로 조절되는 것을 방지합니다. 다른 크기 조절 모드는 회전한 스테이지 크기에 맞게 내용을 조정하기는 하지만 해당 내용을 잘라내거나, 왜곡하거나, 과도하게 축소할 수 있습니다. 거의 언제나 내용을 직접 다시 그리거나 배치함으로써 더 나은 결과를 얻을 수 있습니다.
부모 요소:
initialWindow
자식 요소:
없음
예제
<autoOrients>true</autoOrients>
colorDepth
16비트 색상을 사용할지 아니면 32비트 색상을 사용할지를 지정합니다.
16비트 색상을 사용하면 렌더링 성능이 증가하지만 색상 충실도가 떨어질 수 있습니다. AIR 3 이전에는 Android에 항상 16비트 색상이 사용되지만, AIR 3에서는 기본적으로 32비트 색상이 사용됩니다.
참고:
응용 프로그램에서 StageVideo 클래스를 사용하는 경우 32비트 색상을 사용해야 합니다.
부모 요소:
android
자식 요소:
없음
예제
<android>
<colorDepth>16bit</colorDepth>
<manifestAdditions>...</manifestAdditions>
</android>
containsVideo
응용 프로그램에 비디오 내용이 포함될지 여부를 지정합니다.
부모 요소:
android
자식 요소:
없음
예제
<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
메커니즘이 작동합니다.
customUpdateUI
가
true
인지 여부에 관계없이 필요에 따라 사용자 정의 UI를 표시하며 고유한 응용 프로그램 논리를 통해 업데이트를 다운로드 및 시작할 수 있습니다.
자세한 내용은
AIR 응용 프로그램 업데이트
를 참조하십시오.
부모 요소:
application
자식 요소:
없음
예제
<customUpdateUI>true</customUpdateUI>
depthAndStencil
응용 프로그램에서 심도 또는 스텐실 버퍼를 사용해야 한다는 것을 나타냅니다. 일반적으로 이러한 버퍼는 3D 내용으로 작업하는 경우에 사용합니다. 기본적으로 이 요소의 값은 심도 및 스텐실 버퍼를 비활성화하는
false
입니다. 이 요소가 필요한 이유는 응용 프로그램 시작 시 내용이 로드되기 전에 버퍼를 할당해야 하기 때문입니다.
이 요소의 설정은
enableDepthAndStencil
인수에 대해
Context3D.configureBackBuffer()
메서드로 전달되는 값과 일치해야 합니다. 값이 일치하지 않으면 AIR에서 오류가 발생합니다.
이 요소는
renderMode
가
direct
인 경우에만 적용할 수 있습니다.
renderMode
가
direct
가 아닌 경우에는 ADT에서 오류 118이 발생합니다.
<depthAndStencil> element unexpected for render mode cpu. It requires "direct" render mode.
부모 요소:
initialWindow
자식 요소:
없음
예제
<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
자식 요소:
없음
예제
<fullscreen>true</fullscreen>
height
응용 프로그램 기본 윈도우의 초기 높이입니다.
높이를 설정하지 않으면 루트 SWF 파일의 설정에 의해 결정되며 HTML 기반 AIR 응용 프로그램의 경우에는 운영 체제에 의해 결정됩니다.
AIR 2에서는 윈도우의 최대 높이가 2048픽셀에서 4096픽셀로 변경되었습니다.
부모 요소:
initialWindow
자식 요소:
없음
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가 플랫폼에서 윈도우를 지원하는지 여부에 따라 일부 요소는 무시됩니다.
내용
응용 프로그램 모양 및 비헤이비어를 정의하는 자식 요소
예제
<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>
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 요소의 다음 특성은 설정할 수 없습니다.
예제
<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
자식 요소:
없음
예제
<maximizable>false</maximizable>
maxSize
윈도우의 최대 크기입니다. 최대 크기를 설정하지 않으면 운영 체제에 의해 결정됩니다.
부모 요소:
initialWindow
자식 요소:
없음
내용
최대 폭 및 높이를 나타내는 두 개의 정수로, 공백에 의해 분리됩니다.
참고:
AIR 2에서는 AIR가 지원하는 최대 윈도우 크기가 2048x2048 픽셀에서 4096x4096 픽셀로 늘어났습니다. 스크린 좌표는 0부터 시작되므로 폭 또는 높이에 사용할 수 있는 최대값은 4095입니다.
예제
<maxSize>1024 360</maxSize>
minimizable
윈도우를 최소화할 수 있는지 여부를 지정합니다.
부모 요소:
initialWindow
자식 요소:
없음
예제
<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
자식 요소:
없음
예제
<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
자식 요소:
없음
특성:
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
자식 요소:
예제
<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
자식 요소:
없음
예제
<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
초기 응용 프로그램 윈도우가 데스크톱과 알파-블렌딩되는지 여부를 지정합니다.
투명도를 사용하는 윈도우는 보다 느리게 그려지며 더 많은 메모리가 필요할 수 있습니다. 런타임에는 투명 설정을 변경할 수 없습니다.
중요:
systemChrome
이
none
인 경우에만
transparent
를
true
로 설정할 수 있습니다.
부모 요소:
initialWindow
자식 요소:
없음
예제
<transparent>true</transparent>
version
응용 프로그램에 대한 버전 정보를 지정합니다.
버전 문자열은 응용 프로그램이 정의하는 지정자입니다. AIR는 어떤 방식으로도 버전 문자열을 해석하지 않습니다. 따라서 "3.0" 버전이 "2.0" 버전보다 최신 버전이라고 가정할 수 없습니다. 몇 가지 예로는
"1.0"
, "
.4"
, "
0.5
",
"4.9"
,
"1.3.4a"
등을 들 수 있습니다.
AIR 2.5 이상에서는
version
요소가
versionNumber
및
versionLabel
요소로 대체됩니다.
부모 요소:
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
자식 요소:
없음
예제
<visible>true</visible>
width
응용 프로그램 기본 윈도우의 초기 폭입니다.
폭을 설정하지 않으면 루트 SWF 파일의 설정에 의해 결정되며 HTML 기반 AIR 응용 프로그램의 경우에는 운영 체제에 의해 결정됩니다.
AIR 2에서는 윈도우의 최대 폭이 2048픽셀에서 4096픽셀로 변경되었습니다.
부모 요소:
initialWindow
자식 요소:
없음
x
초기 응용 프로그램 윈도우의 가로 위치입니다.
대부분의 경우 고정된 값을 할당하는 것보다 운영 체제에서 윈도우의 초기 위치를 결정하도록 하는 것이 좋습니다.
화면 좌표계의 원점(0,0)은 기본 데스크톱 화면(운영 체제에 의해 결정됨)의 왼쪽 위 모서리입니다.
부모 요소:
initialWindow
자식 요소:
없음
y
초기 응용 프로그램 윈도우의 세로 위치입니다.
대부분의 경우 고정된 값을 할당하는 것보다 운영 체제에서 윈도우의 초기 위치를 결정하도록 하는 것이 좋습니다.
화면 좌표계의 원점(0,0)은 기본 데스크톱 화면(운영 체제에 의해 결정됨)의 왼쪽 위 모서리입니다.
부모 요소:
initialWindow
자식 요소:
없음
|
|
|