응용 프로그램 설명자 파일은 이름, 버전, 저작권 및 기타 설정을 비롯한 전체 응용 프로그램에 대한 속성이 포함된 XML 파일입니다.
Flash Professional CS5는 [iPhone 설정] 대화 상자의 설정에 따라 응용 프로그램 설명자 파일을 생성합니다. 또한 텍스트 편집기에서 응용 프로그램 설명자 파일을 편집할 수도 있습니다. Flash Professional은 프로젝트 이름에 "-app.xml"을 추가하여 응용 프로그램 설명자 파일의 이름을 지정합니다. 예를 들어 HelloWorld 프로젝트의 응용 프로그램 설명자 파일 이름은 HelloWorld-app.xml이 됩니다. Flash Professional CS5 iPhone 설정 대화 상자에서 지원되지 않는 설정을 정의하려면 응용 프로그램 설명자 파일을 편집하면 됩니다. 예를 들어
InfoAdditions
요소를 정의하여 응용 프로그램의 info.Plist 설정을 정의할 수 있습니다.
-
iPhone 응용 프로그램을 만들려면
<application>
요소에 AIR 2.0 네임스페이스가 필요합니다.
<application xmlns="http://ns.adobe.com/air/application/2.0">
-
<id>
요소:
<id>com.example.as3.HelloWorld</id>
응용 프로그램 ID는 응용 프로그램을 고유하게 식별합니다. 권장되는 형식은
"com.company.AppName"
과 같이 DNS 스타일과 반대 방향인, 점으로 구분된 문자열입니다. 컴파일러는 이 값을 iPhone 응용 프로그램의 번들 ID로 사용합니다.
프로비저닝 파일이 특정 응용 프로그램 ID와 연결되어 있는 경우 이 요소에서 해당 응용 프로그램 ID를 사용합니다. Apple에서 Apple 응용 프로그램 ID의 시작 부분에 할당하는 문자(번들 시드 ID라고 함)는 무시하십시오. 예를 들어 프로비저닝 프로파일의 응용 프로그램 ID가 96LPVWEASL.com.example.bob.myApp인 경우 com.example.bob.myApp을 응용 프로그램 설명자 파일의 응용 프로그램 ID로 사용합니다.
프로비저닝 프로파일에서 여러(와일드카드) 응용 프로그램 ID를 허용하는 경우 응용 프로그램 ID는 별표로 끝납니다(예: 5RM86Z4DJM.*). Apple에 제공한 응용 프로그램 ID 와일드카드 패턴과 일치하는 응용 프로그램 ID를 입력합니다.
-
Apple 응용 프로그램 ID가 com.myDomain.*인 경우 응용 프로그램 설명자 파일의 응용 프로그램 ID는 com.myDomain으로 시작해야 합니다. com.myDomain.myApp 또는 com.myDomain.app22와 같은 응용 프로그램 ID를 지정할 수 있습니다.
-
Apple 응용 프로그램 ID가 *인 경우 응용 프로그램 설명자 파일의 응용 프로그램 ID는 유효한 문자로 구성된 임의의 문자열이 될 수 있습니다.
iPhone Dev Center(
http://developer.apple.com/iphone
)에서 프로비저닝 프로파일과 연결된 Apple 응용 프로그램 ID(또는 와일드카드 응용 프로그램 ID 패턴)를 확인할 수 있습니다. iPhone Developer Program Portal로 이동한 다음 [Provisioning] 섹션으로 이동합니다.
중요:
Apple 응용 프로그램 ID 앞쪽에 있는 문자는 무시하십시오. Apple에서는 이 문자열을 번들 시드 ID라고 합니다. 예를 들어 Apple에서 응용 프로그램 ID를 5RM86Z4DJM.*로 표시하는 경우 5RM86Z4DJM을 무시하십시오. 이는 와일드카드 응용 프로그램 ID입니다. Apple에서 응용 프로그램 ID를 96LPVWEASL.com.example.bob.myApp으로 표시하는 경우 96LPVWEASL을 무시하고 com.example.bob.myApp을 응용 프로그램 ID로 사용합니다.
-
<filename>
요소:
<filename>HelloWorld</filename>
iPhone 설치 프로그램 파일에 사용되는 이름입니다. 파일 이름에 더하기 기호(+)를 포함해서는 안 됩니다.
-
<name>
요소:
<name>Hello World</name>
iTunes 응용 프로그램과 iPhone에 표시되는 응용 프로그램 이름입니다. 이름에 더하기 기호(+)를 포함해서는 안 됩니다.
-
<version>
요소:
<version>1.0</version>
사용자에게 설치하는 응용 프로그램의 버전을 알려줍니다. 이 버전은 iPhone 응용 프로그램의 CFBundleVersion으로 사용되며, nnnnn[.nn[.nn]]과 유사한 형식이어야 합니다. 여기서 n은 0-9 사이의 숫자이고 대괄호는 1, 1.0 또는 1.0.1과 같이 선택적 구성 요소를 나타냅니다. iPhone 버전에는 숫자와 소수점만 사용해야 합니다. iPhone 버전에는 소수점 이하 두 자리 숫자까지 포함할 수 있습니다.
-
<initialWindow>
요소에는 응용 프로그램의 초기 모양에 대한 속성을 지정하는 다음 자식 요소가 포함되어 있습니다.
<content>HelloWorld.swf</content>
iPhone 응용 프로그램으로 컴파일할 루트 SWF 파일을 식별합니다.
<visible>true</visible>
필수 설정입니다.
<fullScreen>true</fullScreen>
응용 프로그램이 iPhone의 전체 화면을 사용하도록 지정합니다.
<aspectRatio>portrait</aspectRatio>
응용 프로그램의 초기 종횡비를 가로 모드가 아닌 세로 모드로 지정합니다. 응용 프로그램의 초기 윈도우를 정의하는 데 사용되는 Default.png 파일은 이 설정에 관계없이 폭 320픽셀, 높이 480픽셀이어야 합니다. 자세한 내용은
iPhone 아이콘 및 초기 화면 이미지
를 참조하십시오.
<autoOrients>true</autoOrients>
(선택 사항) 장치 자체의 실제 방향이 변경되는 경우 응용 프로그램 내 내용의 방향이 자동으로 조정되도록 할지 여부를 지정합니다. 기본값은
true
입니다. 자동 방향은
orientationChanging
이벤트의
preventDefault()
메서드를 호출하여 취소할 수 있습니다. 이 메서드는 Stage 객체에서 전달됩니다. 자세한 내용은
화면 방향 설정 및 감지
를 참조하십시오.
자동 방향 조정을 사용할 때 최적의 결과를 얻으려면 Stage의
align
속성을 다음과 같이 설정합니다.
stage.align = StageAlign.TOP_LEFT;
stage.scaleMode = StageScaleMode.NO_SCALE;
<renderMode>gpu</renderMode>
(선택 사항) 응용 프로그램에 사용되는 렌더링 모드입니다. 세 가지 설정 중에서 선택할 수 있습니다.
-
cpu
- CPU를 사용하여 응용 프로그램의 모든 객체를 렌더링합니다. 하드웨어 가속은 사용되지 않습니다.
-
gpu
- 응용 프로그램에서 iPhone GPU를 사용하여 비트맵을 합성합니다.
-
auto
- 이 기능은 아직 구현되지 않았습니다.
자세한 내용은
하드웨어 가속
을 참조하십시오.
-
<profiles>
요소:
<profiles>mobileDevice</profiles>
응용 프로그램이 휴대 장치 프로파일로 컴파일되도록 제한합니다. 이 프로파일은 현재 iPhone 응용 프로그램만 지원합니다. 다음 세 가지 프로파일이 지원됩니다.
-
desktop
- 데스크톱 AIR 응용 프로그램
-
extendedDesktop
- 기본 프로세스 API를 지원하는 데스크톱 AIR 응용 프로그램
-
mobileDevice
- 휴대 장치용 AIR 응용 프로그램. 현재 휴대 장치는 iPhone만 지원됩니다.
응용 프로그램을 특정 프로파일로 제한하면 다른 프로파일로는 컴파일되지 않습니다. 프로파일을 지정하지 않은 경우에는 응용 프로그램을 세 가지 프로파일 중 원하는 것으로 컴파일할 수 있습니다. 둘 이상의 프로파일을 각각 공백으로 구분하여
<profiles>
요소에 나열하는 방법으로 복수의 프로파일을 지정할 수 있습니다.
mobileDevice
를 지원되는 프로파일에 반드시 포함해야 합니다(또는
<profiles>
요소를 비워둠).
-
<icon>
요소에는 응용 프로그램에 사용되는 아이콘을 지정하는 다음 자식 요소가 포함되어 있습니다.
<image29x29>icons/icon29.png</image29x29>
Spotlight 검색 결과에 사용되는 이미지입니다.
<image48x48>icons/icon48.png</image48x48>
iPad의 Spotlight 검색 결과에 사용되는 이미지입니다.
<image57x57>icons/icon57.png</image57x57>
iPhone 및 iPod Touch 홈 화면에 사용되는 이미지입니다.
<image72x72>icons/icon72.png</image72x72>
iPad 홈 화면에 사용되는 이미지입니다.
<image512x512>icons/icon512.png</image512x512>
iTunes 응용 프로그램에 사용되는 이미지입니다.
Packager for iPhone 도구는 응용 프로그램 설명자 파일에서 참조되는 29, 57 및 512 아이콘을 사용합니다. 해당 아이콘을 각각 Icon-Small.png, Icon.png 및 iTunesArtwork라는 파일에 복사합니다. 파일을 직접 패키지화하면 파일을 각각 복사하는 번거로움을 덜 수 있습니다. 응용 프로그램 설명자 파일이 들어 있는 디렉토리에 파일을 넣고 올바른 이름과 경로를 나열하여 패키지화합니다.
512 이미지는 내부 테스트용으로만 사용됩니다. 응용 프로그램을 Apple로 전송할 때 512 이미지는 별도로 전송합니다. 이 이미지는 IPA에 포함되지 않습니다. 512 이미지가 iTunes에서 잘 표시되도록 전송하기 전에 이 이미지를 지정하십시오.
-
<iPhone>
요소에는 iPhone 고유 설정을 지정하는 다음 자식 요소가 포함되어 있습니다.
<InfoAdditions></InfoAdditions>
에는 응용 프로그램의 Info.plist 설정으로 사용할 키-값 쌍을 지정하는 자식 요소가 포함됩니다.
<![CDATA[
<key>UIStatusBarStyle</key>
<string>UIStatusBarStyleBlackOpaque</string>
<key>UIRequiresPersistentWiFi</key>
<string>NO</string>
]]>
이 예제에서 값은 응용 프로그램의 상태 표시줄 스타일을 설정하며, 응용 프로그램에 지속적인 Wi-Fi 액세스가 필요하지 않음을 나타냅니다.
InfoAdditions 설정은
CDATA
태그 안에 있습니다.
iPad 지원을 위해
UIDeviceFamily
에 대한 키 값 설정을 포함합니다.
UIDeviceFamily
설정은 문자열 배열입니다. 각 문자열은 지원되는 장치를 정의합니다.
<string>1</string>
설정은 iPhone 및 iPod Touch에 대한 지원을 정의합니다.
<string>2</string>
설정은 iPad에 대한 지원을 정의합니다.
<string>3</string>
설정은 tvOS에 대한 지원을 정의합니다. 이러한 문자열 중 하나만 지정하는 경우 해당 장치 제품군만 지원됩니다. 예를 들어 다음 설정은 iPad로 지원을 제한합니다.
<key>UIDeviceFamily</key>
<array>
<string>2</string>
</array>>
다음은 두 가지 장치 제품군(iPhone/iPod Touch 및 iPad) 모두에 대해 지원을 설정합니다.
<key>UIDeviceFamily</key>
<array>
<string>1</string>
<string>2</string>
</array>
다른 Info.plist 설정에 대한 자세한 내용은 Apple 개발자 설명서를 참조하십시오.
