Plug-in Maven Build Analyzer do SDK do AEM as a Cloud Service maven-analyzer-plugin

Módulo

Função, exemplo e solução de problemas

SDK local

Cloud Manager

Verifica se todos os pacotes OSGI têm suas declarações de pacote de importação satisfeitas pela declaração de pacote de exportação de outros pacotes incluídos no projeto do Maven. Um erro seria semelhante a:

[ERROR] org.acme:mybundle:0.0.1-SNAPSHOT: Bundle org.acme:mybundle:0.0.1-SNAPSHOT is importing package(s) org.acme.foo in start level 20 but no bundle is exporting these for that start level.

Para solucionar problemas, consulte se o pacote está incluído na implantação ou, como alternativa, verifique o manifesto do pacote que você espera exportar para determinar se o nome errado ou a versão incorreta foi usada.

Sim

Sim

Verifica se os pacotes OSGi especificam uma versão com uma declaração de Pacote de exportação e um intervalo de versões com uma declaração de Pacote de importação. Um erro seria semelhante a:

[ERROR] org.acme:mybundle:0.0.1-SNAPSHOT: Bundle org.acme:mybundle:0.0.1-SNAPSHOT is exporting package org.acme.foo without a version.

Para solucionar problemas, adicione um package-info.java a esse pacote especificando a versão a ser exportada.

Sim

Sim

Verifica se todas as declarações de requisitos feitas em pacotes OSGI são satisfeitas pelas declarações de capacidades de outros pacotes incluídos no projeto do Maven. Um erro seria semelhante a:

[ERROR] org.acme:mybundle:0.0.1-SNAPSHOT: Artifact org.acme:mybundle:0.0.1-SNAPSHOT requires org.foo.bar in start level 20 but no artifact is providing a matching capability in this start level.

Para solucionar problemas, verifique o manifesto do pacote que você esperaria declarar um recurso para determinar por que ele está ausente, ou verifique no manifesto do pacote que exige para ver se o requisito está correto.

Sim

Sim

Fornece um aviso se um pacote contiver conteúdo inicial especificado com Sling-Initial-Content, o que é problemático no ambiente clusterizado do AEM as a Cloud Service. O aviso tem esta aparência:

[WARNING] org.acme:mybundle:0.0.1-SNAPSHOT: Found initial content : [/]

Para solucionar problemas de conversão do conteúdo inicial em instruções de repoinit, consulte a Documentação de Repoinit.

Sim

Sim

Fornece um aviso se um pacote contiver recursos especificados com o cabeçalho Sling-Bundle-Resources, o que é problemático no ambiente clusterizados do AEM as a Cloud Service. O aviso tem esta aparência:

[WARNING] org.acme:mybundle:0.0.1-SNAPSHOT: Found bundle resources : [/libs/sling/explorer!/resources/explorer]

Para solucionar problemas de conversão de recursos em instruções de repoinit, consulte a Documentação de Repoinit.

Sim

Sim

api-regions

api-regions-check-order

api-regions-dependencies

api-regions-duplicates

Esses analisadores verificam alguns detalhes relacionados ao pacote de conteúdo para o processo de conversão do modelo de recurso que cria artefatos em conformidade com o Modelo de recurso do Sling. Quaisquer erros devem ser relatados ao Suporte ao cliente da Adobe.

Sim

Sim

Valida que os pacotes OSGi do cliente não têm declarações de pacote de exportação que substitui a API pública do AEM as a Cloud Service

[WARNING] org.acme:mybundle:0.0.1-SNAPSHOT: Package overlap found between region global and bundle org.acme:mybundle:0.0.1.SNAPSHOT which comes from feature: [org.acme:myproject.analyse:slingosgifeature:0.0.1-SNAPSHOT]. Both export package: com.day.util

Para corrigir, pare de exportar um pacote que faz parte da API pública do AEM.

Sim

Sim

Verifica a sintaxe de todas as seções de repoinit.

Sim

Sim

Valida que os pacotes OSGi não instalam o código nativo.

Sim

Sim

Valida configurações OSGi importantes.

Configuration org.apache.felix.webconsole.internal.servlet.OsgiManager: Configuration is not allowed (com.mysite:mysite.all:1.0.0-SNAPSHOT|com.mysite:mysite.ui.config:1.0.0-SNAPSHOT)

Sim

Sim

Verifica se API obsoleta é usada

[WARNING] com.mysite:mysite.core:1.0.0-SNAPSHOT: Usage of deprecated package found : org.apache.sling.settings : Avoid these features at runtime: run modes, file system access (com.mysite:mysite.all:1.0.0-SNAPSHOT)

Sim

Sim

Valida dependências como pacotes de conteúdo para evitar problemas conhecidos em artefatos.

[WARNING] [artifact-rules] com.adobe.acs:acs-aem-commons-bundle:5.0.4: Use at least version 5.0.10 (com.mysite:mysite.all:1.0.0-SNAPSHOT)

Sim

Sim

Verifica o uso de variáveis de ambiente de acordo com o guia de nomenclatura da variável

[ERROR] Configuration org.apache.felix.webconsole.internal.servlet.OsgiManager: Value for property 'port' must not use env vars prefixed with INTERNAL_ or ADOBE_ (com.mysite1:my-site-1.all:1.0.0-SNAPSHOT|com.mysite1:my-site-1.ui.config:1.0.0-SNAPSHOT)

Sim

Sim

Executa validadores de cofre de arquivos. Por padrão, jackrabbit-docviewparser está habilitado, o que verifica a sintaxe de conteúdo bem formada de xml dentro de pacotes que serão instalados durante a implantação.

[main] WARN org.apache.sling.feature.analyser.task.impl.CheckContentPackages - ValidationViolation: "jackrabbit-docviewparser: Invalid XML found: The reference to entity "se" must end with the ';' delimiter.", filePath=jcr_root/apps/somename/configs/com.adobe.test.Invalid.xml, nodePath=/apps/somename/configs/com.adobe.test.Invalid

Para corrigir, verifique se há problemas de xml no arquivo nomeado pelo analisador.

Sim

Sim