Plug-in Maven do pacote de conteúdo do Adobe adobe-content-package-maven-plugin

Use o plug-in Maven do pacote de conteúdo do Adobe para integrar tarefas de implantação e gerenciamento de pacotes em seus projetos Maven.

A implantação dos pacotes construídos no AEM é realizada pelo plug-in Maven do Pacote de conteúdo do Adobe e permite a automação das tarefas normalmente realizadas usando o Gerenciador de pacotes do AEM

Este documento detalha como usar o Maven para gerenciar essas tarefas. No entanto, também é importante entender como os projetos da AEM e seus pacotes estão estruturados.

Pacotes e a estrutura do projeto AEM aem-project-structure

A AEM as a Cloud Service segue as práticas recomendadas mais recentes para o gerenciamento de pacotes e a estrutura do projeto, conforme implementado pelo Arquétipo de projeto mais recente da AEM.

Obter o plug-in Maven do pacote de conteúdo obtaining-the-content-package-maven-plugin

O plug-in está disponível no Repositório Central Maven.

Metas e parâmetros do plug-in Maven do pacote de conteúdo

Para usar o Plug-in Maven do pacote de conteúdo, adicione o seguinte elemento de plug-in dentro do elemento de build do seu arquivo POM:

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

Para permitir que o Maven baixe o plug-in, use o perfil fornecido na seção Obtendo o plug-in Maven do pacote de conteúdo nesta página.

Metas do plug-in Maven do pacote de conteúdo goals-of-the-content-package-maven-plugin

As metas e os parâmetros de meta fornecidos pelo plug-in do Pacote de conteúdo são descritos nas seções a seguir. Os parâmetros descritos na seção Parâmetros Comuns podem ser usados para a maioria das metas. Os parâmetros que se aplicam a uma meta são descritos na seção para essa meta.

Prefixo do plug-in plugin-prefix

O prefixo do plug-in é content-package. Use esse prefixo para executar uma meta a partir da linha de comando, como no exemplo a seguir:

mvn content-package:build

Prefixo do parâmetro parameter-prefix

A menos que seja observado o contrário, as metas e os parâmetros do plug-in usam o prefixo vault, como no exemplo a seguir:

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

Proxies proxies

Metas que usam proxies para o AEM usam a primeira configuração de proxy válida encontrada nas configurações Maven. Se nenhuma configuração de proxy for encontrada, nenhum proxy será usado. Consulte o parâmetro useProxy na seção Parâmetros Comuns.

Parâmetros comuns common-parameters

Os parâmetros na tabela a seguir são comuns a todas as metas, exceto quando anotados na coluna Metas.

build build

Cria um pacote de conteúdo que já está definido em uma instância do AEM.

Parâmetros parameters

Todos os parâmetros da meta de compilação estão descritos na seção Parâmetros Comuns.

instalar install

Instala um pacote no repositório. A execução dessa meta não requer um projeto Maven. A meta está vinculada à fase install do ciclo de vida da compilação Maven.

Parâmetros parameters-1

Além dos parâmetros a seguir, consulte as descrições na seção Parâmetros Comuns.

ls ls

Lista os pacotes implantados no Gerenciador de Pacotes.

Parâmetros parameters-2

Todos os parâmetros da meta ls estão descritos na seção Parâmetros Comuns.

rm rm

Remove um pacote do Gerenciador de Pacotes.

Parâmetros parameters-3

Todos os parâmetros da meta rm estão descritos na seção Parâmetros Comuns.

desinstalar uninstall

Desinstala um pacote. O pacote permanece no servidor no estado desinstalado.

Parâmetros parameters-4

Todos os parâmetros da meta de desinstalação estão descritos na seção Parâmetros Comuns.

ajuda help

Parâmetros parameters-6

Inclusão de uma imagem em miniatura ou arquivo de propriedades no pacote including-a-thumbnail-image-or-properties-file-in-the-package

Substitua os arquivos de configuração de pacote padrão para personalizar as propriedades do pacote. Por exemplo, inclua uma imagem em miniatura para distinguir o pacote no Gerenciador de Pacotes.

Os arquivos de origem podem estar localizados em qualquer lugar do sistema de arquivos. No arquivo POM, defina os recursos de compilação para copiar os arquivos de origem no target/vault-work/META-INF para inclusão no pacote.

O código POM a seguir adiciona os arquivos da pasta META-INF da origem do projeto ao pacote:

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

O código POM a seguir adiciona apenas uma imagem em miniatura ao pacote. A imagem em miniatura deve se chamar thumbnail.png e deve estar localizada na pasta META-INF/vault/definition do pacote. Neste exemplo, o arquivo de origem está localizado na pasta /src/main/content/META-INF/vault/definition do projeto:

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

Uso do Arquétipo de Projetos AEM para Gerar Projetos AEM using-archetypes

O Arquétipo de projeto do AEM mais recente implementa a estrutura do pacote de práticas recomendadas para implementações locais e do AMS e é recomendado para todos os projetos do AEM.