AIR Hata Ayıklama Başlatıcısı (ADL)

ADL ile bir uygulama çalıştırmak için aşağıdaki deseni kullanın:

adl application.xml

Uygulamanın uygulama tanımlayıcı dosyası application.xml olduğunda.

ADL için tam söz dizimi şudur:

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

(Köşeli parantez [] içindeki öğeler isteğe bağlıdır.)

-runtime runtime-directory Kullanılacak çalışma zamanını içeren dizini belirtir. Belirtilmemişse, ADL programıyla aynı SDK'de bulunan çalışma zamanı dizini kullanılır. ADL'i SDK klasörünün dışına taşırsanız, çalışma zamanı dizinini belirtin. Windows ve Linux'ta, Adobe AIR dizinini içeren dizini belirtin. Mac OS X'te, Adobe AIR.framework içeren dizini belirtin.

-pubid publisher-id Bu çalıştırma için AIR uygulamasının yayıncı kimliği olarak belirtilen değeri atar. Geçici bir yayıncı belirlemek, yerel bağlantı üzerinden iletişim kurma gibi, bir uygulamanın benzersiz olarak tanımlanmasına yardımcı olan yayıncı kimliğini kullanan AIR uygulaması özelliklerini test etmenizi sağlar. AIR 1.5.3'te olduğu gibi, uygulama açıklayıcı dosyasındaki yayıncı kimliğini de belirleyebilirsiniz (ve bu parametreyi kullanmamalısınız).

-nodebug Hata ayıklama desteğini kapatır. Kullanılırsa, uygulama işlemi Flash hata ayıklayıcıya bağlanamaz ve işlenmeyen istisnaların iletişim kutuları bastırılır. (Ancak, izleme ifadeleri konsol penceresine yazdırmaya devam eder.) Hata ayıklamanın kapatılması, uygulamanızın biraz daha hızlı çalışmasını sağlar ve ayrıca yüklenmiş bir uygulamanın çalışma modunu daha iyi taklit eder.

- atlogin Oturum açma sırasında uygulamanın başlatılmasını benzetir. Bu bayrak, yalnızca bir uygulama kullanıcı oturum açtığında başlatılmak üzere ayarlandığında yürütülen uygulama mantığını test etmenizi sağlar. -atlogin kullanıldığında, uygulamaya gönderilen InvokeEvent nesnesinin reason özelliği standard yerine login olur (uygulama zaten çalışmıyorsa).

-profile profileName ADL belirtilen profili kullanarak uygulamanın hatalarını ayıklar. profileName aşağıdaki değerlerden biri olabilir:

• desktop

• extendedDesktop

• mobileDevice

Uygulama tanımlayıcısı bir supportedProfiles öğesi içeriyorsa, -profile ile belirttiğiniz profil desteklenen listenin bir üyesi olmalıdır. -profile bayrağı kullanılmıyorsa uygulama tanımlayıcısındaki ilk profil etkin profil olarak kullanılır. Uygulama tanımlayıcısı supportedProfiles öğesini içermiyorsa ve -profile bayrağını kullanmıyorsanız, desktop profili kullanılır.

Daha fazla bilgi için bkz. supportedProfiles ve Aygıt profilleri .

-screensize value Masaüstünde mobileDevice profilinde uygulama çalıştırırken kullanılacak taklit edilen ekran boyutu. Ekran boyutunu önceden tanımlanmış ekran türü olarak veya dikey mizanpaj için normal genişlik ve yükseklik artı tam ekran genişliği ve yüksekliğinin piksel boyutları olarak belirtin. Değeri türe göre belirtmek için aşağıdaki önceden belirlenmiş ekran türlerinden birini kullanın:

Piksel boyutlarını doğrudan belirtmek için aşağıdaki biçimi kullanın:

widthXheight:fullscreenWidthXfullscreenHeight

Dikey mizanpaj için piksel boyutlarını her zaman belirtin. Bu, genişlik değerinin yükseklik değerinden daha küçük olarak belirtilmesi anlamına gelir. Örneğin, NexusOne ekranı şununla belirtilebilir:

-screensize 480x762:480x800

-extdir extension-directory Çalışma zamanının yerel uzantıları araması gerektiği dizin. Dizin uygulamanın kullandığı her yerel uzantı için bir alt dizin içerir. Bu dizinlerin her biri, bir uzantının paketlenmemiş ANE dosyasını içerir. Örneğin:

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 parametresini kullanırken aşağıdakileri göz önünde bulundurun:

application.xml Uygulama tanımlayıcı dosyası. Bkz. AIR uygulama tanımlayıcı dosyaları . Uygulama açıklayıcısı ADL tarafından gerekli görülen tek parametredir ve çoğu zaman ihtiyaç duyulan tek parametredir.

root-directory Uygulamanın çalıştırılacak kök dizinini belirtir. Belirtilmemişse, uygulama tanımlayıcı dosyasını içeren dizin kullanılır.

-- arguments "--" karakterlerinden sonra gelen tüm karakter dizeleri uygulamaya komut satırı argümanları olarak iletilir.

Geçerli dizinde bir uygulama çalıştırın:

adl myApp-app.xml

Geçerli dizinin alt dizininde bir uygulama çalıştırın:

adl source/myApp-app.xml release

Bir uygulama çalıştırın ve "tick" ve "tock" olmak üzere iki komut satırı argümanını iletin:

adl myApp-app.xml -- tick tock

Belirli bir çalışma zamanını kullanarak bir uygulama çalıştırın:

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

Hata ayıklama desteği olmadan bir uygulama çalıştırın:

adl -nodebug myApp-app.xml

Mobil aygıt profilinde bir uygulama çalıştırın ve Nexus One ekran boyutunun benzetimini yapın:

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

Uygulamayı çalıştırmak için Apache Ant kullanarak bir uygulama çalıştırın (örnekte gösterilen yollar Windows içindir):

<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>

Aşağıdaki tablo, ADL tarafından yazdırılan çıkış kodlarını açıklamaktadır: