Руководство пользователя Отмена

Обеспечение поддержки специализированной платформы

 

В этой статье приведены сведения о разработке подключаемых модулей Animate для поддержки специализированных платформ с помощью Animate.

Для реализации плагина поддержки специализированной платформы требуется комплект разработки поддержки специализированных платформ. Щелкните здесь, чтобы скачать его.

  1. Выберите пакет SDK для специализированной платформы Animate на вкладке Загрузки
  2. Выберите пакет SDK версии 2020
  3. Выберите Кроссплатформенный
  4. Выберите Animate 20.0 (последняя версия), чтобы загрузить ПО. 

Щелкните здесь, чтобы скачать пример плагина и опираться на него при создании собственного плагина поддержки специализированной платформы. 

  1. Выберите Пакет SDK для специализированной платформы Animate на вкладке Downloads.
  2. Выберите пакет SDK версии 2020
  3. Выберите Пример плагина

Плагин состоит из следующих элементов.

  • DocType добавляет в Animate новый тип документа, соответствующий специализированной платформе, и управляет художественными возможностями.
  • Publisher служит для настройки параметров публикации и для публикации документа в специализированном формате.

Общие сведения о функции поддержки специализированных платформ приведены в разделе Поддержка специализированных платформ.

Построение плагина поддержки специализированной платформы для Animate

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

  • Создать плагин с помощью API-интерфейсов из комплекта разработки «Поддержка специализированных платформ».
  • Изменить параметры образца плагина, входящего в комплект разработки, согласно собственным требованиям.

Подключаемые модули поддержки специализированных платформ упаковываются в формат ZXP, после чего их можно подключить к программе Animate. Можно разместить плагин на сайте Надстроек Adobe Add-on, откуда пользователи смогут загрузить его и установить программой Creative Cloud, либо распространить плагин в виде пакета ZXP, который устанавливается с помощью утилиты Управление расширениями.

Программные требования

Для построения плагина с помощью комплекта разработки «Поддержка специализированных платформ» требуется следующее ПО: 

  • Microsoft Windows 10 (1803 и более поздних версий) или Apple Mac OS 10.13 и более поздних версий;
  • Microsoft Visual Studio 2017 (для Windows) или XCode 10.1 (для Mac);
  • Animate
  • среда разработки Eclipse для языков C/C++;
  • Adobe Extension Builder 3.0;
  • Утилита «Управление расширениями»

Справочная документация по API-интерфейсам для разработчиков плагинов

Комплект разработки «Поддержка специализированных платформ» содержит следующие элементы.

  • FCM (Flash Component Model, модель компонентов Flash): заголовочные файлы, входящие в комплект разработки, определяют платформу под названием FCM, которая предназначена для управления плагином.
  • DocType: содержит набор интерфейсов для добавления нового типа документа на начальную страницу Animate, а также для включения и отключения определенных функций для этого типа документа.
  • DOM (Document Object Model, модель объектов документа): содержит набор интерфейсов для доступа к содержимому документа Animate в форме модели DOM. 
  • Publisher: набор интерфейсов для связи с процессами публикации.

Полная информация об API-интерфейсах поддержки специализированных платформ с примерами их использования при разработке плагинов приведена в разделе Справочник по API-интерфейсам поддержки специализированных платформ.

Создание плагина поддержки специализированной платформы

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

  1. Загрузите комплект разработки «Поддержка специализированных платформ».
  2. Извлеките содержимое комплекта в папку на компьютере.
  3. Откройте новый проект разработки ПО VisualStudio или Xcode и включите в него заголовочные файлы из комплекта разработки. Чтобы не начинать разработку своего плагина поддержки специализированной платформы с нуля, можно использовать следующий образец плагина из папки SampleCreateJSPlatform, добавив его код в свой проект.
  4.             К примеру, файлы образца плагина SampleCreateJS находятся здесь:             SampleCreateJSPlatform\Plugin\SampleCreateJS\project\.

  5. Внесите необходимые изменения для своей платформы.
  6. Скомпилируйте код для формирования плагина (файла .dll или .plug-in). 

Упаковка плагина поддержки специализированной платформы

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

  1. Откройте образец плагина в среде Eclipse или создайте новый проект расширения приложений (Application Extension) в мастере создания проектов Eclipse. Присвойте проекту имя, затем нажмите кнопку Next (Далее).
  2. На панели New Adobe Application Extension Project (Новый проект расширения приложений Adobe) выберите в качестве целевого приложения Adobe Animate и нажмите кнопку Next (Далее).
  3. Измените расширения созданных файлов подключаемых модулей с .dll на .fcm для Windows или с .plug-in на .fcm.plug-in для Mac и добавьте файлы подключаемых модулей в проект (ExtensionContent/plugins/lib/win для Windows и ExtensionContent/plugins/lib/mac для Mac). 
  4. Настройте расширение, внеся изменения в файл manifest.xml. Чтобы открыть файл манифеста, щелкните правой кнопкой мыши расширение в обозревателе проектов и выберите Adobe Extension Builder 3 > Bundle Manifest Editor (Редактор манифестов пакета), а затем перейдите на вкладку манифеста в «Редакторе манифестов пакета», расположенном в папке EclipseProject\.staged-extension\CSXS.
  5. Чтобы отредактировать файл manifest.xml, щелкните правой кнопкой мыши в окне и выберите Open with (Открыть с помощью) > XML editor (Редактор XML). Необходимо обратить внимание на два следующих тега: ExtensionList и DispatchInfoList:

    Обычный тег ExtensionList выглядит следующим образом:

<ExtensionList>
<Extension Id=&quot;PluginID&quot; Version=&quot;1.0&quot; />
<Extension Id=&quot;PublishSettingsID&quot; Version-&quot;1.0&quot; />
</ExtensionList>
<ExtensionList> <Extension Id=&quot;PluginID&quot; Version=&quot;1.0&quot; /> <Extension Id=&quot;PublishSettingsID&quot; Version-&quot;1.0&quot; /> </ExtensionList>
<ExtensionList>

        <Extension Id=&quot;PluginID&quot; Version=&quot;1.0&quot; />

        <Extension Id=&quot;PublishSettingsID&quot; Version-&quot;1.0&quot; />

</ExtensionList>

 

Этот тег содержит список расширений окончательного пакета ZXP, в котором каждому расширению в качестве идентификатора присвоена уникальная строка. В этом случае файл .dll или .plugin, созданный в предыдущем разделе, будет добавлен в расширение. Затем для настройки пользовательского интерфейса параметров публикации средства публикации (Publisher) необходимо использовать другое расширение. В приведенном примере тега ExtensionList расширение с идентификатором PluginID содержит файл .dll/.plugin, а расширение с идентификатором PublishSettingsID используется для настройки пользовательского интерфейса параметров публикации средства публикации (Publisher).

 

  1. Тег DispatchInfoList содержит сведения о каждом расширении, указанном в ExtensionList. Ниже приведен пример тега DispatchInfoList:
<DispatchInfoList>
<Extension Id=&quot;PluginID&quot;>
<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=&quot;PublishSettingsID&quot;>
<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>
<DispatchInfoList> <Extension Id=&quot;PluginID&quot;> <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=&quot;PublishSettingsID&quot;> <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>
<DispatchInfoList>
            <Extension Id=&quot;PluginID&quot;>
                    <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=&quot;PublishSettingsID&quot;>
                    <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>
     
  1. При работе с файлами с расширением .dll или .plugin можно пропускать все теги, кроме тега MainPath. Тег MainPath содержит путь к файлу fcm.xml, связанному с папкой ExtensionContent. Расширение файла .dll необходимо изменить на .fcm и разместить его в папке win вместе с файлом fcm.xml. Подобным образом при работе в среде Mac переименуйте измените расширение файла .plugin на .fcm.plugin и поместите его в папку mac вместе с файлом fcm.xml.
  2. Расширение HTML, использующееся для настройки пользовательского интерфейса параметров публикации, является расширением HTML в Animate. Дополнительные сведения о расширениях HTML в Animate см. в разделе Создание расширений HTML.
  3. Убедитесь, что нижним значением атрибута version в теге Host является 15.1, то есть минимальная (внутренняя) версия Animate с поддержкой специализированных платформ.

<ExecutionEnvironment>
<HostList>
<Host Name=&quot;FLPR&quot; Version=&quot;15.1&quot; />
</HostList>.
.
.
</ExecutionEnvironment>
<ExecutionEnvironment> <HostList> <Host Name=&quot;FLPR&quot; Version=&quot;15.1&quot; /> </HostList>. . . </ExecutionEnvironment>
<ExecutionEnvironment>
<HostList>
<Host Name=&quot;FLPR&quot; Version=&quot;15.1&quot; />
</HostList>.
.
.
</ExecutionEnvironment>
     
  1. Переключитесь в вид Script Explorer (Обозреватель сценариев), затем щелкните правой кнопкой мыши проект и выберите Export (Экспорт) > Adobe Extension Builder 3 > Application Extension (Расширение приложения). Откроется мастер экспорта.
  2. Необходимо иметь сертификат для подписи пакета расширения. Выберите существующий сертификат или нажмите Create (Создать), чтобы создать новый.
  3. Для компиляции проекта нажмите Finish (Готово). Eclipse формирует файл плагина с расширением .zxp, который можно разместить на сайте надстроек Adobe Add-on.

Распространение плагина поддержки специализированной платформы

Вы можете распространить свой плагин поддержки специализированной платформы, разместив его на странице надстроек Adobe Add-on, и при этом получить прибыль. Прежде чем плагин отобразится на сайте, пакет плагина должен пройти процесс рассмотрения и утверждения Adobe. Разместить плагин можно следующим образом.

  1. Выполните вход на сайте Надстроек Adobe Add-on, указав свой идентификатор пользователя Adobe ID и пароль. 
  2. На левой панели в разделе Become a producer (Стать производителем) нажмите ссылку Go to the producer portal (Перейти на портал производителей).
  3. Нажмите кнопку Sign-up (Регистрация), если вы еще не зарегистрированы в качестве производителя продуктов.
  4. Подробные инструкции по регистрации в качестве производителя и размещению ваших плагинов см. в статье Начало работы с порталом производителей.
  5. Выполните следующие действия на портале производителей, как описано на странице Начало работы.
    1. Упакуйте продукт в один файл.
    2. Введите информацию о продукте и отправьте файл на сервер.
    3. Добавьте маркетинговые материалы.
    4. Просмотрите страницу своего продукта.
    5. Подайте продукт на утверждение.
  6. После утверждения плагин будет отображаться в категории продуктов Animate на странице надстроек. 

 Если вы являетесь пользователем и хотите установить плагин, создать документ специализированной платформы и опубликовать его с помощью Animate, см. раздел Работа с плагинами поддержки специализированных платформ.

Подробная информация о работе с расширениями Adobe приведена в разделе Загрузка и установка расширений.

Запрос на добавление функций и отправка сообщения с указанием на ошибку

Если вы хотите задать вопрос, сообщить об ошибке или отправить запрос на добавление функции в программу команде разработчиков Animate, заполните следующую форму:

Форма обратной связи Adobe

Получайте помощь быстрее и проще

Новый пользователь?