AIR for TV uygulamalarında hata ayıklama

ADL kullanarak aygıt benzetimi

Birçok uygulama özelliğini test etmenin ve bunlarda hata ayıklamanın en hızlı ve kolay yolu, Adobe Hata Ayıklama Başlatıcısı (ADL) yardımcı programını kullanarak uygulamanızı geliştirme bilgisayarında çalıştırmaktır.

ADL kullanılacak profili seçmek için uygulama tanımlayıcısında supportedProfiles öğesini kullanır. Özel olarak belirtmek gerekirse:

  • Birden fazla profil listelenmişse ADL listedeki ilk profili kullanır.

  • supportedProfiles listesindeki diğer profillerden birini seçmek için ADL'nin -profile parametresini kullanabilirsiniz.

  • Uygulama tanımlayıcısına bir supportedProfiles öğesi dahil etmezseniz, -profile argümanı için herhangi bir profil belirtilebilir.

Örneğin, tv profilini benzetmek üzere bir uygulama başlatmak için aşağıdaki komutu kullanın: 
adl -profile tv myApp-app.xml

ADL ile masaüstünde tv veya extendedTV profilini benzetirken, uygulama hedef aygıtla daha yakından eşleşen bir ortamda çalışır. Örneğin:

  • -profile argümanında profilin bir parçası olmayan ActionScript API'leri kullanılamaz.

  • ADL, menü komutları aracılığıyla uzaktan kumanda gibi aygıt girdi kumandalarının girdilerine izin verir.

  • -profile argümanında tv veya extendedTV öğesini belirtmek ADL'nin masaüstünde StageVideo sınıfını benzetmesine izin verir.

  • -profile argümanında extendedTV öğesinin belirtilmesi, uygulamanın uygulama AIRN dosyasıyla birlikte paketlenen yerel uzantı saplamalarını veya benzeticilerini kullanmasına olanak verir.

Ancak, ADL uygulamayı masaüstünde çalıştırdığından AIR for TV uygulamalarını test etme işleminin sınırlamaları vardır:

  • Aygıtta uygulama performansını yansıtmaz. Performans testlerini hedef aygıtta gerçekleştirin.

  • StageVideo sınıfının sınırlamalarını benzetmez. Genellikle AIR for TV aygıtlarını hedef alırken bir video oynatmak için Video sınıfını değil StageVideo sınıfını kullanırsınız. StageVideo sınıfı, aygıtın donanımının performans avantajlarından yararlanır, ancak görüntü sınırlamaları vardır. ADL videoyu masaüstüne bu sınırlamalar olmadan oynatır. Bu nedenle, video oynatma işlemini hedef aygıtta test edin.

  • Bu öğe yerel bir uzantının yerel kodunun benzetimini yapamaz. Ancak ADL -profile argümanındaki yerel uzantıları destekleyen extendedTV profilini belirtebilirsiniz. ADL, ANE paketinde bulunan uzantısının yalnızca ActionScript saplaması veya benzetici sürümüyle test yapmanıza izin verir. Ancak, genellikle aygıtta yüklü olan karşılık gelen uzantısı yerel kodu da içerir. Kendi yerel koduyla uzantısını kullanarak test etmek için uygulamayı hedef aygıtta çalıştırın.

Daha fazla bilgi için bkz. AIR Hata Ayıklama Başlatıcısı (ADL) .

Yerel Uzantıları kullanma

Uygulamanız yerel uzantıları kullanıyorsa, ADL komutu aşağıdaki örnek gibi görünür: 

adl -profile extendedTV -extdir C:\extensionDirs myApp-app.xml

Örnek şunları varsayar:

  • ADL aracının yolunun komut satırı kabuğunuzun yol tanımında olduğunu. (Bkz. Path ortam değişkenleri .)

  • Geçerli dizin uygulama dosyalarını içerir. Bu dosyalar SWF dosyalarını ve bu örnekte myApp-app.xml olan uygulama tanımlayıcı dosyasını içerir.

  • -extdir parametresi uygulamanın kullandığı her yerel uzantı için bir dizin içeren bir dizini adlandırır. Bu dizinlerin her biri yerel bir uzantının paketlenmemiş ANE dosyasını içerir. Örneğin: 

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

    Bu paketlenmemiş ANE dosyaları uzantının yalnızca ActionScript saplamasını veya benzetici sürümünü içerir. Yerel kodu içeren uzantısının sürümü AIR for TV aygıtına yüklenir.

Daha fazla bilgi için bkz. Adobe AIR için Yerel Uzantılar Geliştirme .

Kumanda girdisi

ADL, bir TV aygıtındaki uzaktan kumanda düğmelerinin benzetimini yapar. ADL, TV profillerinden biri kullanılarak başlatıldığında görüntülenen menüyü kullanarak bu düğme girdilerini benzetilen aygıta gönderebilirsiniz.

Ekran boyutu

ADL -screensize parametresini ayarlayarak uygulamanızı farklı boyuttaki ekranlarda test edebilirsiniz. Normal ve ekranı kaplayan ekranların genişlik ve yüksekliklerini temsil eden dört değeri içeren bir dize belirtebilirsiniz.

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: 

adl -screensize 728x1024:768x1024 myApp-app.xml

İzleme ifadeleri

TV uygulamanızı masaüstünde çalıştırdığınızda, izleme çıktısı hata ayıklayıcısına veya ADL'yi başlatmak için kullanılan terminal penceresine yazdırılır.

Flash Professional ile uzaktan hata ayıklama

Hedef aygıtta çalışırken uzaktan AIR for TV uygulamanızda hata ayıklamak için Flash Professional 'i kullanabilirsiniz. Ancak, uzaktan hata ayıklama kurma adımları aygıta bağlıdır. Örneğin, Adobe® AIR® for TV MAX 2010 Donanım Geliştirme Kiti bu aygıt için ayrıntılı adımların belgelerini içerir.

Ancak hedef aygıttan bağımsız olarak uzaktan hata ayıklamaya hazırlanmak için aşağıdaki adımları uygulayın:

  1. Yayınlama Ayarları iletişim kutusunun Flash sekmesinde Hata Ayıklamaya İzin Ver'i seçin.

    Bu seçenek, Flash Professional'ın FLA dosyanızdan oluşturduğu tüm SWF dosyalarına hata ayıklama bilgilerini dahil etmesine neden olur.

  2. Adobe AIR Ayarları iletişim kutusunun (Uygulama ve Yükleyici Ayarları) İmza sekmesinde AIR Intermediate (AIRI) dosyası hazırlama seçeneğini belirleyin.

    Uygulamanızı geliştirmeye devam ederken dijital imza gerektirmeyen AIRI dosyasını kullanmanız yeterlidir.

  3. AIRI dosyasını oluşturarak uygulamanızı yayınlayın.

Son adımlar uygulamayı hedef aygıta yüklemek ve burada çalıştırmaktır. Ancak, bu adımlar aygıta bağlıdır.

Flash Builder ile uzaktan hata ayıklama

Hedef aygıtta çalışırken uzaktan AIR for TV uygulamanızda hata ayıklamak için Flash Builder'ı da kullanabilirsiniz. Ancak, uzaktan hata ayıklama gerçekleştirme adımları aygıta bağlıdır.

Ancak hedef aygıttan bağımsız olarak uzaktan hata ayıklamaya hazırlanmak için aşağıdaki adımları uygulayın:

  1. Project (Proje) > Export Release Build (Sürüm Yapısını Dışa Aktar) öğesini seçin. AIR Intermediate (AIRI) dosyası hazırlama seçeneğini belirtin.

    Uygulamanızı geliştirmeye devam ederken dijital imza gerektirmeyen AIRI dosyasını kullanmanız yeterlidir.

  2. AIRI dosyasını oluşturarak uygulamanızı yayınlayın.

  3. Uygulamanın AIRI paketini hata ayıklama bilgilerini içeren SWF dosyalarını içerecek şekilde değiştirin.

    Hata ayıklama bilgilerini içeren SWF dosyaları, bin-debug adlı bir dizinde uygulamanın Flash Builder proje dizininde bulunur. AIRI paketindeki SWF dosyalarını bin-debug dizinindeki SWF dosyalarıyla değiştirin.

Bir Windows geliştirme makinesinde bu değişikliği aşağıdakileri yaparak gerçekleştirebilirsiniz:

  1. .airi yerine .zip dosya adı uzantısına sahip olmasını sağlamak için AIR paketi dosyasını yeniden adlandırın.

  2. ZIP dosyası içeriklerini çıkarın.

  3. Çıkarılan dizin yapısındaki SWF dosyalarını bin-debug dizinindekilerle değiştirin.

  4. Çıkarılan dizindeki dosyaları yeniden sıkıştırın.

  5. Sıkıştırılmış dosyayı bir kez daha .airi dosya adı uzantısına sahip olacak şekilde değiştirin.

Mac geliştirme makinesi kullanıyorsanız, bu değiştirme adımları aygıta bağlıdır. Ancak, bunlar genellikle şunları içerir:

  1. AIRI paketini hedef aygıta yükleyin.

  2. Hedef aygıtta uygulamanın yükleme dizinindeki SWF dosyalarını bin-debug dizinindeki SWF dosyalarıyla değiştirin.

    Örneğin, Adobe AIR for TV MAX 2010 Donanım Geliştirme Kiti ile gelen aygıtı düşünün. AIRI paketini kitin belgelerinde açıklandığı gibi yükleyin. Daha sonra hedef aygıta erişmek için Mac geliştirme makinenizin komut satırında telnet'i kullanın. /opt/adobe/stagecraft/apps/ <uygulama adı> / yolunda bulunan uygulama yükleme dizinindeki SWF dosyalarını bin-debug dizinindeki SWF dosyalarıyla değiştirin.

Aşağıdaki adımlar Flash Builder ile uzaktan hata ayıklamak ve Adobe AIR for TV MAX 2010 Donanım Geliştirme Kiti ile birlikte gelen aygıt içindir.

  1. Flash Builder'ın çalıştığı geliştirme bilgisayarınızda, MAX 2010 Donanım Geliştirme Kiti ile birlikte gelen AIR for TV Aygıt Bağlayıcısı'nı çalıştırın. Bu geliştirme bilgisayarınızın IP adresini gösterir.

  2. Donanım kiti aygıtında, geliştirme kitiyle birlikte gelen DevMaster uygulamasını başlatın.

  3. DevMaster uygulamasında, AIR for TV Aygıt Bağlayıcısı'nda gösterildiği gibi geliştirme bilgisayarınızın IP adresini girin.

  4. DevMaster uygulamasında, Enable Remote Debugging (Uzaktan Hata Ayıklamayı Etkinleştir) öğesinin seçili olduğundan emin olun.

  5. DevMaster uygulamasından çıkın.

  6. Geliştirme bilgisayarında, AIR for TV Bağlayıcısı'nda Start (Başlat) öğesini seçin.

  7. Donanım kiti aygıtında başka bir uygulama başlatın. İzleme bilgilerinin AIR for TV Aygıt Bağlayıcısı'nda görüntülendiğini doğrulayın.

    İzleme bilgileri görüntülenmiyorsa, geliştirme bilgisayarı ve donanım kiti aygıtı bağlı değildir. Geliştirme bilgisayarında izleme bilgileri için kullanılan bağlantı noktasının kullanılabilir olduğundan emin olun. AIR for TV Aygıt Bağlayıcısı'nda farklı bir bağlantı noktası seçebilirsiniz. Ayrıca, güvenlik duvarınızın seçilen bağlantı noktasına erişim sağladığından emin olun.

Ardından, Flash Builder'da hata ayıklayıcıyı başlatın. Aşağıdakileri yapın:

  1. Flash Builder'da Run (Çalıştır) > Debug Configurations (Hata Ayıklama Yapılandırmaları) öğesini seçin.

  2. Yerel hata ayıklamaya yönelik varolan hata ayıklama yapılandırmasından projenin adını kopyalayın.

  3. Debug Configurations (Hata Ayıklama Yapılandırmaları) iletişim kutusunda Web Application (Web Uygulaması) öğesini seçin. Ardından New Launch Configuration (Yeni Başlangıç Yapılandırması) simgesini seçin.

  4. Proje adını Project (Proje) alanına yapıştırın.

  5. URL Or Path To Launch (Başlatmak için URL veya Yol) bölümünde Use Default (Varsayılanı Kullan) öğesindeki onay işaretini kaldırın. Ayrıca, metin alanına about:blank yazın.

  6. Değişikliklerinizi kaydetmek için Apply (Uygula) öğesini seçin.

  7. Flash Builder hata ayıklayıcısını başlatmak için Debug (Hata Ayıkla) öğesini seçin.

  8. Uygulamanızı donanım kiti aygıtında başlatın.

Artık Flash Builder hata ayıklayıcısını, örneğin, kesme noktası ayarlamak ve değişkenleri incelemek için kullanabilirsiniz.