本文指导插件开发人员学习如何创建支持自定义平台的 Animate 插件。若想构建自定义平台支持插件,开发人员必须从以下位置下载自定义平台支持开发工具包:

从以下位置下载一个样例插件,将其用作构建自定义平台支持插件的参考:

下载

下载

插件由以下几个元素构成:

  • DocType:它将在 Animate 中为自定义平台添加一个新的文档类型并控制创作功能。
  • Publisher(发布程序):它允许配置发布设置并将文档发布到自定义平台。

有关自定义平台支持功能的概略介绍,请参阅自定义平台支持

构建 Animate 自定义平台支持插件

可以使用以下一种方法来开发自定义平台支持插件:

  • 使用自定义平台支持开发工具包中的 API 创建一个插件。
  • 对开发工具包中附带的样例插件的设置进行定制,以满足自己的需求。

自定义平台支持插件打包为 .zxp 文件,这种文件可以使用 Animate CC 来安装。您可以将插件在 Adobe Add-ons 页面上进行托管,以供用户下载并使用 Creative Cloud 应用程序进行安装,也可以将插件作为 .zxp 包来分发,然后使用 Adobe Extensions Manager 安装插件。

软件要求

要使用自定义平台支持开发工具包构建插件,开发人员需要以下软件。 

  • Microsoft Windows 7 或更高版本,或者是 Apple Mac OS 10.8 或更高版本
  • Microsoft Visual Studio 2012 (Windows) 或 XCode 4.5.2 (Mac)
  • Animate CC 2014.1(10 月)
  • Eclipse IDE for C/C++ Developers
  • Adobe Extension Builder 3.0
  • Adobe Extension Manager 7.2.1.6

供插件开发人员阅读的 API 参考文档

自定义平台支持开发工具包包含以下元素:

  • FCM(Flash 组件模型):包含在开发工具包中的标头文件,用于定义一个名为 FCM 的框架,该框架负责插件的管理。
  • DocType:包含一组接口,可帮助您向 Animate 开始页面中添加一个新的文档类型,并允许您启用或禁用用于自定义文档类型的各项功能。
  • DOM(文档对象模型):包含一组接口,可帮助您以 DOM 的形式访问 Animate 文档的内容。 
  • 发布程序:包含一组接口,用于向发布工作流提供钩子程序。

有关自定义平台支持 API 的完整信息和如何使用它们来构建自己插件的示例,请参阅自定义平台支持 API 参考

创建自定义平台支持插件

可按如下方式创建自定义平台支持插件:

  1. 下载自定义平台支持开发工具包
  2. 将工具包的内容提取到计算机。
  3. 在 VisualStudio 或 Xcode 中打开一个新项目,然后将开发工具包中的标头文件包括到您的软件开发项目中。若想快速开始创建您的自定义平台支持插件,可以使用以下样例插件(在 SampleCreateJSPlatform 目录下提供)作为您插件项目的基础代码。
  4. 例如,SampleCreateJS 插件文件位于 SampleCreateJSPlatform\Plugin\SampleCreateJS\project\ 下

  5. 针对您的目标平台进行必要的更改。
  6. 编译代码以生成一个插件(.dll 或 .plug-in)。 

包装自定义平台支持插件

可按如下方式生成一个自定义平台支持插件的可分发包:

  1. 打开 Eclipse 样例文件或在 Eclipse New Project(新建项目)向导中,创建一个新的应用程序扩展项目。为该项目提供一个名称,然后单击 Next(下一步)。
  2. 在 New Adobe Application Extension Project(新建 Adobe 应用程序扩展项目)面板中,选择 Adobe Animate 作为目标应用程序,然后单击 Next(下一步)。
  3. 将所创建的插件文件的扩展名由 .dll 改为 .fcm (Windows) 或由 .plug-in 改为 .fcm.plug-in (Mac),然后将插件文件添加到项目中(在 Windows 中为 ExtensionContent/plugins/lib/win,在 MAC 中为ExtensionContent/plugins/lib/mac)。
  4. 通过修改 manifest.xml 配置扩展名。要打开 manifest 文件,可在项目管理器中右键单击该扩展,选择 Adobe Extension Builder 3 > Bundle Manifest Editor,然后在 Bundle Manifest Editor 中选择 manifest 选项卡(位于 EclipseProject\.staged-extension\CSXS)。
  5. 要编辑 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 包中的扩展列表,包中的每个扩展都有一个唯一的字符串作为其 ID。这时,在前一部分中创建的 .dll 或 .plugin 文件会包括在一个扩展中。然后,其他扩展用于配置发布者的发布设置 UI。在 ExtensionList 标记示例中,扩展 ID 为 PluginID 的扩展包含 .dll/.plugin 文件,扩展 ID 为 PublishSettingsID 的扩展用于配置发布者的发布设置 UI。

 

  1. DispatchInfoList 标记包含 ExtensionList 中涉及的每个扩展的详细信息。以下是 DispathInfoList 的一个例子:
<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>
  1. 对于包含 .dll 或 .plugin 文件的扩展,除 MainPath 标记外,您可以忽略所有标记。MainPath 标记包含文件 fcm.xml 相对于 ExtensionContent 文件夹的路径。必须将 .dll 文件重命名为 .fcm,并将其放在 win 文件夹内部 fcm.xml 的旁边。同样,如果是处在 Mac 环境中,则将 .plugin 文件重命名为 .fcm.plugin,并将其放在 mac 文件夹内部 fcm.xml 的旁边。
  2. 用来配置发布设置用户界面的 HTML 扩展是一个针对 Animate 的 HTML 扩展。若想了解有关 Animate 的 HTML 扩展的更多信息,请参阅创建 HTML 扩展
  3. 确保 Host 标记中 version 属性的最低值为 14.0,这是具有自定义平台支持的 Animate CC 的最低(内部)版本。
<ExecutionEnvironment>
<HostList>
<Host Name="FLPR" Version="14.0" />
</HostList>.
.
.
</ExecutionEnvironment>
     
  1. 切换到 Script Explorer 视图,右键单击项目并选择 Export(导出)> Adobe Extension Builder 3 > Application Extension(应用程序扩展)。将显示 Export Wizard(导出向导)。
  2. 您必须具有证书才能对扩展包进行签名。浏览到现有证书,或单击 Create(创建),创建一个新的证书。
  3. 单击 Finish(完成)编译项目。Eclipse 将生成一个扩展名为 .zxp 的插件文件,您可以将其托管在 Adobe Add-ons 网站上。

分发自定义平台支持插件

您可以通过将自定义平台支持插件托管到 Adobe Add-ons 页面然后标价的方式来分发插件。您的插件包要经过 Adobe 的审核和批准过程才能列出在页面中。可以按如下方式托管插件:

  1. 使用您的 Adobe ID 和密码登录到 Adobe add-ons 页面。
  2. 在左面板的 Become a producer(成为一名生产者)下,单击链接 Go to the producer portal(转至生产者入口)。
  3. 如果未作为生产者注册,可单击注册按钮。
  4. 有关如何作为生产者注册并托管插件的详细说明,请参阅生产者入口快速入门
  5. 按照快速入门页面中的生产者入口工作流说明完成以下步骤:
    1. 将产品打包在一个单独的文件中。
    2. 输入产品的有关信息并上传该文件。
    3. 添加市场资源。
    4. 预览您的产品。
    5. 提交您的产品以进行审批。
  6. 批准之后,您的插件便会列在附加组件页面中的 Animate 产品类别下。 

注意:

 

功能需求与错误报告

若想向 Animate 产品小组发送任何问题、疑惑、产品错误或功能需求,可填写以下表单:

Adobe 功能需求和错误报告单

本产品经 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License 许可  Twitter™ 与 Facebook 中的内容不在 Creative Commons 的条款约束之下。

法律声明   |   在线隐私策略