Activación de la compatibilidad con plataformas personalizadas

Este artículo ayuda a los desarrolladores de plugins a crear plugins para Animate compatibles con plataformas personalizadas en Animate 2015. Si utiliza Animate CC 2014.1 (actualización de octubre de 2014) o CC 2014.2 (actualización de febrero de 2015), consulte las versiones anteriores del documento:

Versión 1.1 (2014.2)

Versión 1.0 (2014)

Para crear un plugin de compatibilidad con plataformas personalizadas, los desarrolladores deben descargar el kit de desarrollo de compatibilidad con plataformas personalizadas desde esta ubicación:

Descargue un plugin de muestra de la siguiente ubicación y úselo como referencia para crear un plugin de compatibilidad con plataformas personalizadas:

Un plugin consta de los siguientes elementos:

• DocType añade un nuevo tipo de documento para la plataforma personalizada en Animate y controla las funciones de creación.
• Publisher permite configurar la configuración de publicación y publicar el documento en la plataforma personalizada.

Para obtener una descripción general de la función de compatibilidad con plataformas personalizadas, consulte Compatibilidad con plataformas personalizadas. 

Novedad de Animate CC 2015: 

• Capacidad para consultar el tipo de un símbolo de la biblioteca: si hay símbolos, ILibraryItem::GetProperties() tendrá una entrada adicional con la clave kLibProp_SymbolType_DictKey. El valor de la clave puede ser kLibProp_SymbolType_Button, kLibProp_SymbolType_MovieClip o kLibProp_SymbolType_Graphic.
• Capacidad para distinguir entre un botón y MovieClip: hasta la versión anterior, el DOM y el servicio de IFrameCommandGenerator trataban las instancias de botón como MovieClip. A partir de Animate CC 2015, se ha añadido una interfaz compatible con las instancias de botón. Si la instancia de IMovieClip también implementa la interfaz de IButton, se trata como una instancia de botón. Los cuatro estados de un botón (arriba, sobre, abajo, y presionado) siempre se asignan a los fotogramas 0, 1, 2 y 3 respectivamente. Consulte el archivo IButton.h para obtener más información sobre la instancia de botón.
• Nuevas API para obtener los límites de los objetos de IClassicText: La función AddClassicText en la interfaz ITimelineBuilder ahora devuelve un objeto CLASSIC_TEXT_INFO_2 (en lugar del CLASSIC_TEXT_INFO anterior), que contiene un nuevo campo “límites” que representa los límites del objeto IClassicText.
• El plugin de muestra se ha modificado para reutilizar los mapas de bits utilizados para rellenos de forma.
• El servidor web Mongoose se ha incorporado al plugin de muestra.

Nota: La nueva herramienta Hueso IK disponible en la versión de 2015 de Animate CC está desactivada en tipos de documento de plataforma personalizada. Animate convierte el contenido IK en una animación de fotograma a fotograma cuando se pega en un documento de plataforma personalizada. 

Actualización de febrero de 2015: Compatibilidad con las “máscaras” en el servicio IFrameCommandGenerator; esta versión es compatible con máscaras en el servicio IFrameCommandGenerator. La nueva interfaz ITimelineBuilder2 que se ha heredado de la interfaz existente ITimelineBuilder contiene funciones que el plugin debe implementar para que funcione. Consulte la Documentación de las API de compatibilidad con plataformas personalizadas para obtener más información sobre la nueva interfaz ITimelineBuilder2.

Puede desarrollar un plugin de compatibilidad con plataformas personalizadas mediante uno de los métodos siguientes:

• Cree un plugin mediante las API del kit de desarrollo de compatibilidad con plataformas personalizadas.

• Modifique la configuración del plugin de muestra incluido en el kit de desarrollo para adaptarlo a sus necesidades.

Los complementos de compatibilidad con plataformas personalizadas se comprimen como archivos .zxp que se pueden instalar con Animate. Puede incluir el plugin en la página Adobe Add-ons para que los usuarios lo descarguen e instalen mediante la aplicación Creative Cloud o distribuirlo como un paquete .zxp para instalarlo con Adobe Extension Manager.

Requisitos del software

Un desarrollador necesitará el software siguiente para crear un plugin con el kit de desarrollo de compatibilidad con plataformas personalizadas: 

• Microsoft Windows 7 o Apple Mac OS 10.8 y posterior 
• Microsoft Visual Studio 2012 (para Windows) o XCode 6.1 (para Mac)
• Animate CC 2015.1 y posterior
• Eclipse IDE para desarrolladores de C/C++
  
• Adobe Extension Builder 3.0
• Adobe Extension Manager
  

Documentación de referencia de API para desarrolladores de plugins

El kit de desarrollo de compatibilidad con plataformas personalizadas contiene los siguientes elementos:

• FCM (modelo de componente de Flash): Los archivos de encabezado contenidos en el kit de desarrollo definen una estructura denominada FCM, que se encarga de la administración de plugins.
• DocType: Este elemento contiene un conjunto de interfaces que le ayudan a añadir un nuevo tipo de documento a la página de inicio de Animate y le permiten activar o desactivar funciones para el tipo de documento personalizado.
• DOM (modelo de objetos de documento): Este elemento contiene un conjunto de interfaces que le ayudan a acceder al contenido del documento de Animate en forma de DOM. 
• Publisher: Este elemento contiene un conjunto de interfaces que proporcionan código para los flujos de trabajo de publicación.

Para obtener información sobre las API en la compatibilidad con plataformas personalizadas y ejemplos de cómo utilizarlas para crear el plugin, consulte Referencia a las API de compatibilidad con plataformas personalizadas.

Creación de un plugin de compatibilidad con plataformas personalizadas

Puede crear un plugin de compatibilidad con plataformas personalizadas de la siguiente manera:

1. Descargue el Kit de desarrollo de compatibilidad con plataformas personalizadas.
2. Extraiga el contenido del kit en su equipo.
3. Abra un nuevo proyecto en VisualStudio o XCode e incluya los archivos de encabezado del kit de desarrollo en el proyecto de desarrollo de software. Para iniciar con rapidez la creación del plugin de compatibilidad con plataformas personalizadas, puede utilizar el siguiente plugin de muestra disponible en el directorio SampleCreateJSPlatform como código base para su proyecto de plugin.

            Por ejemplo, los archivos de plugins SampleCreateJS están en                         SampleCreateJSPlatform\Plugin\SampleCreateJS\project\

4. Realice los cambios necesarios para la plataforma de destino.
5. Compile el código para generar un plugin (.dll o .plug-in). 

Empaquetado del plugin de compatibilidad con plataformas personalizadas

Puede generar un paquete de distribución del plugin de compatibilidad con plataformas personalizadas de la siguiente manera:

1. Abra el archivo Eclipse de muestra o, en el New Project wizard (Asistente de nuevo proyecto) de Eclipse, cree un nuevo Application Extension Project (Proyecto de extensión de aplicación). Proporcione un nombre para el proyecto y haga clic en Next (Siguiente).
2. En el panel New Adobe Application Extension Project (Nuevo proyecto de extensión de aplicación de Adobe), elija Adobe Animate como aplicación de destino y haga clic en Siguiente.
3. Cambie las extensiones de los archivos del plugin que haya creado de .dll a .fcm en Windows y de .plug-in a .fcm.plug-in en Mac y añada los archivos del plugin al proyecto (ExtensionContent/plugins/lib/win para Windows y ExtensionContent/plugins/lib/mac para Mac). 
4. Para configurar la extensión, modifique el archivo manifest.xml. Para abrir el archivo de manifiesto, haga clic con el botón derecho en la extensión en el explorador del proyecto, seleccione Adobe Extension Builder 3 > Bundle Manifest Editor (Editor de manifiestos de paquete) y seleccione la ficha de manifiesto en Bundle Manifest Editor de EclipseProject\.staged-extension\CSXS.
5. Para poder editar el archivo manifest.xml, haga clic con el botón derecho dentro de la ventana y seleccione Open with (Abrir con) > XML Editor (Editor XML). Las dos etiquetas en las que se debe centrar son: ExtensionList y DispatchInfoList:

   Una etiqueta típica de ExtensionList es la siguiente:

Esta etiqueta contiene la lista de extensiones en el paquete ZXP final, en el que cada extensión tiene una cadena única como su ID. En este caso, el archivo .dll o .plugin creado en la sección anterior se incluye en una extensión. A continuación, se utiliza la otra extensión para configurar la IU de Ajustes de publicación del editor. En la muestra de la etiqueta ExtensionList, la extensión con el ID de extensión PluginID contiene el archivo .dll/.plugin y la extensión con el ID PublishSettingsID configura la IU de ajustes de publicación del editor.

6. La etiqueta DispatchInfoList contiene detalles sobre cada extensión mencionada en ExtensionList. A continuación se muestra un ejemplo de DispatchInfoList:

 
7. Para la extensión que contenga el archivo .dll o .plugin, puede ignorar todas las etiquetas excepto la etiqueta MainPath. La etiqueta MainPath contiene la ruta al archivo fcm.xml relativa a la carpeta ExtensionContent. Debe cambiar el nombre del archivo .dll a .fcm y colocarlo dentro de la carpeta win, junto al archivo fcm.xml. Del mismo modo, si está trabajando en un entorno de Mac, cambie el nombre del archivo de .plugin a .fcm.plugin y colóquelo dentro de la carpeta Mac, junto al archivo fcm.xml.
8. La extensión HTML para configurar la interfaz de usuario de los ajustes de publicación es una extensión HTML para Animate. Para obtener más información sobre las extensiones HTML para Animate, consulte Creación de extensiones HTML.
9. Asegúrese de que el valor más bajo del atributo de la versión en la etiqueta Host sea 14.1, que es la versión mínima (interna) de Animate compatible con plataformas personalizadas.
   
   

 
10. 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). Aparece el Export Wizard (Asistente de exportación).
11. 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.
12. Haga clic en Finish (Finalizar) para compilar el proyecto. Eclipse genera un archivo de plugin con la extensión .zxp, que se puede incluir en el sitio Adobe Add-ons.

Distribución del plugin de compatibilidad con plataformas personalizadas

Puede distribuir el plugin de compatibilidad con plataformas personalizadas si lo incluye en la página Adobe Add-ons y lo comercializa. Antes de incluirlo en la página, Adobe analiza el paquete de plugin y lo aprueba. Puede incluir un plugin del modo siguiente:

1. Inicie sesión en la página Adobe Add-ons con su ID de usuario de Adobe y contraseña. 
2. En el panel izquierdo, en Hacerse productor, haga clic en el vínculo Ir al portal para productores.
3. Haga clic en el botón Iniciar sesión si no ha iniciado sesión como productor.
4. Para obtener instrucciones detalladas sobre cómo registrarse como productor e incluir sus plugins, consulte Introducción al portal para productores.
5. Realice los pasos siguientes en el flujo de trabajo del portal para productores como se indica en la página Introducción al portal para productores:
   1. Empaquete el producto en un solo archivo.
   2. Especifique la información sobre el producto y cargue el archivo.
   3. Añada recursos de marketing.
   4. Previsualice el producto.
   5. Envíe el producto para su aprobación.
6. Tras la aprobación, el plugin aparecerá en la categoría de productos de Animate en la página Add-ons. 

Solicitud de funciones e informes de errores

Rellene el formulario siguiente si desea enviar preguntas, consultas, errores de producto o solicitudes de funciones al equipo del producto Animate:

Formulario de informes de errores y solicitudes de funciones de Adobe