La instalación del paquete falla en entornos AEM
La instalación del paquete AEM falla cuando los paquetes incluyen rutas inmutables, estructura ZIP no válida, enlaces de instalación o versiones de SDK afectadas. Diagnostique el error de instalación y siga los pasos de resolución adecuados para instalar el paquete correctamente.
Descripción description
Entorno
- Adobe Experience Manager as a Cloud Service
- AEM Managed Services
- App Builder de Adobe Developer
Problema/Síntomas
- Error durante la carga que indica que el archivo no es un paquete de contenido válido porque falta jcr_root.
- Errores de validación de paquetes durante la instalación.
- Instalación bloqueada porque el paquete contiene rutas de repositorio inmutables.
- Los paquetes incrustados dentro de un paquete all no se instalan automáticamente.
- Errores en la descarga de paquetes provocados por nombres de paquetes no válidos.
- Errores de instalación relacionados con las clases de gancho de instalación que faltan.
Causa
Los errores de instalación se producen cuando la estructura del paquete no es válida, el paquete incluye rutas de repositorio inmutables, los nombres de paquete contienen caracteres no admitidos, los enlaces de instalación se utilizan cuando no son compatibles o la implementación depende de una versión de SDK afectada por una regresión.
Resolución resolution
Para resolver este problema, siga estos pasos:
- Identifique el error de instalación revisando el mensaje o los registros del Administrador de paquetes.
- Si el paquete no se reconoce como paquete de contenido, compruebe que
META-INFyjcr_rootexistan en el nivel superior del archivo ZIP. Vuelva a crear el paquete si es necesario. - Si el paquete contiene rutas de repositorio inmutables, implemente el código a través de la canalización de implementación adecuada en lugar de instalarlo directamente a través del Administrador de paquetes.
- Si los paquetes incrustados no se instalan automáticamente, compruebe la versión de SDK y actualice a una versión de SDK que incluya la corrección de regresión.
- Quite los enlaces de instalación cuando implemente en entornos que no los admitan. Para entornos compatibles, asegúrese de que estén instaladas todas las dependencias requeridas.
- Actualice los nombres de los paquetes para eliminar los caracteres no admitidos y vuelva a compilar el paquete antes de implementarlo de nuevo.
- Valide la instalación confirmando que ya no aparecen errores de instalación y que los paquetes incrustados se instalan correctamente cuando corresponde.
Lectura relacionada
recommendation-more-help
experience-cloud-kcs-help-kbarticles