Felsöka AIR for TV-program

Enhetssimulering med ADL

Det snabbaste och enklaste sättet att testa och felsöka de flesta programfunktioner är att köra programmet på utvecklingsdatorn med ADL-verktyget (Adobe Debug Launcher).

ADL använder elementet supportedProfiles i programbeskrivningen för att fastställa vilken profil som ska användas. Närmare bestämt:

  • Om det finns fler än en profil används den första i listan.

  • Du kan använda parametern -profile i ADL för att välja en av de andra profilerna i listan supportedProfiles .

  • Om du inte inkluderar ett supportedProfiles -element i programbeskrivningen kan vilken profil som helst anges för argumentet -profile .

Använd till exempel följande kommando för att starta ett program för att simulera tv -profilen: 
adl -profile tv myApp-app.xml

När du simulerar tv - eller extendedTV -profilen på skrivbordet med ADL körs programmet i en miljö som bättre motsvarar en målenhet. Till exempel:

  • ActionScript-API:er som inte ingår i profilen i -profile -argumentet är inte tillgängliga.

  • ADL tillåter indata från enhetskontroller, som fjärrkontroller, via menykommandon.

  • Om du anger tv eller extendedTV i argumentet -profile kan ADL simulera klassen StageVideo på skrivbordet.

  • Om du anger extendedTV i argumentet -profile kan programmet använda stubbar eller simulatorer för ANE-tillägg, som paketerats med programmets AIRN-fil.

Men eftersom ADL kör programmet på skrivbordet har det sina begränsningar att testa AIR for TV-program med ADL:

  • Det speglar inte programmets prestanda på enheten. Kör prestandatester på målenheten.

  • Det simulerar inte begränsningarna för StageVideo-objektet. Vanligtvis använder du klassen StageVideo, inte klassen Video, för att spela upp en video med AIR for TV-enheter som mål. Klassen StageVideo utnyttjar prestandafördelarna med enhetens maskinvara, men har vissa begränsningar när det gäller visning. ADL spelar upp videon på skrivbordet utan de här begränsningarna. Testa därför att spela upp videon på målenheten.

  • Det simulerar inte den systemspecifika koden för ett ANE-tillägg. Du kan däremot ange profilen extendedTV , som har stöd för ANE-tillägg, i ADL-argumentet -profile . Med ADL kan du testa med den ActionScript-version, som är en stub eller simulator av tillägget, som ingår i ANE-paketet. Vanligtvis inkluderar motsvarande tillägg, som är installerat på enheten, även systemspecifik kod. Om du vill testa med tillägget och dess systemspecifika kod, ska du köra programmet på målenheten.

Du hittar mer information i AIR Debug Launcher (ADL) .

Använda ANE-tillägg

Om ditt program använder ANE-tillägg ser ADL-kommandot ut som i följande exempel: 

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

Exemplet förutsätter följande:

  • Att sökvägen till ADL-verktyget finns i kommandoradens sökvägsdefinition. (Läs mer i Systemvariabeln path .)

  • Att den aktuella katalogen innehåller programfilerna. Bland de här filerna finns SWF-filerna och programbeskrivningsfilen, som i det här exemplet heter myApp-app.xml.

  • Parametern -extdir namnger en katalog som innehåller en katalog för varje ANE-tillägg som används i programmet. Var och en av katalogerna innehåller den opaketerade ANE-filen för ett tillägg. Till exempel: 

    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

    Dessa opackade ANE-filer innehåller en ActionScript-version som är en stub eller simulator av tillägget. Den version av tillägget som innehåller den systemspecifika koden installeras på AIR for TV-enheten.

Du hittar mer information i Developing Native Extensions for Adobe AIR .

Indata från kontroller

ADL simulerar knapparna på fjärrkontrollen till en tv-enhet. Du kan skicka dessa knappindata till den simulerade enheten med den meny som visas när ADL startas med en av tv-profilerna.

Skärmstorlek

Du kan testa programmet med olika skärmstorlekar genom att ange ADL-parametern -screensize . Du kan ange en sträng med fyra värden, som representerar bredden och höjden på den normala och den maximerade skärmen.

Ange alltid pixeldimensioner för stående layout, d.v.s. ange bredden som ett värde som är mindre än höjden. Till exempel: 

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

Trace-programsatser

När du kör tv-programmet på skrivbordet skrivs utdata från trace-programsatser antingen till felsökaren eller till det terminalfönster som användes för att starta ADL.

Fjärrfelsökning med Flash Professional

Du kan använda Flash Professional för att fjärrfelsöka AIR for TV-programmet när det körs på målenheten. Vilka steg som behöver konfigureras för fjärrfelsökningen beror däremot på enheten. Till exempel innehåller Adobe® AIR® for TV MAX 2010 Hardware Development Kit dokumentation med detaljerad information för den enheten.

Utför följande steg för att förbereda för fjärrfelsökning, oavsett målenhet:

  1. Markera Tillåt felsökning på fliken Flash i dialogrutan Publiceringsinställningar.

    Med det här alternativet inkluderar Flash Professional  felsökningsinformation i alla SWF-filer som skapas från FLA-filen.

  2. På fliken Signatur i dialogrutan Inställningar i Adobe AIR  (AIR – Program- och installationsinställningar) väljer du alternativet att förbereda en AIRI-fil (AIR Intermediate).

    Medan du fortfarande utvecklar programmet är det tillräcklig om du använder en AIRI-fil, eftersom ingen digital signatur krävs för den.

  3. Publicera programmet, så skapas AIRI-filen.

De sista stegen är att installera och köra programmet på målenheten. De här stegen skiljer sig dock åt på olika enheter.

Fjärrfelsökning med Flash Builder

Du kan också använda Flash Builder för att fjärrfelsöka AIR for TV-programmet när det körs på målenheten. Vilka steg som behövs för fjärrfelsökningen beror däremot på enheten.

Utför följande steg för att förbereda för fjärrfelsökning, oavsett målenhet:

  1. Välj Project (Projekt) > Export Release Build (Exportera färdig version). Välj alternativet att förbereda en AIRI-fil (AIR Intermediate).

    Medan du fortfarande utvecklar programmet är det tillräcklig om du använder en AIRI-fil, eftersom ingen digital signatur krävs för den.

  2. Publicera programmet, så skapas AIRI-filen.

  3. Ändra programmets AIRI-paket så att det innehåller SWF-filerna med felsökningsinformation.

    De SWF-filer som innehåller felsökningsinformation finns i Flash Builder-projektkatalogen för programmet, i en katalog med namnet bin-debug. Ersätt SWF-filerna i AIRI-paketet med SWF-filerna i katalogen bin-debug.

På en utvecklingsdator med Windows kan du utföra det här bytet på följande sätt:

  1. Byt namn på AIRI-paketfilen så att den får filtillägget .zip i stället för .airi.

  2. Extrahera innehållet i ZIP-filen.

  3. Ersätt SWF-filerna i den extraherade katalogstrukturen med dem som finns i bin-debug.

  4. Komprimera filerna i den extraherade katalogen.

  5. Ändra tillbaka ZIP-filens namn till filtillägget .airi.

Om du använder en utvecklingsdator med Mac OS utförs det här bytet på olika sätt beroende på enheten. Vanligtvis inkluderar de följande:

  1. Installera AIRI-paketet på målenheten.

  2. Ersätt SWF-filerna i programmets installationskatalog på målenheten med SWF-filerna från katalogen bin-debug.

    Som exempel kan nämnas den enhet som ingår i Adobe AIR for TV MAX 2010 Hardware Development Kit. Installera AIRI-paketet enligt beskrivningen i den dokumentationen. Använd sedan telnet på kommandoraden på Mac-utvecklingsdatorn för att komma åt målenheten. Ersätt SWF-filerna i programmets installationskatalog på /opt/adobe/stagecraft/apps/ <programnamn> / med SWF-filerna från katalogen bin-debug.

Följande steg gäller fjärrfelsökning med Flash Builder och den enhet som ingår i Adobe AIR for TV MAX 2010 Hardware Development Kit.

  1. På den dator där Flash Builder körs (utvecklingsdatorn) kör du den AIR for TV Device Connector som ingår i MAX 2010 Hardware Development Kit. Den visar IP-adressen för utvecklingsdatorn.

  2. På enheten med MAX 2010 Hardware Development Kit startar du programmet DevMaster, som också ingår i det paketet.

  3. I programmet DevMaster anger du IP-adressen för utvecklingsdatorn så som den visas i AIR for TV Device Connector.

  4. Kontrollera att Enable Remote Debugging är markerat i DevMaster.

  5. Avsluta programmet DevMaster.

  6. På utvecklingsdatorn väljer du Start i AIR for TV Connector.

  7. Starta ett annat program på enheten med MAX 2010 Hardware Development Kit. Kontrollera att spårningsinformation visas i AIR for TV Device Connector.

    Om spårningsinformationen inte visas är utvecklingsdatorn och enheten med MAX 2010 Hardware Development Kit inte anslutna till varandra. Kontrollera att den port på utvecklingsdatorn som används för spårningsinformation är tillgänglig. Du kan välja en annan port i AIR for TV Device Connector. Kontrollera även att brandväggen tillåter åtkomst till den valda porten.

Starta sedan felsökaren i Flash Builder. Gör så här:

  1. Gå till Flash Builder och välj Run > Debug Configurations.

  2. Kopiera projektets namn från den befintliga felsökningskonfigurationen, som är avsedd för lokal felsökning.

  3. Välj Web Application i dialogrutan Debug Configurations. Välj sedan ikonen New Launch Configuration.

  4. Klistra in projektnamnet i fältet Project.

  5. Avmarkera kryssrutan Use Default i delen URL Or Path To Launch. Skriv även about:blank i textfältet.

  6. Klicka på Apply för att spara ändringarna.

  7. Välj Debug för att starta Flash Builder-felsökaren.

  8. Starta programmet på enheten med MAX 2010 Hardware Development Kit.

Nu kan du använda felsökaren i Flash Builder för att till exempel ange brytpunkter och kontrollera variabler.