Insteekmodule Adobe-inhoudspakket adobe-content-package-maven-plugin

Met de plug-in Adobe Content Package Maven kunt u taken voor pakketimplementatie en -beheer integreren in uw Maven-projecten.

De plaatsing van de geconstrueerde pakketten aan AEM wordt uitgevoerd door de Insteekmodule van het Pakket van de Inhoud van de Adobe Maven en laat de automatisering van taken toe normaal die gebruikend AEM worden uitgevoerd Pakketbeheer:

In dit document wordt beschreven hoe u deze taken beheert met de Maven. Het is echter ook van belang om te begrijpen hoe AEM projecten en hun pakketten gestructureerd zijn .

Pakketten en de AEM projectstructuur aem-project-structure

AEM as a Cloud Service houdt zich aan de recentste beste praktijken voor pakketbeheer en projectstructuur zoals uitgevoerd door het recentste Archetype van AEM Project.

De insteekmodule voor het inhoudspakket verkrijgen obtaining-the-content-package-maven-plugin

De insteekmodule is beschikbaar via de Centrale gegevensopslagruimte.

Doelstellingen en parameters van insteekmodule voor inhoudspakket

Als u de insteekmodule Inhoudspakket met Maven wilt gebruiken, voegt u het volgende insteekmodule toe in het element build van het POM-bestand:

<plugin>
 <groupId>com.day.jcr.vault</groupId>
 <artifactId>content-package-maven-plugin</artifactId>
 <version>1.0.4</version>
 <configuration>
       <!-- parameters and values common to all goals, as required -->
 </configuration>
</plugin>

Gebruik het profiel in het dialoogvenster De insteekmodule voor het inhoudspakket verkrijgen op deze pagina.

Doelstellingen van de plug-in Inhoudspakket goals-of-the-content-package-maven-plugin

De doelstellingen en doelparameters die de insteekmodule van het Pakket van de Inhoud verstrekt worden beschreven in de secties die volgen. De parameters die in de Gemeenschappelijke sectie van Parameters worden beschreven kunnen voor de meeste doelstellingen worden gebruikt. De parameters die op één doel van toepassing zijn worden beschreven in de sectie voor dat doel.

Plug-voorvoegsel plugin-prefix

Het voorvoegsel van de plug-in is content-package. Gebruik dit voorvoegsel om een doel uit te voeren vanaf de opdrachtregel, zoals in het volgende voorbeeld:

mvn content-package:build

Parametervoorvoegsel parameter-prefix

Tenzij anders vermeld, gebruiken de doelstellingen en de parameters van de plug-in vault voorvoegsel, zoals in het volgende voorbeeld:

mvn content-package:install -Dvault.targetURL="https://192.168.1.100:4502/crx/packmgr/service.jsp"

Proxy proxies

De doelstellingen die volmachten voor AEM gebruiken de eerste geldige volmachtsconfiguratie die in de GeMaven montages wordt gevonden. Als geen volmachtsconfiguratie wordt gevonden, wordt geen volmacht gebruikt. Zie de useProxy in de Algemene parameters sectie.

Algemene parameters common-parameters

De parameters in de volgende tabel zijn gemeenschappelijk voor alle doelstellingen, behalve wanneer ze in de Doelen kolom.

build build

Bouwt een inhoudspakket dat reeds op een AEM instantie wordt bepaald.

Parameters parameters

Alle parameters voor het bouwstijldoel worden beschreven in Algemene parameters sectie.

installeren install

Hiermee installeert u een pakket in de opslagplaats. Voor de verwezenlijking van dit doel is geen Maven-project vereist. Het doel is gebonden aan de install fase van de levenscyclus van de Maven-build.

Parameters parameters-1

Naast de volgende parameters, zie de beschrijvingen in Algemene parameters sectie.

ls ls

Maakt een lijst van de pakketten die worden opgesteld aan Pakketbeheer.

Parameters parameters-2

Alle parameters van het doel ls worden beschreven in Algemene parameters sectie.

rm rm

Een pakket verwijderen uit Pakketbeheer.

Parameters parameters-3

Alle parameters van het rm-doel worden beschreven in de Algemene parameters sectie.

verwijderen uninstall

Hiermee wordt een pakket verwijderd. Het pakket blijft op de server staan in de toestand Niet-geïnstalleerd.

Parameters parameters-4

Alle parameters van het doel voor verwijderen worden beschreven in het dialoogvenster Algemene parameters sectie.

package package

Maakt een inhoudspakket. De standaardconfiguratie van het pakketdoel omvat de inhoud van de folder waar de gecompileerde dossiers worden bewaard. De uitvoering van het pakketdoel vereist dat de compilatiefase is voltooid. Het pakketdoel is gebonden aan de pakketfase van de Maven-levenscyclus.

Parameters parameters-5

Naast de volgende parameters, zie de beschrijving van name in de Algemene parameters sectie.

Filters gebruiken using-filters

Gebruik het element filters om de pakketinhoud te definiëren. De filters worden toegevoegd aan de workspaceFilter in het META-INF/vault/filter.xml bestand van het pakket.

In het volgende filtervoorbeeld wordt de XML-structuur getoond die moet worden gebruikt:

<filter>
   <root>/apps/myapp</root>
   <mode>merge</mode>
       <includes>
              <include>/apps/myapp/install/</include>
              <include>/apps/myapp/components</include>
       </includes>
       <excludes>
              <exclude>/apps/myapp/config/*</exclude>
       </excludes>
</filter>

Importmodus import-mode

De mode element definieert hoe inhoud wordt beïnvloed door de repository wanneer het pakket wordt geïmporteerd. De volgende waarden kunnen worden gebruikt:

Wanneer het filter geen mode -element, de standaardwaarde van replace wordt gebruikt.

help help

Parameters parameters-6

Een miniatuurafbeelding of eigenschappenbestand opnemen in het pakket including-a-thumbnail-image-or-properties-file-in-the-package

Vervang de standaardpakketconfiguratiebestanden om de pakketeigenschappen aan te passen. Neem bijvoorbeeld een miniatuurafbeelding om het pakket te onderscheiden in Pakketbeheer.

U kunt de bronbestanden overal in uw bestandssysteem vinden. Definieer in het POM-bestand build-bronnen om de bronbestanden naar de target/vault-work/META-INF voor opname in het pakket.

De volgende POM-code voegt de bestanden toe aan de META-INF map van de projectbron naar het pakket:

<build>
    <resources>
        <!-- vault META-INF resources (thumbnail and so on) -->
        <resource>
            <directory>${basedir}/src/main/content/META-INF</directory>
            <targetPath>../vault-work/META-INF</targetPath>
        </resource>
    </resources>
</build>

Met de volgende POM-code wordt alleen een miniatuurafbeelding aan het pakket toegevoegd. De miniatuurafbeelding moet een naam hebben thumbnail.pngen moet zich in de META-INF/vault/definition van het pakket. In dit voorbeeld bevindt het bronbestand zich in het dialoogvenster /src/main/content/META-INF/vault/definition map van het project:

<build>
    <resources>
        <!-- thumbnail only -->
        <resource>
            <directory>${basedir}/src/main/content/META-INF/vault/definition</directory>
            <targetPath>../vault-work/META-INF/vault/definition</targetPath>
        </resource>
    </resources>
</build>

Het gebruiken van het AEM Archetype van het Project om AEM Projecten te produceren using-archetypes

De nieuwste AEM Project Archetype implementeert de pakketstructuur met best practices voor zowel de implementatie op locatie als in AMS en wordt aanbevolen voor alle AEM projecten.