Создание HTML-расширений

Возможности Animate можно дополнять с помощью HTML-расширений. Adobe Extension Builder 3 позволяет создавать расширения HTML для Animate. Раньше для Animate можно было использовать только расширения SWF. А теперь Adobe Extension Builder 3 позволяет создавать расширения HTML для приложений Creative Cloud. Сначала необходимо загрузить и установить Eclipse и Extension Builder 3.0.

Для создания расширения HTML выполните следующие действия.

1. Запустите Eclipse. 
2. В мастере создания проекта откройте новый проект расширения приложения. Присвойте проекту описательное имя, затем нажмите кнопку Next (Далее).
3. На панели New Adobe Application Extension Project (Новый проект расширения приложения Adobe) выберите Adobe Animate. Нажмите кнопку «Далее».
4. Настройте расширение, используя доступные параметры.
   
   1. Bundle ID (ИД набора): уникальный идентификатор расширения.
   2. Menu name (Имя меню): отображаемое имя расширения. Имя меню отображается в меню Окно > Расширения в Animate.
      
   3. Window Details (Сведения об окне): эти параметры служат для настройки типа и размера окна расширения.
      
      Нажмите кнопку Далее.
5. На следующих нескольких экранах можно дополнительно настроить справочные библиотеки для расширения:
   1. CEP Interface Library (Библиотека интерфейса CEP): обеспечивает функции для взаимодействия с главным приложением. Этот параметр установлен по умолчанию.
   2. Frameworks (Платформы): предназначены для общих библиотек Javascript, таких как jQuery.
      
   3. Services (Службы): включают набор инструментов Adobe IPC Communication Toolkit, который обеспечивает обмен данными между приложениями Adobe, расширениями и внешними приложениями. Этот набор включает протокол для обмена сообщениями через диспетчер служб CEP Service Manager, который выполняет функцию концентратора для обмена данными Creative Cloud.
      
      Нажмите кнопку «Готово», чтобы создать новый проект Eclipse.

Отладка расширения в Animate

Можно запустить расширение непосредственно из Eclipse.

1. Правой кнопкой щелкните проект и выберите Run As (Запустить как) > Adobe Flash Extension (Расширение Adobe Flash). Запустится Animate.
2. В Animate выберите пункт меню Окно > Расширения. При этом открывается панель расширения.

Экспорт расширения

Для распространения расширения необходимо экспортировать его в виде пакета ZXP. Затем пакет ZXP загружается и выполняется диспетчером Adobe Extension Manager в приложениях Creative Cloud:

1. В Eclipse переключитесь в вид Script Explorer (Обозреватель сценариев), затем щелкните правой кнопкой мыши проект и выберите Export (Экспорт) > Adobe Extension Builder 3 > Application Extension (Расширение приложения). Запустится мастер экспорта.
2. Необходимо иметь сертификат для подписи пакета расширения. Выберите существующий сертификат или нажмите Create (Создать), чтобы создать новый.
3. Нажмите кнопку Finish (Готово).
4. По окончании экспорта пакет ZXP расширения, готовый для распространения, появится в папке проекта.

Примечание. Для установки расширения необходимо открыть файл <расширение>\.staged-extension\CSXS\manifest.xml и обновить в теге host минимальную версию Animate до 13.0.

Установка расширения в Animate

HTML-расширения можно устанавливать в Animate с помощью Adobe Extension Manager. Расширения HTML помогают дополнять функциональные возможности Animate.

Добавление интерактивных возможностей к HTML-расширениям

Для создания интерактивных HTML-расширений, взаимодействующих с Animate можно добавлять элементы управления, определять поведение и собирать информацию о среде выполнения (сведения о Animate и операционной системе). Существует два способа решения этой задачи:

1. Использование интерфейсной библиотеки CEP. Интерфейсная библиотека CEP представляет собой набор программных средств (API) для получения сведений о среде выполнения и сценарий Eval для запуска сценариев JSFL. Дополнительные сведения об интерфейсной библиотеке CEP см. в разделе Справка > Содержание справки > Adobe Extension Builder > Документация в Eclipse.
2. Использование JSFL. Сценарии JSFL можно запускать с помощью программного интерфейса сценариев Eval библиотеки CEP.
   
   Помимо сценариев JSFL, инфраструктура CEP в Animate также открывает доступ к следующим событиям, которые можно использовать только в пределах панелей HTML.
   • com.adobe.events.flash.documentChanged генерируется, если текущий активный документ был изменен.
   • com.adobe.events.flash.timelineChanged генерируется при внесении изменений в шкалу времени текущего активного документа.
   • com.adobe.events.flash.documentSaved генерируется при сохранении текущего документа.
   • com.adobe.events.flash.documentOpened генерируется при открытии нового документа.
   • com.adobe.events.flash.documentClosed генерируется при закрытии текущего активного документа.
   • com.adobe.events.flash.documentOpened генерируется при открытии нового документа.
   • com.adobe.events.flash.layerChanged генерируется при выборе другого слоя.
   • com.adobe.events.flash.layerChanged генерируется при выборе другого кадра.
   • com.adobe.events.flash.selectionChanged генерируется при выборе другого объекта рабочей области.
   • com.adobe.events.flash.mouseMove генерируется при перемещении курсора мыши над рабочей областью.

Пример

В приведенном фрагменте кода:

• csinterface: объект интерфейсной библиотеки CEP.
• com.adobe.events.flash.selectionChanged: событие, генерируемое при изменении выделения объекта. Также можно использовать любые из вышеупомянутых событий.
• CallbackFunction: метод, обрабатывающий сгенерированное событие.