Guía del usuario Cancelar

Activación de la compatibilidad con plataformas personalizadas

Buscar

Última actualización el Feb 10, 2022 01:53:08 PM GMT

Gracias a este artículo, los desarrolladores de complementos tienen la oportunidad de crear complementos para Animate compatibles con plataformas personalizadas que a su vez usan Animate.

Para diseñar un plugin compatible con plataformas personalizadas, los desarrolladores necesitan el kit de desarrollo de compatibilidad con plataformas personalizadas. Haga clic aquí para descargarlo.

Elija SDK de plataforma personalizada de Animate en la pestaña Descargas
Seleccione la versión del SDK 2020
Seleccione Cross Platform (Multiplataforma), y
Seleccione la opción Animate 20.0 (más reciente) para la descarga.

Haga clic aquí para descargar un plugin de muestra y usarlo como referencia para diseñar un plugin compatible con plataformas personalizadas.

Elija SDK de plataforma personalizada de Animate en la pestaña Descargas.
Seleccione la versión del SDK 2020
Seleccione Plugin de muestra

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.

Creación de un plugin de Animate con compatibilidad con plataformas personalizadas

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 complemento 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 la utilidad Manage Extensions.

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 10 (versión 1803 y posteriores) o Apple Mac OS 10.13 y posterior
Microsoft Visual Studio 2017 (para Windows) o XCode 10.1 (para Mac)
Animate
Eclipse IDE para desarrolladores de C/C++
Adobe Extension Builder 3.0
Utilidad Manage Extensions

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:

Descargue el Kit de desarrollo de compatibilidad con plataformas personalizadas.
Extraiga el contenido del kit en su equipo.
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\

Realice los cambios necesarios para la plataforma de destino.
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:

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).
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.
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).
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.
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:

<ExtensionList>

        <Extension Id=&quot;PluginID&quot; Version=&quot;1.0&quot; />

        <Extension Id=&quot;PublishSettingsID&quot; Version-&quot;1.0&quot; />

</ExtensionList>

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.

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

<DispatchInfoList>
            <Extension Id=&quot;PluginID&quot;>
                    <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=&quot;PublishSettingsID&quot;>
                    <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>

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.
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.
Asegúrese de que el valor más bajo del atributo de la versión en la etiqueta Host sea 15.1, la versión mínima (interna) de Animate que es compatible con plataformas personalizadas.

<ExecutionEnvironment> <HostList> <Host Name=&quot;FLPR&quot; Version=&quot;15.1&quot; /> </HostList>.
.
.
</ExecutionEnvironment>

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).
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.
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:

Inicie sesión en la página Adobe Add-ons con su ID de usuario de Adobe y contraseña.
En el panel izquierdo, en Hacerse productor, haga clic en el vínculo Ir al portal para productores.
Haga clic en el botón Iniciar sesión si no ha iniciado sesión como productor.
Para obtener instrucciones detalladas sobre cómo registrarse como productor e incluir sus plugins, consulte Introducción al portal para productores.
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.
Tras la aprobación, el plugin aparecerá en la categoría de productos de Animate en la página Add-ons.

Si es un usuario que desea instalar un plugin, crear un documento para plataformas personalizadas y publicarlo con Animate, consulte Uso de plugins de compatibilidad con plataformas personalizadas.