Debugowanie aplikacji AIR dla urządzeń telewizyjnych

Symulowanie urządzenia przy użyciu narzędzia ADL

Najszybszym i najprostszym sposobem testowania i debugowania większości funkcji aplikacji jest uruchomienie jej na komputerze używanym do programowania za pośrednictwem narzędzia ADL (Adobe Debug Launcher).

Narzędzie ADL używa elementu supportedProfiles z deskryptora aplikacji w celu wybrania profilu do zastosowania. Szczegóły:

  • Jeśli na liście jest więcej niż jeden profil, narzędzie ADL używa pierwszej pozycji na liście.

  • Parametr -profile narzędzia ADL pozwala wybrać dowolny profil z listy supportedProfiles .

  • Jeśli w deskryptorze aplikacji nie jest umieszczony element supportedProfiles , wówczas w argumencie -profile można określić dowolny profil.

Przykładowo za pomocą następującego polecenia można uruchomić aplikację w celu zasymulowania profilu tv . 
adl -profile tv myApp-app.xml

Gdy na komputerze jest symulowany profil tv lub extendedTV przy użyciu narzędzia ADL, aplikacja jest uruchamiana w środowisku, które możliwie najbardziej przypomina urządzenie docelowe. Na przykład:

  • Interfejsy API języka ActionScript, które nie są częścią profilu wskazanego w argumencie -profile , nie są dostępne.

  • Narzędzie ADL umożliwia wprowadzanie poleceń sterujących urządzeniem, takich jak polecenia z pilota zdalnego sterowania, za pomocą poleceń menu.

  • Określenie profilu tv lub extendedTV w argumencie -profile umożliwia narzędziu ADL symulowanie klasy StageVideo na komputerze.

  • Określenie profilu extendedTV w argumencie -profile pozwala aplikacji korzystać z symulatorów rozszerzeń natywnych spakowanych w pliku aplikacji AIRN.

Narzędzie ADL uruchamia aplikację na komputerze, dlatego podczas testowania aplikacji AIR dla urządzeń telewizyjnych występują ograniczenia:

  • Testowanie nie odzwierciedla wydajności aplikacji na urządzeniu. Wydajność należy przetestować na urządzeniu docelowym.

  • Testowanie nie symuluje ograniczeń obiektu StageVideo. Zwykle klasa StageVideo (a nie klasa Video) jest używana do odtwarzania wideo podczas określania docelowych urządzeń telewizyjnych ze środowiskiem AIR. Klasa StageVideo korzysta z wydajności oferowanej przez rozwiązania sprzętowe urządzenia, ale występują przy tym ograniczenia dotyczące wyświetlania. Narzędzie ADL odtwarza wideo na komputerze bez takich ograniczeń. Z tego względu odtwarzanie wideo należy przetestować na urządzeniu docelowym.

  • Testowanie nie symuluje kodu natywnego zawartego w rozszerzeniu natywnym. W argumencie -profile narzędzia ADL można jednak określić profil extendedTV , który obsługuje rozszerzenia natywne. Narzędzie ADL pozwala przeprowadzać testy za pomocą zawierającej wyłącznie procedurę pośredniczącą lub wersję wersji symulatora rozszerzenia języka ActionScript (dołączoną do pakietu ANE). Zazwyczaj odpowiednie rozszerzenie języka zainstalowane na urządzeniu zawiera również kod natywny. Aby przetestować rozszerzenie języka z kodem natywnym, należy uruchomić aplikację na urządzeniu docelowym.

Więcej informacji zawiera rozdział AIR Debug Launcher (ADL) .

Korzystanie z rozszerzeń natywnych

Jeśli aplikacja korzysta z rozszerzeń natywnych, polecenie ADL przypomina to w następującym przykładzie: 

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

Założenia dotyczące przykładu:

  • Ścieżka do narzędzia ADL znajduje się w definicji ścieżek powłoki wiersza poleceń. (Zobacz Zmienne środowiskowe ścieżek ).

  • Bieżący katalog zawiera pliki aplikacji. Obejmują one pliki SWF i plik deskryptora aplikacji, którym w tym przykładzie jest plik myApp-app.xml.

  • Parametr -extdir określa nazwę katalogu zawierającego katalog dla każdego rozszerzenia natywnego używanego przez aplikację. Każdy z tych katalogów zawiera rozpakowany plik ANE rozszerzenia natywnego. Na przykład: 

    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

    Te rozpakowane pliki ANE zawierają wersję rozszerzenia w postaci symulatora zawierającego wyłącznie kod ActionScript. Wersja rozszerzenia języka zawierająca kod natywny jest instalowana na urządzeniu telewizyjnym ze środowiskiem AIR.

Więcej informacji zawiera rozdział Programowanie rozszerzeń natywnych dla środowiska Adobe AIR .

Wprowadzanie poleceń sterujących

Narzędzie ADL symuluje przyciski pilota zdalnego sterowania urządzenia telewizyjnego. Naciśnięcia tych przycisków można wysyłać do symulowanego urządzenia, używając menu wyświetlanego po uruchomieniu narzędzia ADL za pomocą jednego z profilów telewizyjnych.

Rozmiar ekranu

Ustawiając parametr -screensize narzędzia ADL, można przetestować aplikację na ekranach o różnych rozmiarach. W tym celu należy określić ciąg zawierający cztery wartości wskazujące szerokości i wysokości normalnego i zmaksymalizowanego okna.

Zawsze należy określać wymiary w pikselach układu pionowego — z wartością szerokości mniejszą niż wartość wysokości. Na przykład: 

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

Instrukcje śledzenia

Gdy aplikacja telewizyjna zostanie uruchomiona na komputerze, informacje wyjściowe śledzenia będą zapisywane w debugerze lub w oknie terminalu użytym do uruchomienia narzędzia ADL.

Zdalne debugowanie za pomocą programu Flash Professional

Za pomocą oprogramowania Flash Professional można zdalnie debugować aplikację AIR dla urządzeń telewizyjnych, gdy działa ona na urządzeniu docelowym. Czynności wymagane do skonfigurowania debugowania zdalnego zależą od urządzenia. Na przykład w zestawie Adobe® AIR® for TV MAX 2010 Hardware Development Kit znajduje się dokumentacja zawierająca szczegółowe instrukcje dla tego urządzenia.

Niezależnie od urządzenia docelowego w celu przygotowania do debugowania zdalnego należy wykonać następujące czynności:

  1. W oknie dialogowym Ustawienia publikowania na karcie Flash zaznacz opcję Zezwalaj na debugowanie.

    Ta opcja powoduje, że oprogramowanie Flash Professional dołącza informacje o debugowaniu do wszystkich plików SWF tworzonych z pliku FLA.

  2. Na karcie Podpis okna dialogowego Ustawienia środowiska Adobe AIR (Ustawienia instalatora i aplikacji) wybierz opcję przygotowania pliku AIR Intermediate (AIRI).

    Podczas programowania aplikacji wystarczy korzystać z pliku AIRI, który nie wymaga podpisu cyfrowego.

  3. Opublikuj aplikację, tworząc plik AIRI.

Ostatnie czynności to zainstalowanie i uruchomienie aplikacji na urządzeniu docelowym. Te czynności zależą jednak od urządzenia.

Zdalne debugowanie za pomocą programu Flash Builder

Do zdalnego debugowania aplikacji AIR dla urządzeń telewizyjnych, gdy działa ona na urządzeniu docelowym, można również używać oprogramowania Flash Builder. Wymagane do tego czynności zależą od urządzenia.

Niezależnie od urządzenia docelowego w celu przygotowania do debugowania zdalnego należy wykonać następujące czynności:

  1. Wybierz opcję Projekt > Eksportuj kompilację do publikacji. Wybierz opcję przygotowania pliku AIR Intermediate (AIRI).

    Podczas programowania aplikacji wystarczy korzystać z pliku AIRI, który nie wymaga podpisu cyfrowego.

  2. Opublikuj aplikację, tworząc plik AIRI.

  3. Zmień pakiet AIRI aplikacji w taki sposób, aby zawierał on pliki SWF z informacjami o debugowaniu.

    Pliki SWF zawierające informacje o debugowaniu znajdują się w katalogu projektu aplikacji oprogramowania Flash Builder, w katalogu o nazwie bin-debug. Zastąp pliki SWF w pakiecie AIRI plikami SWF z katalogu bin-debug.

W przypadku programowania na komputerze z systemem Windows można to zrobić, wykonując następujące czynności:

  1. Zmień nazwę pliku pakietu AIRI w taki sposób, aby zamiast rozszerzenia nazwy pliku airi miała ona rozszerzenie zip.

  2. Wyodrębnij zawartość pliku ZIP.

  3. Zastąp pliki SWF w strukturze wyodrębnionych katalogów plikami z katalogu bin-debug.

  4. Ponownie spakuj pliki w wyodrębnionym katalogu.

  5. Ponownie zmień spakowany plik pakietu tak, aby miał on rozszerzenie nazwy pliku airi.

W przypadku programowania za pomocą komputera Mac czynności wymagane do zastąpienia plików zależą od urządzenia. Ogólnie wymagają one jednak wykonania następujących czynności:

  1. Zainstaluj pakiet AIRI na urządzeniu docelowym.

  2. Zastąp pliki SWF w katalogu instalacyjnym aplikacji na urządzeniu docelowym plikami SWF z katalogu bin-debug.

    Rozważmy na przykład urządzenie wchodzące w skład zestawu Adobe AIR for TV MAX 2010 Hardware Development Kit. Zainstaluj pakiety AIRI zgodnie z opisem w dokumentacji urządzenia. Następnie użyj polecenia telnet w wierszu poleceń na komputerze Mac używanym do programowania, aby uzyskać dostęp do urządzenia docelowego. Zastąp pliki SWF w katalogu instalacyjnym aplikacji /opt/adobe/stagecraft/apps/ <nazwa aplikacji> / plikami SWF z katalogu bin-debug.

Poniższe kroki dotyczą debugowania zdalnego za pomocą oprogramowania Flash Builder i urządzenia wchodzącego w skład zestawu Adobe AIR for TV MAX 2010 Hardware Development Kit.

  1. Na komputerze z oprogramowaniem Flash Builder, czyli na komputerze używanym do programowania, uruchom aplikację AIR for TV Device Connector wchodzącą w skład zestawu MAX 2010 Hardware Development Kit. Pokazuje ona adres IP komputera używanego do programowania.

  2. Na urządzeniu wchodzącym w skład zestawu uruchom aplikację DevMaster, która również wchodzi w skład zestawu.

  3. W aplikacji DevMaster wpisz adres IP komputera używanego do programowania uzyskany za pomocą programu AIR for TV Device Connector.

  4. W aplikacji DevMaster upewnij się, że jest zaznaczona opcja Enable Remote Debugging (Zezwalaj na debugowanie zdalne).

  5. Zamknij aplikację DevMaster.

  6. Na komputerze używanym do programowania wybierz w programie AIR for TV Connector opcję Start (Uruchom).

  7. Na urządzeniu wchodzącym w skład zestawu uruchom inną aplikację. Sprawdź, czy w programie AIR for TV Device Connector są wyświetlane informacje o śledzeniu.

    Jeśli nie są one wyświetlane, komputer używany do programowania i urządzenie wchodzące w skład zestawu nie są połączone. Upewnij się, że jest dostępny port na komputerze używanym do programowania stosowany do przekazywania informacji o śledzeniu. Można wybrać inny port w oprogramowaniu AIR for TV Device Connector. Sprawdź również, czy zapora sieciowa zezwala na dostęp do wybranego portu.

Następnie uruchom debuger w oprogramowaniu Flash Builder. W tym celu należy wykonać następujące czynności:

  1. W programie Flash Builder wybierz opcję Uruchom > Konfiguracje debugowania.

  2. Skopiuj nazwę projektu z istniejącej konfiguracji debugowania, która jest przeznaczona do debugowania lokalnego.

  3. W oknie dialogowym Konfiguracje debugowania zaznacz opcję Aplikacja internetowa. Następnie wybierz ikonę Nowa konfiguracja uruchamiania.

  4. Wklej nazwę projektu w polu Projekt.

  5. W sekcji Adres URL lub Ścieżka do uruchomienia usuń zaznaczenie opcji Użyj domyślnych. Wpisz również w polu tekstowym wartość about:blank .

  6. Naciśnij przycisk Zastosuj w celu zapisania zmian.

  7. Wybierz opcję Debuguj w celu uruchomienia debugera oprogramowania Flash Builder.

  8. Uruchom aplikację na urządzeniu wchodzącym w skład zestawu.

Teraz można używać oprogramowania Flash Builder na przykład do ustawiania punktów kontrolnych i badania zmiennych.