Отладка приложений AIR for TV

Моделирование устройства с помощью ADL

Самым простым и быстрым способом тестирования и отладки функций приложений является запуск приложения на рабочем компьютере с использованием утилиты Adobe Debug Launcher (ADL).

ADL определяет используемый профиль на основании элемента supportedProfiles , который указан в дескрипторе приложения. В частности:

  • Если указано несколько профилей, ADL использует первый профиль из списка.

  • Используя параметр ADL -profile , можно выбрать другой профиль из списка supportedProfiles .

  • Если элемент supportedProfiles не включен в дескриптор приложения, для аргумента -profile может быть указан любой профиль.

Например, следующая команда позволяет запустить приложение для моделирования профиля tv : 
adl -profile tv myApp-app.xml

При моделировании профиля tv или extendedTV на настольном компьютере с помощью ADL приложение запускается в среде, которая наиболее точно соответствует среде целевого устройства. Например:

  • API-интерфейсы ActionScript, которые не являются часть профиля в аргументе -profile , будут недоступны.

  • ADL разрешает ввод из элементов управления вводом устройства, таких как пульты управления, через меню команд.

  • Укажите значение tv или extendedTV для аргумента -profile , чтобы смоделировать с помощью ADL класс StageVideo на настольном компьютере.

  • Укажите значение extendedTV для аргумента -profile , чтобы разрешить приложению использовать фрагмент или модель собственного расширения, включенные в файл AIRN приложения.

Однако в связи с тем, что приложение ADL запускается на настольном компьютере, при тестировании приложений AIR for TV имеются некоторые ограничения.

  • Производительность приложения на устройстве не отражается. Тесты производительности следует выполнять на целевом устройстве.

  • Моделирование ограничений объекта StageVideo не выполняется. Обычно для воспроизведения видео в приложениях AIR for TV вместо класса Video используется класс StageVideo. Класс StageVideo использует преимущества производительности оборудования устройства, но имеет ограничения при воспроизведении. На настольном компьютере ADL воспроизводит видео без этих ограничений. Поэтому тесты воспроизведения видео следует выполнять на целевом устройстве.

  • Исходный код собственного расширения не моделируется. Однако можно указать профиль extendedTV , поддерживающий собственные расширения, с помощью аргумента ADL -profile . ADL разрешает тестировать версию с фрагментом или моделью только расширения ActionScript, включенную в пакет ANE. Однако обычно соответствующее расширение, установленное на устройстве, также включает исходный код. Чтобы выполнить тестирование расширения с исходным кодом, запустите приложение на целевом устройстве.

Дополнительные сведения см. в разделе « AIR Debug Launcher (ADL) ».

Использование собственных расширений

Если в приложении используются собственные расширения, команда ADL имеет следующий вид: 

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

Например, предположим следующее:

  • Путь к инструменту ADL указан в определении пути оболочки командной строки. (См. раздел « Переменные среды Path ».)

  • Файлы приложения находятся в текущем каталоге. В число этих файлов входят SWF-файлы и файл дескриптора приложения, который в данном примере имеет имя myApp-app.xml.

  • Параметр -extdir задает имя каталога, содержащего каталог для всех собственных расширений, используемых в приложении. В каждом из этих каталогов содержится распакованный ANE-файл собственного расширения Например: 

    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

    Эти распакованные ANE-файлы содержат только версию с фрагментом или моделью для расширения ActionScript. На устройстве AIR for TV установлена версия расширения, содержащая исходный код.

Дополнительные сведения см. в разделе Разработка собственных расширений для Adobe AIR .

Управление вводом

ADL моделирует нажатие кнопок на пульте управления ТВ-устройства. Отправлять события нажатия этих кнопок в смоделированную среду устройства можно с помощью меню, которое отображается при запуске ADL с профилем ТВ-устройства.

Размер экрана

Выполните тестирование приложения на экранах разных размеров, изменяя значение параметра ADL -screensize . Можно указать строку, содержащую четыре значения, которые представляют ширину и высоту стандартного и развернутого окна.

Всегда указывайте для портретной ориентации размеры в пикселях, задавая для ширины меньшее значение, чем для высоты. Например: 

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

Трассировочные инструкции

При запуске приложения для ТВ-устройства на настольном компьютере данные трассировки выводятся в окне отладчика или терминала, из которого был запущен инструмент ADL.

Удаленная отладка с помощью Flash Professional

Flash Professional можно использовать для выполнения удаленной отладки приложения AIR for TV, запущенного на целевом устройстве. Процедура настройки удаленной отладки зависит от конкретного устройства. Например, MAX 2010, комплект инструментов разработчика Adobe® AIR® для ТВ-устройств, содержит документацию с подробным описанием процедуры для данного устройства.

Следующие операции по подготовке к удаленной отладке требуется выполнять на любом целевом устройстве.

  1. В диалоговом окне «Параметры публикации» на вкладке «Flash» выберите «Разрешить отладку».

    При установке данного параметра Flash Professional включает отладочную информацию во все SWF-файлы, создаваемые на основе файла FLA.

  2. На вкладке «Подпись» в диалоговом окне «Параметры AIR» («Настройки приложения и установщика») установите параметры для подготовки файла AIR Intermediate (AIRI).

    Когда разработка приложения еще не завершена, достаточно использовать AIRI-файл, не требующий цифровой подписи.

  3. Опубликуйте приложение, создав файл AIRI.

Последним шагом является установка и запуск приложения на целевом устройстве. Однако эти шаги зависят от конкретного устройства.

Удаленная отладка с помощью Flash Builder

Flash Builder можно использовать для выполнения удаленной отладки приложения AIR for TV, запущенного на целевом устройстве. Процедура удаленной отладки зависит от конкретного устройства.

Следующие операции по подготовке к удаленной отладке требуется выполнять на любом целевом устройстве.

  1. Выберите «Проект» > «Экспорт сборки выпуска». Установите параметры для подготовки файла AIR Intermediate (AIRI).

    Когда разработка приложения еще не завершена, достаточно использовать AIRI-файл, не требующий цифровой подписи.

  2. Опубликуйте приложение, создав файл AIRI.

  3. Измените пакет приложения AIRI, чтобы входящие в него SWF-файлы содержали отладочную информацию.

    SWF-файлы, содержащие отладочную информацию, расположены в каталоге проектов приложения Flash Builder с именем bin-debug. Замените файлы SWF в пакете AIRI SWF-файлами из каталога bin-debug.

На рабочем компьютере с Windows эту замену можно выполнить следующим образом.

  1. Переименуйте файл пакета AIRI, установив для него расширение .zip вместо .airi.

  2. Извлеките содержимое ZIP-файла.

  3. Замените SWF-файлы в извлеченной структуре каталогов файлами из каталога bin-debug.

  4. Повторно упакуйте файлы в извлеченном каталоге.

  5. Измените имя ZIP-файла, вернув для него расширение .airi.

На рабочем компьютере Mac процедура замены зависит от конкретного устройства. Однако в общем случае требуется выполнить следующие действия.

  1. Установите пакет AIRI на целевое устройство.

  2. Замените SWF-файлы в установочном каталоге приложения на целевом устройстве SWF-файлами из каталога bin-debug.

    Например, рассмотрите устройство, включенное в MAX 2010, комплект инструментов разработчика Adobe AIR for TV. Установите пакет AIRI, как описано в документации. Затем с помощью с помощью утилиты telnet в режиме командной строки подключитесь с рабочего компьютера Mac к целевому устройству. Замените SWF-файлы в каталоге установки приложения /opt/adobe/stagecraft/apps/ <имя приложения> / на SWF-файлы из каталога bin-debug.

Ниже представлена процедура удаленной отладки с помощью Flash Builder на устройстве, включенном в MAX 2010, комплект инструментов разработчика Adobe AIR for TV.

  1. На рабочем компьютере с Flash Builder запустите AIR for TV Device Connector, включенный в комплект инструментов разработчика MAX 2010. Инструмент отобразит IP-адрес рабочего компьютера.

  2. На устройстве из комплекта разработчика запустите приложение DevMaster, также включенное в комплект.

  3. В приложении DevMaster введите IP-адрес рабочего компьютера, полученный с помощью AIR for TV Device Connector.

  4. В приложении DevMaster убедитесь, что включен режим удаленной отладки.

  5. Закройте приложение DevMaster.

  6. На рабочем компьютере выберите «Запустить в AIR for TV Connector»

  7. Запустите другое приложение на устройстве из комплекта. Убедитесь, что информация о трассировке отображается в AIR for TV Connector.

    Если операция о трассировке не отображается, рабочий компьютер не подключен к устройству. Убедитесь, что порт рабочего компьютера, используемый для передачи информации о трассировки, доступен. В AIR for TV Device Connector можно выбрать другой порт. Также убедитесь, что в брандмауэре разрешен доступ к выбранному порту.

Затем запустите отладчик в среде Flash Builder. Выполните следующие действия.

  1. В среде Flash Builder выберите «Выполнить» > «Конфигурации отладки».

  2. Скопируйте имя проекта из существующей конфигурации отладки, предназначенной для локальной отладки.

  3. В диалоговом окне «Конфигурации отладки» выберите «Веб-приложение». Затем нажмите на значок «Новая конфигурация запуска».

  4. Вставьте имя проекта в поле «Проект».

  5. В разделе «URL или путь для запуска» снимите флажок возле поля «Использовать по умолчанию». В текстовом поле введите about:blank .

  6. Нажмите «Применить», чтобы сохранить изменения.

  7. Выберите «Отладка», чтобы запустить отладчик Flash Builder.

  8. Запустите приложение на устройстве из комплекта.

Теперь с помощью отладчика Flash Builder можно, например, задавать точки прерывания и анализировать переменные.