Adobe內容套件Maven外掛程式

使用Adobe內容套件Maven外掛程式，將套件部署和管理工作整合至您的Maven專案。

將已建構的套件部署至AEM是由Adobe內容套件Maven外掛程式執行，並可自動執行使用AEM通常執行的工作 包管理器：

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

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

套件和AEM專案結構

AEM as 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外掛程式的目標

內容套件外掛程式提供的目標和目標參數將於後續章節中說明。 公用參數區段中所述的參數可用於大部分目標。 適用於一個目標的參數在該目標的一節中有說明。

外掛程式首碼

外掛程式首碼為 content-package. 使用此前置詞從命令行執行目標，如下例所示：

mvn content-package:build

參數前置詞

除非另有說明，否則外掛程式目標和參數會使用 vault 前置詞，如下列範例所示：

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

Proxy

使用AEM代理的目標會使用Maven設定中找到的第一個有效代理設定。 如果未找到代理配置，則不使用代理。 請參閱 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 中所有規則的URL區段。

說明

參數

在包中包括縮略圖或屬性檔案

替換預設包配置檔案以自定義包屬性。 例如，納入縮圖影像以區分中的套件 封裝管理員。

源檔案可以位於檔案系統中的任何位置。 在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專案。