Desarrollo de componentes principales

¿Cuándo se deben utilizar los componentes principales?

Como los componentes principales son completamente nuevos y ofrecen varios beneficios, se recomienda utilizarlos en los nuevos proyectos de AEM. En los proyectos existentes, la migración debería ser parte de un esfuerzo de proyecto aún mayor; por ejemplo, para realizar un cambio en la marca o la refactorización total.

Por lo tanto, Adobe ofrece las siguientes recomendaciones:

• Nuevos
  proyectosLos nuevos proyectos siempre deben intentar utilizar los componentes principales. Si los componentes principales no se pueden utilizar directamente o ampliados para satisfacer los requisitos del proyecto, cree un componente personalizado siguiendo la arquitectura de componentes establecida en los componentes principales. Salvo que no sea posible, evite utilizar los componentes de base.
• La recomendación
  Proyectos existentes se mantiene usando los componentes base, a menos que se planifique una refactorización de sitios o componentes.
  Como la mayoría de los proyectos existentes los utilizan muy ampliamente, los componentes de base seguirán siendo compatibles.
• Nuevos
  componentes personalizadosEvalúe si un componente principal existente se puede personalizar.
  Si no es así, se recomienda crear un nuevo componente personalizado siguiendo las Directrices de componentes.
• Componentes personalizados existentes
  Si los componentes funcionan según lo esperado, manténgalos tal cual.
  
  Si no es así, consulte "Nuevos componentes personalizados" más arriba.

Cómo realizar el éxito con los componentes principales

Los componentes principales son potentes, flexibles y fáciles de usar y personalizar. Seguir algunas directrices clave garantizará que el proyecto con los componentes principales sea un éxito.

Migración a los componentes principales

Cualquier nuevo proyecto debe implementarse con los componentes principales. Sin embargo, los proyectos existentes normalmente tendrán amplias implementaciones de los componentes de base.

Migración desde componentes de base

Un esfuerzo mayor en un proyecto existente (por ejemplo, un cambio de marca o una refactorización general) a menudo ofrece la oportunidad de migrar a los componentes principales. Para facilitar esta migración, el Adobe ha proporcionado una serie de herramientas de migración que fomentan la adopción de los componentes principales y de la tecnología de AEM más reciente.

Las AEM herramientas de modernización permiten la conversión sencilla de:

• Plantillas estáticas a plantillas editables.
• Diseño de las configuraciones para políticas.
• Componentes básicos a principales.
• De IU clásica a IU táctil.

Para obtener más información sobre el uso de estas herramientas, consulte su documentación.

Migración a través de Mover a AEM como Cloud Service

Como AEM como Cloud Service viene con la última versión de los componentes principales automáticamente, cuando se desplaza de una instalación de AEM local, deberá eliminar cualquier dependencia de los componentes principales del archivo pom.xml de proyectos.

Los componentes proxy seguirán funcionando como antes porque los proxies apuntan al supertipo necesario y la ruta de supertipo tiene la versión en él. De este modo, la simple eliminación de la dependencia permite que los componentes principales funcionen en AEMaaCS del mismo modo que lo hicieron en las instalaciones.

Al igual que cualquier otro proyecto de AEMaaCS, también deberá añadir una dependencia al jar del SDK de AEM. Esto no es específico de los componentes principales, pero es obligatorio.

<dependency>
   <groupId>com.adobe.aem</groupId>
   <artifactId>aem-sdk-api</artifactId>
</dependency>

Consulte el documento AEM Estructura del proyecto para obtener más información sobre los proyectos de AEMaaCS.

Compatibilidad con componentes principales

Los componentes principales son parte integral de AEM y se admiten tal cual bajo los mismos términos y condiciones en los que se admitirían si fueran parte del inicio rápido.

Al igual que otras funciones AEM producto, la regla general es: Los componentes se anuncian primero como obsoletos y los primeros se eliminan en la siguiente versión de AEM. Esto proporciona a los clientes al menos un ciclo de versiones para pasar a la nueva versión del componente antes de dejar de ofrecer asistencia.

La versión de cada componente señala claramente las versiones de AEM que admite. Cuando una versión de AEM deja de ser compatible, también lo deja de ser el componente principal de esa versión de AEM.

Para obtener más información sobre la compatibilidad de la personalización de componentes, consulte la página Personalización de componentes principales.

Capacidades técnicas

En la tabla siguiente se ofrece una descripción general de las diferencias entre los componentes principales y los componentes básicos.

Para obtener más información sobre sus capacidades de creación y las opciones para preconfigurarlas, consulte la página de creación sobre ellas.

Lista de componentes

En la tabla siguiente se enumeran los componentes principales disponibles, enlazándolos a su API, e indican los componentes de base que reemplazan.

Próximos componentes

Para obtener una descripción general de la próxima hoja de ruta del componente principal, consulte la wiki del proyecto en GitHub.

Actualización de los componentes principales

Una ventaja de los componentes con versiones es que permite separar la migración a una nueva versión AEM de la migración a las nuevas versiones de los componentes. Además, si hay nuevas versiones de componentes disponibles, permite la migración individual de cada componente a la nueva versión.

Las migraciones a una nueva versión de AEM no afectarán al funcionamiento de los componentes principales, siempre que sus versiones también admitan la nueva versión de AEM a la que se va a migrar. Las personalizaciones realizadas en los componentes principales tampoco deben verse afectadas, siempre que no utilicen API que hayan sido obsoletas o eliminadas.

Las migraciones a nuevas versiones de los componentes principales tampoco afectarán al funcionamiento del componente, pero podrían introducirse nuevas funciones a los autores de páginas, que podrían requerir cierta configuración por parte de un editor de plantillas, en caso de que no se desee el comportamiento predeterminado. Sin embargo, es posible que haya que adaptar las personalizaciones; para obtener más información, consulte la página Personalización de componentes principales .