Adobe Content Package Maven Plugin adobe-content-package-maven-plugin

Använd pluginen Adobe Content Package Maven för att integrera paketets driftsättnings- och hanteringsuppgifter i dina Maven-projekt.

Distributionen av de konstruerade paketen till AEM utförs av pluginmodulen för innehållspaketet för Adobe och möjliggör automatisering av uppgifter som normalt utförs med AEM Pakethanteraren:

I det här dokumentet beskrivs hur du använder Maven för att hantera dessa uppgifter. Men det är också viktigt att förstå hur AEM projekt och deras paket är strukturerade.

Paket och AEM projektstruktur aem-project-structure

AEM as a Cloud Service följer de senaste metoderna för pakethantering och projektstruktur som implementerats av den senaste AEM Project Archetype.

Hämta innehållspaketet Maven Plugin obtaining-the-content-package-maven-plugin

Plugin-programmet finns på Maven Central Repository.

Innehållspaket Maven Plugin - mål och parametrar

Om du vill använda plugin-programmet Content Package Maven lägger du till följande plugin-element i build-elementet i din POM-fil:

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

Om du vill att Maven ska kunna hämta plugin-programmet använder du profilen i Hämta innehållspaketet Maven Plugin på den här sidan.

Mål för Innehållspaketet Maven Plugin goals-of-the-content-package-maven-plugin

Mål- och målparametrarna som finns i innehållspaketets plugin-program beskrivs i följande avsnitt. Parametrar som beskrivs i avsnittet Vanliga parametrar kan användas för de flesta målen. Parametrar som gäller för ett mål beskrivs i avsnittet för det målet.

Plugin-prefix plugin-prefix

Plugin-prefixet är content-package. Använd det här prefixet för att köra ett mål från kommandoraden, som i följande exempel:

mvn content-package:build

Parameterprefix parameter-prefix

Om inget annat anges använder målen och parametrarna vault -prefix, som i följande exempel:

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

Proxies proxies

Mål där proxies används för AEM använder den första giltiga proxykonfigurationen som finns i inställningarna för Maven. Om ingen proxykonfiguration hittas används ingen proxy. Se useProxy -parametern i Gemensamma parametrar -avsnitt.

Gemensamma parametrar common-parameters

Parametrarna i följande tabell är gemensamma för alla mål utom när de anges i Mål kolumn.

bygg build

Skapar ett innehållspaket som redan har definierats på en AEM.

Parametrar parameters

Alla parametrar för byggmålet beskrivs i Gemensamma parametrar -avsnitt.

installera install

Installerar ett paket i databasen. För att detta mål ska kunna uppnås krävs inte något Maven-projekt. Målet är bundet till install Maven byggs livscykel.

Parametrar parameters-1

Förutom följande parametrar finns beskrivningarna i Gemensamma parametrar -avsnitt.

ls ls

Visar de paket som distribuerats till Pakethanteraren.

Parametrar parameters-2

Alla parametrar för ls-målet beskrivs i Gemensamma parametrar -avsnitt.

rm rm

Tar bort ett paket från Pakethanteraren.

Parametrar parameters-3

Alla parametrar för RM-målet beskrivs i Gemensamma parametrar -avsnitt.

avinstallera uninstall

Avinstallerar ett paket. Paketet finns kvar på servern i avinstallerat läge.

Parametrar parameters-4

Alla parametrar för avinstallationsmålet beskrivs i Gemensamma parametrar -avsnitt.

package package

Skapar ett innehållspaket. Standardkonfigurationen för paketmålet omfattar innehållet i katalogen där kompilerade filer sparas. Körningen av paketmålet kräver att kompileringsfasen har slutförts. Paketmålet är bundet till paketfasen av bygglivscykeln för Maven.

Parametrar parameters-5

Förutom följande parametrar finns mer information i beskrivningen av name -parametern i Gemensamma parametrar -avsnitt.

Använda filter using-filters

Använd elementet filters för att definiera paketinnehållet. Filtren läggs till i workspaceFilter -elementet i META-INF/vault/filter.xml paketets fil.

I följande filterexempel visas XML-strukturen som ska användas:

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

Importläge import-mode

The mode -elementet definierar hur innehåll i databasen påverkas när paketet importeras. Följande värden kan användas:

När filtret inte innehåller mode element, standardvärdet för replace används.

help help

Parametrar parameters-6

Inkludera en miniatyrbild eller egenskapsfil i paketet including-a-thumbnail-image-or-properties-file-in-the-package

Ersätt standardpaketkonfigurationsfilerna för att anpassa paketegenskaperna. Ta till exempel med en miniatyrbild för att skilja på paketet i Pakethanteraren.

Källfilerna kan finnas var som helst i filsystemet. I POM-filen definierar du byggresurser som kopierar källfilerna till target/vault-work/META-INF för införande i förpackningen.

Följande POM-kod lägger till filerna i META-INF projektkällans mapp till paketet:

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

Följande POM-kod lägger bara till en miniatyrbild i paketet. Miniatyrbilden måste ha ett namn thumbnail.pngoch måste finnas i META-INF/vault/definition paketets mapp. I det här exemplet finns källfilen i /src/main/content/META-INF/vault/definition projektmapp:

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

Använda den AEM projekttypen för att generera AEM projekt using-archetypes

Den senaste AEM Project Archetype implementerar paketstrukturen med bästa praxis för både lokala implementeringar och AMS-implementeringar och rekommenderas för alla AEM projekt.