Эта статья содержит инструкции для разработчиков по созданию плагинов, обеспечивающих поддержку специализированных платформ в Animate 2015. Если вы используете выпуск Animate CC 2014.1 (обновление от октября 2014 г.) или CC 2014.2 (обновление от февраля 2015 г.), см. предыдущие версии документа.
Для реализации плагина поддержки специализированной платформы следует загрузить комплект разработки «Поддержка специализированных платформ» (Custom Platform Support Development Kit) по следующей ссылке.
Загрузить
Загрузите образец плагина по следующей ссылке, чтобы опираться на него при создании собственного плагина поддержки специализированной платформы.
Загрузить
Плагин состоит из следующих элементов.
- DocType добавляет в Animate новый тип документа, соответствующий специализированной платформе, и управляет художественными возможностями.
- Publisher служит для настройки параметров публикации и для публикации документа в специализированном формате.
Общие сведения о функции поддержки специализированных платформ приведены в разделе Поддержка специализированных платформ.
Новые возможности Animate CC 2015:
- Возможность запрашивать типа символа библиотеки: при работе с символами ILibraryItem::GetProperties() будет иметь дополнительную запись с ключом kLibProp_SymbolType_DictKey. Ключ может иметь значение kLibProp_SymbolType_Button, kLibProp_SymbolType_MovieClip или kLibProp_SymbolType_Graphic.
- Возможность различать кнопку и фрагмент ролика: до предыдущего выпуска экземпляры кнопок обрабатывались как фрагменты роликов моделью DOM и службой IFrameCommandGenerator. Начиная с Animate CC 2015 добавлен интерфейс для поддержки экземпляров Button. Если экземпляр IMovieClip также реализует интерфейс IButton, то он может обрабатываться как экземпляр Button. Четыре состояния кнопки, а именно «Вверх», «Наведение», «Вниз» и «Нажатие», всегда сопоставляются с кадрами 0, 1, 2 и 3 соответственно. См. файл IButton.h для получения дополнительных сведений об экземпляре Button.
- Новый API-интерфейс для получения границ объектов IClassicText: функция AddClassicText в интерфейсе ITimelineBuilder теперь возвращает объект CLASSIC_TEXT_INFO_2 (вместо CLASSIC_TEXT_INFO), который содержит новое поле «bounds», представляющее границы объекта IClassicText.
- В плагин-образец внесены изменения с целью повторного использования растровых изображений, используемых для заливки фигур.
- Веб-сервер Mongoose интегрирован в плагин-образец.
Примечание. Инструмент «IK Кость», доступный в Animate CC 2015, отключен в типах документов для специализированных платформ. Animate преобразует содержимое обратной кинематики в покадровую анимацию, когда оно вставляется в документ для специализированной платформы.
Обновление от февраля 2015 года: поддержка масок в службе IFrameCommandGenerator — новый выпуск имеет поддержку масок в службе IFrameCommandGenerator. Новый интерфейс ITimelineBuilder2, унаследованный от прежнего интерфейса ITimelineBuilder, содержит функции, которые после реализации в плагине обеспечивают такую поддержку. См. документацию по API-интерфейсам поддержки специализированных платформ для получения дополнительных сведений о новом интерфейсе ITimelineBuilder2.
Построение плагина поддержки специализированной платформы для Animate
Для разработки плагина поддержки специализированной платформы можно применить один из следующих способов.
- Создать плагин с помощью API-интерфейсов из комплекта разработки «Поддержка специализированных платформ».
- Изменить параметры образца плагина, входящего в комплект разработки, согласно собственным требованиям.
Подключаемые модули поддержки специализированных платформ упаковываются в формат ZXP, после чего их можно подключить к программе Animate. Можно разместить плагин на сайте Надстроек Adobe Add-on, откуда пользователи смогут загрузить его и установить программой Creative Cloud, либо распространить плагин в виде пакета ZXP, который устанавливается с помощью Adobe Extension Manager.
Программные требования
Для построения плагина с помощью комплекта разработки «Поддержка специализированных платформ» требуется следующее ПО:
Справочная документация по API-интерфейсам для разработчиков плагинов
Комплект разработки «Поддержка специализированных платформ» содержит следующие элементы.
- FCM (Flash Component Model, модель компонентов Flash): заголовочные файлы, входящие в комплект разработки, определяют платформу под названием FCM, которая предназначена для управления плагином.
- DocType: содержит набор интерфейсов для добавления нового типа документа на начальную страницу Animate, а также для включения и отключения определенных функций для этого типа документа.
- DOM (Document Object Model, модель объектов документа): содержит набор интерфейсов для доступа к содержимому документа Animate в форме модели DOM.
- Publisher: набор интерфейсов для связи с процессами публикации.
Полная информация об API-интерфейсах поддержки специализированных платформ с примерами их использования при разработке плагинов приведена в разделе Справочник по API-интерфейсам поддержки специализированных платформ.
Создание плагина поддержки специализированной платформы
Плагин поддержки специализированной платформы можно создать следующим образом.
- Загрузите комплект разработки «Поддержка специализированных платформ».
- Извлеките содержимое комплекта в папку на компьютере.
- Откройте новый проект разработки ПО VisualStudio или Xcode и включите в него заголовочные файлы из комплекта разработки. Чтобы не начинать разработку своего плагина поддержки специализированной платформы с нуля, можно использовать следующий образец плагина из папки SampleCreateJSPlatform, добавив его код в свой проект.
- Внесите необходимые изменения для своей платформы.
- Скомпилируйте код для формирования плагина (файла .dll или .plug-in).
К примеру, файлы образца плагина SampleCreateJS находятся здесь: SampleCreateJSPlatform\Plugin\SampleCreateJS\project\.
Упаковка плагина поддержки специализированной платформы
Пакет для распространения нового плагина поддержки специализированной платформы можно сформировать следующим образом.
- Откройте образец плагина в среде Eclipse или создайте новый проект расширения приложений (Application Extension) в мастере создания проектов Eclipse. Присвойте проекту имя, затем нажмите кнопку Next (Далее).
- На панели New Adobe Application Extension Project (Новый проект расширения приложений Adobe) выберите в качестве целевого приложения Adobe Animate и нажмите кнопку Next (Далее).
- Измените расширения созданных файлов подключаемых модулей с .dll на .fcm для Windows или с .plug-in на .fcm.plug-in для Mac и добавьте файлы подключаемых модулей в проект (ExtensionContent/plugins/lib/win для Windows и ExtensionContent/plugins/lib/mac для Mac).
- Настройте расширение, внеся изменения в файл manifest.xml. Чтобы открыть файл манифеста, щелкните правой кнопкой мыши расширение в обозревателе проектов и выберите Adobe Extension Builder 3 > Bundle Manifest Editor (Редактор манифестов пакета), а затем перейдите на вкладку манифеста в «Редакторе манифестов пакета», расположенном в папке EclipseProject\.staged-extension\CSXS.
- Чтобы отредактировать файл manifest.xml, щелкните правой кнопкой мыши в окне и выберите Open with (Открыть с помощью) > XML editor (Редактор XML). Необходимо обратить внимание на два следующих тега: ExtensionList и DispatchInfoList:
Обычный тег ExtensionList выглядит следующим образом:
<ExtensionList>
<Extension Id="PluginID" Version="1.0" />
<Extension Id="PublishSettingsID" Version-"1.0" />
</ExtensionList>
Этот тег содержит список расширений окончательного пакета ZXP, в котором каждому расширению в качестве идентификатора присвоена уникальная строка. В этом случае файл .dll или .plugin, созданный в предыдущем разделе, будет добавлен в расширение. Затем для настройки пользовательского интерфейса параметров публикации средства публикации (Publisher) необходимо использовать другое расширение. В приведенном примере тега ExtensionList расширение с идентификатором PluginID содержит файл .dll/.plugin, а расширение с идентификатором PublishSettingsID используется для настройки пользовательского интерфейса параметров публикации средства публикации (Publisher).
- Тег DispatchInfoList содержит сведения о каждом расширении, указанном в ExtensionList. Ниже приведен пример тега DispatchInfoList:
<DispatchInfoList>
<Extension Id="PluginID">
<DispatchInfo >
<Resources>
<MainPath>./plugin/fcm.xml</MainPath>
</Resources>
<Lifecycle>
<AutoVisible>true</AutoVisible>
</Lifecycle>
<UI>
<Type>ModalDialog</Type>
<Menu>CreateJS</Menu>
<Geometry>
<Size>
<Height>200</Height>
<Width>200</Width>
</Size>
</Geometry>
</UI>
</DispatchInfo>
</Extension>
<Extension Id="PublishSettingsID">
<DispatchInfo >
<Resources>
<MainPath>./index.html</MainPath>
</Resources>
<Lifecycle>
<AutoVisible>true</AutoVisible>
</Lifecycle>
<UI>
<Type>ModalDialog</Type>
<Menu>Publish Settings</Menu>
<Geometry>
<Size>
<Height>170</Height>
<Width>486</Width>
</Size>
</Geometry>
</UI>
</DispatchInfo>
</Extension>
</DispatchInfoList>
- При работе с файлами с расширением .dll или .plugin можно пропускать все теги, кроме тега MainPath. Тег MainPath содержит путь к файлу fcm.xml, связанному с папкой ExtensionContent. Расширение файла .dll необходимо изменить на .fcm и разместить его в папке win вместе с файлом fcm.xml. Подобным образом при работе в среде Mac переименуйте измените расширение файла .plugin на .fcm.plugin и поместите его в папку mac вместе с файлом fcm.xml.
- Расширение HTML, использующееся для настройки пользовательского интерфейса параметров публикации, является расширением HTML в Animate. Дополнительные сведения о расширениях HTML в Animate см. в разделе Создание расширений HTML.
- Нижним значением атрибута версии в теге Host должно быть 14.1, то есть минимальная (внутренняя) версия Animate с поддержкой специализированных платформ.
<ExecutionEnvironment> <HostList> <Host Name="FLPR" Version="14.1" /> </HostList>. . . </ExecutionEnvironment>
- Переключитесь в вид Script Explorer (Обозреватель сценариев), затем щелкните правой кнопкой мыши проект и выберите Export (Экспорт) > Adobe Extension Builder 3 > Application Extension (Расширение приложения). Откроется мастер экспорта.
- Необходимо иметь сертификат для подписи пакета расширения. Выберите существующий сертификат или нажмите Create (Создать), чтобы создать новый.
- Для компиляции проекта нажмите Finish (Готово). Eclipse формирует файл плагина с расширением .zxp, который можно разместить на сайте надстроек Adobe Add-on.
Распространение плагина поддержки специализированной платформы
Вы можете распространить свой плагин поддержки специализированной платформы, разместив его на странице надстроек Adobe Add-on, и при этом получить прибыль. Прежде чем плагин отобразится на сайте, пакет плагина должен пройти процесс рассмотрения и утверждения Adobe. Разместить плагин можно следующим образом.
- Выполните вход на сайте Надстроек Adobe Add-on, указав свой идентификатор пользователя Adobe ID и пароль.
- На левой панели в разделе «Стать производителем» нажмите ссылку Перейти на портал производителей.
- Нажмите кнопку Sign-up (Регистрация), если вы еще не зарегистрированы в качестве производителя продуктов.
- Подробные инструкции по регистрации в качестве производителя и размещению ваших плагинов см. в статье Начало работы с порталом производителей.
- Выполните следующие действия на портале производителей, как описано на странице Начало работы.
- Упакуйте продукт в один файл.
- Введите информацию о продукте и отправьте файл на сервер.
- Добавьте маркетинговые материалы.
- Просмотрите страницу своего продукта.
- Подайте продукт на утверждение.
- После утверждения плагин будет отображаться в категории продуктов Animate на странице надстроек.
- Если вы являетесь пользователем и хотите установить плагин, создать документ специализированной платформы или опубликовать его с помощью Animate, см. раздел Работа с плагинами для поддержки специализированных платформ.
- Подробная информация о работе с расширениями Adobe приведена в разделе Загрузка и установка расширений.
Запрос на добавление функций и отправка сообщения с указанием на ошибку
Если вы хотите задать вопрос, сообщить об ошибке или отправить запрос на добавление функции в программу команде разработчиков Animate, заполните следующую форму: