ADL(AIR Debug Launcher)

ADL로 응용 프로그램을 실행하려면 다음과 같은 패턴을 사용하십시오.

adl application.xml

여기서 application.xml 은 응용 프로그램의 응용 프로그램 설명자 파일입니다.

ADL의 전체 구문은 다음과 같습니다.

adl     [-runtime runtime-directory] 
    [-pubid publisher-id] 
    [-nodebug] 
    [-atlogin] 
    [-profile profileName] 
    [-screensize value] 
    [-extdir extension-directory] 
    application.xml 
    [root-directory] 
    [-- arguments]

대괄호 [] 안의 항목은 선택 사항입니다.

-runtime runtime-directory 사용할 런타임이 포함된 디렉토리를 지정합니다. 지정하지 않을 경우 ADL 프로그램과 같은 SDK의 런타임 디렉토리가 사용됩니다. SDK 폴더에서 ADL을 다른 위치로 이동할 경우 런타임 디렉토리를 지정해야 합니다. Windows 및 Linux에서는 Adobe AIR 디렉토리가 포함된 디렉토리를 지정하십시오. Mac OS X에서는 Adobe AIR.framework 가 포함된 디렉토리를 지정하십시오.

-pubid publisher-id 이 실행에 대한 AIR 응용 프로그램의 제작자 ID로 지정된 값을 지정합니다. 임시 제작자 ID를 지정함으로써 로컬 연결을 통한 통신과 같이 제작자 ID를 사용하여 응용 프로그램을 고유하게 식별하는 AIR 응용 프로그램의 기능을 테스트할 수 있습니다. AIR 1.5.3부터는 응용 프로그램 설명자 파일에서 제작자 ID를 지정할 수도 있습니다(이 매개 변수를 사용해서는 안 됨).

-nodebug 디버깅 지원 기능을 해제합니다. 이를 사용할 경우 응용 프로그램 프로세스는 Flash 디버거에 연결되지 못하고 처리되지 않은 예외에 대한 대화 상자가 표시되지 않습니다. 그러나 trace 문은 계속 콘솔 윈도우에 인쇄됩니다. 디버깅 기능을 해제하면 응용 프로그램을 좀 더 빠르게 실행할 수 있으며 설치된 응용 프로그램의 실행 모드를 보다 근접하게 에뮬레이션할 수 있습니다.

- atlogin 로그인 시 응용 프로그램 실행을 시뮬레이션합니다. 이 플래그를 통해 사용자가 로그인하면 응용 프로그램이 실행되도록 설정된 경우에만 실행되는 응용 프로그램 논리를 테스트할 수 있습니다. -atlogin 이 사용되는 경우 응용 프로그램에 전달되는 InvokeEvent 객체의 reason 속성은 standard 가 아닌 login 입니다(응용 프로그램이 아직 실행되지 않고 있는 경우).

-profile profileName ADL은 지정된 프로파일을 사용하여 응용 프로그램을 디버깅합니다. profileName 은 다음 값 중 하나가 될 수 있습니다.

• desktop

• extendedDesktop

• mobileDevice

응용 프로그램 설명자에 supportedProfiles 요소가 있으면 -profile 을 사용하여 지정하는 프로파일이 지원되는 목록에 포함되어 있어야 합니다. -profile 플래그를 사용하지 않으면 응용 프로그램 설명자에 있는 첫 번째 프로파일이 활성 프로파일로 사용됩니다. 응용 프로그램 설명자에 supportedProfiles 요소가 포함되어 있지 않을 때 -profile 플래그를 사용하지 않으면 desktop 프로파일이 사용됩니다.

자세한 내용은 supportedProfiles 및 장치 프로파일 을 참조하십시오.

-screensize 값 데스크톱에서 mobileDevice 프로파일에 있는 응용 프로그램을 실행할 때 사용할 시뮬레이트한 스크린 크기입니다. 스크린 크기를 미리 정의된 스크린 유형 또는 세로 레이아웃의 보통 폭 및 높이에 대한 픽셀 크기로 지정한 후에 전체 화면 폭 및 높이를 지정하십시오. 유형을 기준으로 값을 지정하려면 다음과 같은 미리 정의된 스크린 유형 중 하나를 사용하십시오.

스크린 픽셀 크기를 직접 지정하려면 다음 포맷을 사용하십시오.

widthXheight:fullscreenWidthXfullscreenHeight

항상 세로 레이아웃에 대한 픽셀 크기를 지정합니다. 이는 높이 값보다 작은 값을 폭에 지정해야 한다는 것을 의미합니다. 예를 들어 NexusOne 스크린은 다음을 사용하여 지정할 수 있습니다.

-screensize 480x762:480x800

-extdir extension-directory 런타임이 기본 확장을 검색해야 하는 디렉토리입니다. 이 디렉토리에는 응용 프로그램에 사용되는 각 기본 확장의 하위 디렉토리가 포함되어 있습니다. 이러한 각 하위 디렉토리에는 확장의 패키지화되지 않은 ANE 파일이 포함되어 있습니다. 예를 들면 다음과 같습니다.

C:\extensionDirs\ 
    extension1.ane\ 
        META-INF\ 
            ANE\ 
                Android-ARM\ 
                    library.swf 
                    extension1.jar 
                extension.xml 
            signatures.xml 
        catalog.xml 
        library.swf 
        mimetype 
    extension2.ane\ 
        META-INF\ 
            ANE\ 
                Android-ARM\ 
                    library.swf 
                    extension2.jar 
                extension.xml 
            signatures.xml 
        catalog.xml 
        library.swf 
        mimetype 
    

-extdir 매개 변수를 사용할 경우 다음 사항에 유의하십시오.

application.xml 응용 프로그램 설명자 파일입니다. AIR 응용 프로그램 설명자 파일 을 참조하십시오. 응용 프로그램 설명자는 ADL의 유일한 필수 매개 변수이고, 대부분의 경우 이 매개 변수 외의 다른 매개 변수는 필요하지 않습니다.

root-directory 실행할 응용 프로그램의 루트 디렉토리를 지정합니다. 지정하지 않으면 응용 프로그램 설명자 파일이 포함된 디렉토리가 사용됩니다.

-- arguments "--" 다음에 나타나는 모든 문자열은 명령줄 인수로 응용 프로그램에 전달됩니다.

현재 디렉토리에서 응용 프로그램 실행:

adl myApp-app.xml

현재 디렉토리의 하위 디렉토리에서 응용 프로그램 실행:

adl source/myApp-app.xml release

응용 프로그램을 실행하고 두 개의 명령줄 인수인 "tick"과 "tock"을 전달:

adl myApp-app.xml -- tick tock

특정 런타임을 사용하여 응용 프로그램 실행:

adl -runtime /AIRSDK/runtime myApp-app.xml

디버깅 지원 없이 응용 프로그램 실행:

adl -nodebug myApp-app.xml

휴대 장치 프로파일에서 응용 프로그램을 실행하고 Nexus One 스크린 크기를 시뮬레이트합니다.

adl -profile mobileDevice -screensize NexusOne myMobileApp-app.xml

Apache Ant를 사용하는 응용 프로그램을 실행하여 이 응용 프로그램을 실행합니다(예제에 표시된 경로는 Windows에 해당함).

<property name="SDK_HOME" value="C:/AIRSDK"/> 
<property name="ADL" value="${SDK_HOME}/bin/adl.exe"/> 
<property name="APP_ROOT" value="c:/dev/MyApp/bin-debug"/> 
<property name="APP_DESCRIPTOR" value="${APP_ROOT}/myApp-app.xml"/> 
 
<target name="test"> 
    <exec executable="${ADL}"> 
        <arg value="${APP_DESCRIPTOR}"/> 
        <arg value="${APP_ROOT}"/> 
    </exec>  
</target>

다음 표에서는 ADL이 인쇄하는 종료 코드에 대해 설명합니다.