pixijs / animate-extension

Custom Platform Plugin for Adobe Animate CC (Formerly Adobe Flash CC) - to export animation for the PixiJS renderer
129 stars 25 forks source link
adobe animate cep extension pixijs zxp

Pixi Animate Extension

Creates a custom FLA document which support publishing to PixiJS natively in Adobe Animate CC (formerly Flash CC 2015).

Examples

See examples for sample FLA document to test features of PixiAnimate.

Dependencies

The following dependencies are required in order to publishing FLA document created with this Plugin.

Installation

If you are trying to install with Adobe Animate CC 2015, you cannot install the ZXP with Adobe Extension Manager CC (this not longer is supported in CC 2015). There are two ways to install:

Building

To get setup, please follow the instructions outlined from Adobe's documentation. This will enable you to build the project itself and see the plugin exposed from Adobe Animate CC.

CEP Debug Mode

To setup your platform for development, you must enable debugging in your Adobe preferences for CEP. VERY Important to reboot your machine after making this change or it will not take effect.

Windows

Go to Registry, regedit > HKEY_CURRENT_USER/Software/Adobe/CSXS.6, then add a new entry PlayerDebugMode of type "string" with the value of "1".

OS X

Add the entry PlayerDebugMode of type "string" with value set to 1 in the plist file /Users/<username>/Library/Preferences/com.adobe.CSXS.6.plist

Mac OS X Instructions

To build and install to Animate CC directly, run the script. This will copy the plugin and then install in the CEP extension's folder (/Library/Application Support/Adobe/CEP/extensions/com.jibo.PixiAnimate/)

gulp --install

To build the extension in debug mode and allow for remote debugging, run this command. Navigate to http://localhost:8008 to get the DevTools for the Publish Settings dialog.

gulp --buildDebug --install

To rebuild the C++ code on the current platform, use the --plugin flag. This will build the plugin for both debug and release.

gulp --buildDebug --install --plugin

Or to ONLY build the plugin without building the rest of the extension.

For release:

gulp plugin

Windows Instructions

Notice: When switching visual studio from 14 (2015) to a different version, do the following

Update your npm first

npm install -g npm

Install global npm packages

npm install -g electron gulp-cli

Install or restore local packages

npm update

Build plugin and install plugin

gulp --plugin --install

Now use the ZXP utility for windows to install the PixiAnimate.zxp plugin for Adobe Animate CC 2015, make sure to remove the existing plugin before install

Note on JSFL scripts - they are taken from Springroll's Flash Toolkit, as the used scripts are very relevant for optimization of Pixi Animate content.