Adobe內容套件Maven外掛程式

使用Adobe內容套件Maven外掛程式，將套件部署和管理任務整合到您的Maven專案中。

將建構的套件部署到AEM是由Adobe內容套件Maven外掛程式執行，並允許自動化通常使用AEM執行的任務 封裝管理員：

• 從檔案系統中的檔案建立新封裝。
• 在AEM上安裝及解除安裝套件。
• 建置已在AEM上定義的套件。
• 取得AEM上安裝的套件清單。
• 從AEM移除套件。

本檔案詳細說明如何使用Maven管理這些任務。 不過，瞭解也很重要 AEM專案及其套件的結構方式。

套件和AEM專案結構

AEMas a Cloud Service會遵循由最新AEM專案原型實作的套件管理和專案結構的最新最佳實務。

取得內容套件Maven外掛程式

外掛程式可從 Maven中央存放庫。

內容套件Maven外掛程式目標和引數

若要使用Content Package 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設定中找到的第一個有效Proxy設定。 如果找不到Proxy設定，則不會使用Proxy。 請參閱 useProxy 中的引數 常見引數 區段。

常見引數

下表中的引數對所有目標都是通用的，除非在 目標 欄。

建置

建置已在AEM執行個體上定義的內容套件。

參數

有關建置目標的所有引數的說明，請參見 常見引數 區段。

安裝

在存放庫中安裝套件。 執行此目標不需要Maven專案。 目標已繫結至 install Maven建置生命週期的階段。

參數

除了下列引數外，請參閱 常見引數 區段。

ls

列出部署至的套件 封裝管理員。

參數

ls目標的所有引數都說明於 常見引數 區段。

rm

從以下位置移除套件 封裝管理員。

參數

RM目標的所有引數都說明於 常見引數 區段。

解除安裝

解除安裝套件。 套件會維持在伺服器上未安裝狀態。

參數

有關解除安裝目標的所有引數的說明，請參見 常見引數 區段。

封裝

建立內容封裝。 套件目標的預設設定包含儲存已編譯檔案的目錄內容。 套件目標的執行需要編譯建置階段完成。 套件目標繫結至Maven建置生命週期的套件階段。

參數

除了下列引數外，請參閱 name 中的引數 常見引數 區段。

使用篩選器

使用篩選器元素來定義封裝內容。 篩選器會新增至 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專案。

Business.Adobe.com 資源