Insteekmodule AEM as a Cloud Service SDK Build Analyzer Maven maven-analyzer-plugin

De AEM as a Cloud Service SDK Build Analyzer Maven Plugin analyseert de structuur van de diverse projecten van inhoudspakketten.

Zie de Gemaakt documentatie van de Insteekmodulevoor informatie over hoe te om het in een AEM in kaart gebracht project te omvatten.

NOTE
Het wordt geadviseerd dat u uw Gemaakt project bijwerkt om de recentste versie van de stop van verwijzingen te voorzien die in de Gemaakt centrale bewaarplaats wordt gevonden.

De insteekmodule gebruikt de nieuwste beschikbare SDK in plaats van de SDK die in het project is geconfigureerd.

Hieronder ziet u een tabel met een beschrijving van de analyseapparaten die als onderdeel van deze stap worden uitgevoerd.

Module
Functie, voorbeeld en probleemoplossing
Lokale SDK
Cloud Manager
api-regions-exportsimports

Controleert of alle OSGi-bundels hun Import-Package-declaraties hebben voldaan aan de Export-package-declaratie van andere meegeleverde bundels in het Maven-project. Een fout ziet er als volgt uit:

[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.

Om problemen op te lossen, zie of is de bundel die het pakket verstrekt inbegrepen in de plaatsing, of anders bekijk manifest van de bundel die u zou verwachten om te bepalen als de verkeerde naam of de verkeerde versie werd gebruikt.

Ja
Ja
bundle-unversioned-packages

Controleert of OSGi-bundels een versie met een uitvoer-Pakket verklaring en een versiewaaier met een invoer-Pakket verklaring specificeren. Een fout ziet er als volgt uit:

[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.

Als u problemen wilt oplossen, moet u een package-info.java aan dat pakket toevoegen met de versie die u wilt exporteren.

Ja
Ja
requirements-capabilities

Controleert of aan alle eisen die in OSGi-bundels worden gesteld, wordt voldaan door de capaciteitsdeclaraties van andere bundels die in het Maven-project zijn opgenomen. Een fout ziet er als volgt uit:

[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.

Om problemen op te lossen, bekijk manifest van de bundel die u een vermogen zou verwachten te verklaren om te bepalen waarom het ontbreekt, of controleer manifest van de verplichte bundel om te zien dat het vereiste in daar correct is.

Ja
Ja
bundle-content

Geeft een waarschuwing als een bundel initiële inhoud bevat die is opgegeven met Sling-Initial-Content, wat problematisch is in de geclusterde AEM as a Cloud Service-omgeving. De waarschuwing ziet er als volgt uit:

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

Zie Documentatie opnieuw aanwijzen als u problemen wilt oplossen bij het omzetten van de eerste inhoud in instructies voor het opnieuw aanwijzen.

Ja
Ja
bundle-resources

Hiermee wordt een waarschuwing gegeven als een bundel bronnen bevat die zijn opgegeven met de header Sling-Bundle-Resources. Dit is problematisch in de geclusterde AEM as a Cloud Service-omgeving. De waarschuwing ziet er als volgt uit:

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

Om de middelen problemen op te lossen om verklaringen te richten, zie Documentatie opnieuw richten.

Ja
Ja

api-regions

api-regions-check-order

api-regions-dependencies

api-regions-duplicates

Deze analysatoren controleren sommige details met betrekking tot het inhoudspakket aan het proces van de eigenschapmodelomzettingdat artefacten creeert die aan het Verschuivende Model van de Eigenschap in overeenstemming zijn. Eventuele fouten moeten worden gemeld aan de Adobe Klantenondersteuning.
Ja
Ja
api-regions-crossfeature-dups

Valideert dat de klant OSGi-bundels geen uitvoer-pakketverklaringen hebben die AEM as a Cloud Service openbare API met voeten treden

[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

U kunt een pakket dat deel uitmaakt van de openbare API van de AEM niet meer exporteren.

Ja
Ja
repoinit
Controleert de syntaxis van alle opnieuw aanwijssecties
Ja
Ja
bundle-nativecode
Valideert dat OSGi-bundels geen native code installeren.
Ja
Ja
configuration-api

Valideert belangrijke OSGi-configuraties.

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)

Ja
Ja
region-deprecated-api

Controleert als afgekeurde apiwordt gebruikt

[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)

Ja
Ja
artifact-rules

Valideert afhankelijkheden zoals bundels en inhoudspakketten om bekende problemen in artefacten te voorkomen.

[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)

Ja
Ja
aem-env-var

Controleert het gebruik van env vars volgens de veranderlijke noemende gids

[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)

Ja
Ja
content-package-validation

Hiermee worden validators voor bestanden uitgevoerd. Door gebrek wordt jakobbit-docviewparser toegelaten die op goed gevormde inhoudssyntaxis van xml binnenpakketten controleert die tijdens plaatsing zullen worden geïnstalleerd.

[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

Als u dit wilt corrigeren, controleert u het bestand dat door de analysator is benoemd op XML-problemen.

Ja
Ja

Bekende problemen

Hieronder ziet u een lijst met bekende problemen wanneer u de plug-in Analysator maken gebruikt.

Kan de plug-in Build Analyzer Maven niet uitvoeren in lokale SDK

Als u de lokale SDK gebruikt met een lagere versie van de plug-in voor analyse van build dan 1.1.2 , kan het uitvoeren van de plug-in leiden tot de onderstaande fout. In dit geval werkt u uw project bij naar de meest recente versie van de plug-in.

[ERROR] Failed to execute goal com.adobe.aem:aemanalyser-maven-plugin:1.1.0:analyse (default-analyse) on project mysite.analyse: Execution default-analyse of goal com.adobe.aem:aemanalyser-maven-plugin:1.1.0:analyse failed: arraycopy: source index -1 out of bounds for char[65536] -> [Help 1]

Als u het AEM Projectarchetype hebt gebruikt om uw project in te stellen, moet u de eigenschap in de hoofdmap Maven pom.xml aanpassen, zoals hieronder.

   ...
   <properties>
      ...
      <aemanalyser.version>1.1.2</aemanalyser.version> <!-- Make sure to use the latest release -->
      ...
   </properties>
recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c