User Guide Cancel

Enabling Support for Custom Platforms

Last updated on Dec 22, 2021 03:47:25 AM GMT

This article guides the plug-in developers on how to create Animate plug-ins to support custom platforms using Animate.

To build a custom platform support plug-in, developers require the Custom Platform Support Development Kit. Click here to download.

Choose Animate Custom Platform SDK in Downloads tab
Select 2020 SDK version
Select Cross Platform, and
Select Animate 20.0 (Latest) option to download.

Click here to download a sample plug-in and use it as a reference for building a custom support platform support plug-in.

Choose Animate Custom Platform SDK in Downloads tab.
Select 2020 SDK version
Select Sample Plug-in

A plug-in consists of the following elements:

DocType adds a new document type for the custom platform in Animate and controls the authoring features.
Publisher allows configuration of the publish settings and publishing the document to the custom platform.

For an overview of the Custom Platform Support feature, see Custom Platform Support.

Building a Animate custom platform support plug-in

You can develop a custom platform support plug-in using one of the following methods:

Create a plug-in using the APIs in the custom platform support development kit.

Customize the settings of the sample plug-in included in the development kit to suit your requirements.

Custom Platform Support plug-ins are packaged as .zxp files that can be installed with Animate. You can host the plug-in on the Adobe Add-ons page for users to download and install using the Creative Cloud application or distribute the plug-ins as .zxp packages to install them using the Manage Extensions utility.

Software requirements

A developer needs the following software to build a plug-in using the custom platform support development kit:

Microsoft Windows 10 (1803 and later) or Apple Mac OS 10.13 and later
Microsoft Visual Studio 2017 (for Windows) or XCode 10.1 (for Mac)
Animate
Eclipse IDE for C/C++ Developers
Adobe Extension Builder 3.0
Manage Extensions utility

API reference documentation for plug-in developers

The custom platform support development kit contains the following elements:

FCM (Flash Component Model): The header files contained in the development kit define a framework called FCM, which is responsible for plug-in management.
DocType: This contains a set of interfaces that helps you to add a new document type to the Animate start page and allows you to enable or disable features for the custom document type.
DOM (Document Object Model): This contains a set of interfaces that helps you to access the contents of the animate document in the form of a DOM.
Publisher: This contains a set of interfaces that provides hooks to the publish workflows.

For complete information about the APIs in the custom platform support and examples of how to use them to build your plug-in, see Custom Platform Support API Reference.

Creating a custom platform support plug-in

You can create a custom platform support plug-in as follows:

Download the Custom Platform Support Development Kit.
Extract the contents of the kit to your computer.
Open a new project in VisualStudio or Xcode and include the header files in the development kit to your software development project. To quick-start the creation of your custom platform support plug-in, you can use the following sample plug-in available under the SampleCreateJSPlatform directory as the base code for your plug-in project.

For example, the SampleCreateJS plug-in files are at SampleCreateJSPlatform\Plugin\SampleCreateJS\project\

Make necessary changes for your target platform.
Compile the code to generate a plug-in (.dll or .plug-in).

Packaging the custom platform support plug-in

You can generate a distributable package of the custom platform support plug-in as follows:

Open the sample Eclipse file or in the Eclipse New Project wizard, create a new Application Extension Project. Provide a name for the project, then click Next.
On the New Adobe Application Extension Project panel, choose Adobe Animate as the target application and click Next.
Change the extensions of the plug-in files that you had created from .dll to .fcm on Windows and from .plug-in to .fcm.plug-in on Mac and add the plug-in files to the project (ExtensionContent/plugins/lib/win for Windows and ExtensionContent/plugins/lib/mac for MAC).
Configure your extension by modifying the manifest.xml. To open the manifest file, right-click on the extension in project explorer and select Adobe Extension Builder 3 > Bundle Manifest Editor and select the manifest tab in Bundle Manifest Editor present at EclipseProject\.staged-extension\CSXS.
To enable editing the manifest.xml, right-click inside the window and select Open with > XML editor. The two tags that you must concentrate on are: ExtensionList and DispatchInfoList:
A typical ExtensionList tag looks as below:

<ExtensionList>

        <Extension Id="PluginID" Version="1.0" />

        <Extension Id="PublishSettingsID" Version-"1.0" />

</ExtensionList>

This tag contains the list of extensions in the final ZXP package in which each extension has a unique string as its ID. In this case, the .dll or .plugin file created in the previous section is included in an extension. Then, the other extension is used for configuring the Publish Settings UI of the Publisher. In the sample, ExtensionList tag the extension with the extension ID PluginID contains the .dll/.plugin file and the extension with the ID PublishSettingsID configures the publish pettings UI of the publisher.

The DispatchInfoList tag contains details about each extension mentioned in the ExtensionList. The following is an example of 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>

For the extension containing the .dll or the .plugin file, you can ignore all the tags except the MainPath tag. The MainPath tag contains path to the file fcm.xml relative to the ExtensionContent folder. You must rename the .dll file to .fcm and placed inside the win folder beside the fcm.xml. Similarly, if you are working on the Mac environment, rename the .plugin file to .fcm.plugin and place it inside the mac folder beside the fcm.xml.
The HTML extension to configure the publish settings user interface is an HTML extension to Animate. To know more about HTML extensions to Animate, see Creating HTML Extensions.
Ensure that the lower value of the version attribute in the Host tag is 15.1, the minimum (internal) version of Animate with Custom Platform Support.

<ExecutionEnvironment>
<HostList>
<Host Name="FLPR" Version="15.1" />
</HostList>.
.
.
</ExecutionEnvironment>

Switch to the Script Explorer view, right-click on your project and choose Export > Adobe Extension Builder 3 > Application Extension. The Export Wizard appears.
You must have a certificate to sign the extension package. Browse to an existing certificate or click Create to create a new certificate.
Click Finish to compile the project. Eclipse generates a plug-in file with .zxp extension, which you can host on the Adobe Add-ons site.

Distributing your custom platform support plug-in

You can distribute the custom platform support plug-in by hosting it on the Adobe Add-ons page and monetize it. Your plug-in package goes through an Adobe review and approval process before it is listed on the page. You can host a plug-in as follows:

Log in to the Adobe Add-ons page using your Adobe user ID and password.
On the left panel, under Become a producer, click the link Go to the producer portal.
Click the Sign-up button if you are not signed up as a producer.
For detailed instructions on how to sign up as a producer and host your plug-ins, see Getting Started with the Producer Portal.
Complete the following steps in the producer portal workflow as documented in the Getting Started page:
1. Package your product in a single file.
2. Enter information about the product and upload the file.
3. Add marketing assets.
4. Preview your product.
5. Submit your product for approval.
After approval, your plug-in is listed under the Animate product category on the Add-ons page.

If you are a user who wants to install a plug-in, create a custom platform document, and publish it using Animate, see Working with Custom Platform Support Plug-in.