Adobe內容包Maven插件

使用Adobe內容包管理插件將包部署和管理任務整合到Maven項目中。

將構造的包部署AEM到由Adobe內容包Maven插件執行，並使通常使用 包管理器：

• 從檔案系統中的檔案建立新包。
• 在上安裝和卸載包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>0.0.24</version>
 <configuration>
       <!-- parameters and values common to all goals, as required -->
 </configuration>
</plugin>

要使Maven能夠下載插件，請使用中提供的配置檔案 獲取內容包Maven插件 的子菜單。

內容包Maven插件的目標

「內容包」插件提供的目標和目標參數在以下各節中進行了說明。 「公共參數」(Common Parameters)部分中描述的參數可用於大多數目標。 適用於一個目標的參數在該目標的一節中介紹。

插件前置詞

插件前置詞是 content-package。 使用此前置詞從命令行執行目標，如下例所示：

mvn content-package:build

參數前置詞

除非另有說明，否則插件目標和參數使用 vault 前置詞，如下例所示：

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

代理

使用代理使用Maven設AEM置中找到的第一個有效代理配置的目標。 如果未找到代理配置，則不使用代理。 查看 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 etc.) -->
        <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項目。