Animate puede ampliarse con extensiones HTML. Adobe Extension Builder 3 permite crear extensiones HTML para Animate Anteriormente, solo se podía ampliar Animate con extensiones SWF. Sin embargo, Adobe Extension Builder 3 permite crear extensiones HTML para aplicaciones de Creative Cloud. Para comenzar, debe descargar e instalar Eclipse y Extension Builder 3.0.

Para crear una extensión HTML, haga lo siguiente.

1. Inicie Eclipse. 
2. En el New Project wizard (Asistente de nuevo proyecto), cree un nuevo Application Extension Project (Proyecto de extensión de aplicación). Proporcione un nombre significativo para el proyecto y haga clic en Next (Siguiente).
3. En el panel New Adobe Application Extension Project (Nuevo proyecto de extensión de aplicación de Adobe), elija Adobe Animate. Haga clic en Siguiente.
4. Configure la extensión con las opciones disponibles:
   
   1. Bundle ID (ID de paquete) identifica la extensión.
   2. Menu name (Nombre de menú) es el nombre de la extensión. Menu Name aparece en el menú Ventana > Extensiones de Animate.
      
   3. Window Details (Detalles de la ventana) utilice estas opciones para personalizar el tipo y tamaño de la ventana de la extensión.
      
      Haga clic en Next (Siguiente).
5. Puede personalizar las bibliotecas de referencia para la extensión en las próximas pantallas:
   1. CEP Interface Library (Biblioteca de interfaz de CEP) ofrece funciones para interactuar con la aplicación host. De forma predeterminada, esta opción está seleccionada.
   2. Frameworks (Arquitecturas) se aplica a bibliotecas comunes de JavaScript como jQuery.
      
   3. Services (Servicios) incluye el Adobe IPC Communication Toolkit (Kit de herramientas Adobe IPC Communication Toolkit), que permite la comunicación entre aplicaciones de Adobe, extensiones y aplicaciones externas. Proporciona un protocolo de mensajería mediante CEP Service Manager, que actúa como núcleo para las comunicaciones de Creative Cloud.
      
      Haga clic en Finish (Finalizar) para crear un nuevo proyecto de Eclipse.

Eliminar errores de su extensión en Animate 

Puede ejecutar la extensión directamente desde Eclipse:

1. Haga clic en el proyecto, y seleccione Run As (Ejecutar como) > Adobe Flash Extension (Extensión de Adobe Flash). Esto inicia Animate.
2. En Animate, seleccione el elemento de menú Ventana > Extensiones. Se abrirá el panel Extensión.

Exportación de la extensión

Para distribuir una extensión, deberá exportarla como un paquete ZXP. El paquete ZXP se descarga y ejecuta mediante Adobe Extension Manager en aplicaciones de Creative Cloud:

1. En Eclipse, cambie a la vista Script Explorer (Explorador de scripts) para poder hacer clic con el botón secundario en el proyecto y seleccionar Export (Exportar) > Adobe Extension Builder 3 > Application Extension (Extensión de aplicación). Se mostrará el Export Wizard (Asistente de exportación).
2. Debe tener un certificado para firmar el paquete de la extensión. Busque un certificado existente o haga clic en Create (Crear) para crear uno nuevo.
3. Haga clic en Finish (Finalizar).
4. Cuando finalice la exportación, encontrará el paquete ZXP para la extensión en la carpeta del proyecto, listo para su distribución.

Nota: Para instalarlo necesitará acceder al archivo <extensión>\.staged-extension\CSXS\manifest.xml y actualizar la etiqueta host para definir la versión mínima de Animate en 13.0.

Instalar su extensión en Animate 

Puede instalar extensiones HTML en Animate con Adobe Extension Manager. Las extensiones HTML le ayudarán a ampliar las funciones y capacidades de Animate.

Adición de interactividad a las extensiones HTML

Puede crear una extensión HTML para interactuar con Animate si añade controles, define comportamientos y proporciona información sobre el entorno de host (incluye Animate y el sistema operativo). Esto se puede realizar de dos formas:

1. Con la biblioteca de interfaz de CEP: La biblioteca de interfaz de CEP proporciona a las API información sobre el entorno de host y un script eval que permite ejecutar JSFL. Para obtener más información sobre la biblioteca de interfaz de CEP, abra Help (Ayuda) > Help Contents (Ayuda de contenido) > Adobe Extension Builder > References (Referencias) en Eclipse.
2. Con JSFL: Los scripts JSFL se pueden ejecutar con la API del script eval de la biblioteca de interfaz de CEP.
   
   Además de los scripts JSFL, la infraestructura de CEP en Animate también muestra los siguientes eventos que solo pueden utilizarse dentro de los paneles HTML.
   • com.adobe.events.flash.documentChanged se activa debido a un cambio en el documento activo actual.
   • com.adobe.events.flash.timelineChanged se activa al realizar un cambio en la línea de tiempo del documento activo actual.
   • com.adobe.events.flash.documentSaved se activa al guardar el documento actual.
   • com.adobe.events.flash.documentOpened se activa al abrir un documento nuevo.
   • com.adobe.events.flash.documentClosed se activa al cerrar el documento activo actual.
   • com.adobe.events.flash.documentNew se activa al crear un documento nuevo.
   • com.adobe.events.flash.layerChanged se activa al seleccionar una capa distinta.
   • com.adobe.events.flash.frameChanged se activa al seleccionar un fotograma distinto.
   • com.adobe.events.flash.selectionChanged se activa al seleccionar un objeto distinto en el escenario.
   • com.adobe.events.flash.mouseMove se activa al mover el ratón por el escenario.

Ejemplo

En el fragmento de código anterior:

• csinterface: Objeto de la biblioteca de interfaz de CEP.
• com.adobe.events.flash.selectionChanged: Evento que activa un cambio en la selección de un objeto. También puede utilizar cualquiera de los eventos anteriores.
• CallbackFunction: Método que detecta el evento activado.