Adobe内容包Maven插件

使用Adobe内容包Maven插件将包部署和管理任务集成到Maven项目中。

将构建的包部署到AEM由Adobe内容包Maven插件执行，并允许自动执行通常使用AEM执行的任务 包管理器：

• 从文件系统中的文件创建新包。
• 在AEM上安装并卸载包。
• 构建已在AEM上定义的包。
• 获取AEM上安装的软件包列表。
• 从AEM中删除包。

本文档详细介绍如何使用Maven管理这些任务。 但是，了解以下内容也很重要 如何构建AEM项目及其包。

包和AEM项目结构

AEMas a Cloud Service遵循由最新的AEM项目原型实现的包管理和项目结构的最新最佳实践。

获取内容包Maven插件

插件可从以下位置获取： Maven中央存储库。

内容包Maven插件目标和参数

要使用内容包Maven插件，请在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>

要使Maven能够下载插件，请使用 获取内容包Maven插件 部分。

内容包Maven插件的目标

内容包插件提供的目标和目标参数在以下部分中进行了描述。 “常用参数”部分中描述的参数可用于大多数目标。 适用于某个目标的参数在该目标的部分中进行了描述。

插件前缀

插件前缀为 content-package. 使用该前缀可从命令行执行目标，如以下示例所示：

mvn content-package:build

参数前缀

除非另有说明，否则插件目标和参数会使用 vault 前缀，如以下示例所示：

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

代理

使用代理进行AEM的目标使用在Maven设置中找到的第一个有效代理配置。 如果未找到代理配置，则不使用代理。 请参阅 useProxy 中的参数 常用参数 部分。

常用参数

下表中的参数对所有目标都是通用的，除非在 目标 列。

生成

构建已在AEM实例上定义的内容包。

参数

有关构建目标的所有参数的说明，请参见 常用参数 部分。

安装

在存储库中安装包。 执行此目标不需要Maven项目。 目标已绑定到 install Maven构建生命周期的阶段。

参数

除了以下参数外，请参阅 常用参数 部分。

ls

列出部署到的包 包管理器.

参数

有关ls目标的所有参数的说明，请参见 常用参数 部分。

rm

从删除包 包管理器.

参数

rm目标的所有参数都在 常用参数 部分。

卸载

卸载包。 软件包在服务器上保持未安装状态。

参数

有关卸载目标的所有参数的说明，请参见 常用参数 部分。

包

创建内容包。 程序包目标的默认配置包括保存编译文件的目录的内容。 程序包目标的执行要求编译构建阶段已完成。 包目标绑定到Maven构建生命周期的包阶段。

参数

除了以下参数外，请参阅 name 中的参数 常用参数 部分。

使用过滤器

使用filters元素定义资源包内容。 这些筛选器将添加到 workspaceFilter 中的元素 META-INF/vault/filter.xml 包的文件。

以下过滤器示例显示了要使用的XML结构：

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

导入模式

此 mode 元素定义在导入包时，内容对存储库有何影响。 可以使用以下值：

• 合并： 将添加存储库中尚未包含的包内容。 包和存储库中的内容保持不变。 不会从存储库中删除任何内容。
• 替换： 包中不在存储库中的内容将添加到存储库中。 存储库中的内容替换为包中的匹配内容。 当内容在包中不存在时，将从存储库中删除该内容。
• 更新： 包中不在存储库中的内容将添加到存储库中。 存储库中的内容替换为包中的匹配内容。

当过滤器不包含时 mode 元素，默认值 replace 已使用。

帮助

参数

在包中包含缩略图图像或属性文件

替换默认软件包配置文件以自定义软件包属性。 例如，包含缩略图图像以区分中的包 包管理器.

源文件可以位于文件系统中的任意位置。 在POM文件中，定义生成资源以将源文件复制到 target/vault-work/META-INF 以包含在包中。

以下POM代码将文件添加到 META-INF 包的项目源的文件夹：

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

以下POM代码仅将缩略图图像添加到资源包。 必须命名缩略图图像 thumbnail.png，并且必须位于 META-INF/vault/definition 包的文件夹。 在此示例中，源文件位于 /src/main/content/META-INF/vault/definition 项目的文件夹：

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

使用AEM项目原型生成AEM项目

最新的AEM项目原型为本地和AMS实施实施了最佳实践包结构，建议将其用于所有AEM项目。

Business.Adobe.com 资源