Atualizações sustentáveis sustainable-upgrades
Estrutura de personalização customization-framework
Arquitetura (funcional/infraestrutura/conteúdo/aplicativo) architecture-functional-infrastructure-content-application
A estrutura de personalização foi criada para ajudar a reduzir as violações em áreas não extensíveis do código (como APIS) ou conteúdo (como sobreposições) que não são amigáveis à atualização.
Há dois componentes da estrutura de personalização: o Superfície da API e Classificação do conteúdo.
Superfície da API api-surface
Em versões anteriores do AEM, muitas APIs foram expostas por meio do Uber Jar. Algumas dessas APIs não eram destinadas a serem usadas pelos clientes, mas foram expostas ao suporte AEM funcionalidade em pacotes. Além disso, as APIs do Java serão marcadas como Públicas ou Privadas para indicar aos clientes quais APIs são seguras para usar no contexto de atualizações. Outras especificações incluem:
-
APIs Java marcadas como
Publicpodem ser usadas e referenciadas por pacotes de implementação personalizados. -
As APIs públicas serão compatíveis com a instalação de um pacote de compatibilidade.
-
O pacote de compatibilidade conterá um Uber JAR de compatibilidade para garantir compatibilidade com versões anteriores
-
APIs Java marcadas como
Privatesão destinados apenas a serem usados por pacotes internos AEM e não devem ser usados por pacotes personalizados.
Private e Public neste contexto, não deve ser confundido com noções Java de classes públicas e privadas.
Classificações de conteúdo content-classifications
AEM há muito tempo usa o principal de sobreposições e Sling Resource Merger para permitir que os clientes estendam e personalizem AEM funcionalidade. Funcionalidade predefinida que alimenta os consoles de AEM e a interface do usuário são armazenadas em /libs. Os clientes nunca devem modificar nada abaixo /libs mas pode adicionar conteúdo adicional abaixo de /apps para sobrepor e estender a funcionalidade definida em /libs (Consulte Desenvolvimento com sobreposições para obter mais informações). Isso ainda causou vários problemas ao atualizar AEM como o conteúdo em /libs pode mudar, fazendo com que a funcionalidade de sobreposição se quebre de maneiras inesperadas. Os clientes também podem estender AEM componentes por meio da herança via sling:resourceSuperTypeou simplesmente faça referência a um componente em /libs diretamente via sling:resourceType. Problemas de atualização semelhantes podem ocorrer com casos de uso de referência e substituição.
Para tornar mais seguro e fácil para os clientes compreender quais as áreas de /libs são seguras para usar e sobrepor o conteúdo em /libs foi classificada com as seguintes misturas:
-
Público (granite:PublicArea) - Define um nó como público, para que possa ser sobreposto, herdado (
sling:resourceSuperType) ou usados diretamente (sling:resourceType). Os nós abaixo de /libs marcados como Público serão seguros para atualizar com a adição de um Pacote de Compatibilidade. Em geral, os clientes do devem utilizar apenas os nós marcados como Públicos. -
Abstrato (granite:AbstractArea) - Define um nó como abstrato. Os nós podem ser sobrepostos ou herdados (
sling:resourceSupertype), mas não deve ser usado diretamente (sling:resourceType). -
Final (granite:FinalArea) - Define um nó como final. Os nós classificados como finais não podem ser sobrepostos ou herdados. Os nós finais podem ser usados diretamente por meio de
sling:resourceType. Os subnós no nó final são considerados internos por padrão -
Interno (granite:InternalArea) - Define um nó como interno. Os nós classificados como internos não podem ser sobrepostos, herdados ou usados diretamente. Esses nós são destinados apenas à funcionalidade interna de AEM
-
Sem anotação - Os nós herdam a classificação com base na hierarquia da árvore. A raiz / é, por padrão, Pública. Os nós com um pai classificado como Interno ou Final também devem ser tratados como Interno.
Internal, mas ainda pode ser usado com a inclusão padrão clientlib. É importante que um cliente continue a respeitar a Classificação interna nesses casos.Indicadores de tipo de conteúdo de CRXDE Lite crxde-lite-content-type-indicators
As misturas aplicadas no CRXDE Lite mostrarão nós de conteúdo e árvores marcadas como INTERNAL como sendo esmaecidos. Para FINAL somente o ícone fica acinzentado. Os filhos desses nós também aparecerão cinza. A funcionalidade Sobrepor nó está desativada em ambos os casos.
Público
Final
Interno
Verificação de integridade do conteúdo
O AEM 6.4 será enviado com uma verificação de integridade para alertar os clientes se o conteúdo sobreposto ou referenciado for usado de uma maneira inconsistente com a classificação do conteúdo.
O Verificação de acesso ao conteúdo do Sling/Granite é uma nova verificação de integridade que monitora o repositório para ver se o código do cliente está acessando nós protegidos incorretamente no AEM.
Isso verificará /apps e normalmente leva vários segundos para ser concluída.
Para acessar essa nova verificação de integridade, você precisa fazer o seguinte:
-
Na tela inicial do AEM, navegue até Ferramentas > Operações > Relatórios de integridade
-
Clique no botão Verificação de acesso ao conteúdo do Sling/Granite conforme mostrado abaixo:
Após a conclusão da verificação, uma lista de avisos será exibida, notificando um usuário final do nó protegido que está sendo referenciado incorretamente:
Depois de corrigir as violações, ele retornará ao estado verde:
A verificação de integridade exibe informações coletadas por um serviço em segundo plano que verifica de forma assíncrona sempre que uma sobreposição ou tipo de recurso é usado em todos os caminhos de pesquisa do Sling. Se as combinações de conteúdo forem usadas incorretamente, isso relata uma violação.