Adobe內容套件Maven外掛程式 adobe-content-package-maven-plugin

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

將已建構的套件部署到AEM是由AdobeContent Package Maven外掛程式執行，並可啟用通常使用AEM執行之工作的自動化 封裝管理員：

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

套件和AEM專案結構 aem-project-structure

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

取得內容套件Maven外掛程式 obtaining-the-content-package-maven-plugin

外掛程式可從 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外掛程式的目標 goals-of-the-content-package-maven-plugin

後續章節將說明「內容套件」外掛程式提供的目標與目標引數。 「一般引數」一節中說明的引數可用於大部分的目標。 套用至一個目標的引數會在該目標的區段進行說明。

外掛程式前置詞 plugin-prefix

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

mvn content-package:build

引數前置詞 parameter-prefix

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

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

代理 proxies

使用AEM代理的目標會使用Maven設定中找到的第一個有效Proxy設定。 如果未找到Proxy設定，則不會使用Proxy。 請參閱 useProxy 中的引數 通用引數 區段。

通用引數 common-parameters

下表中的引數是所有目標的共同引數，除非在 目標 欄。

版本編號 build

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

參數 parameters

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

安裝 install

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

參數 parameters-1

除了下列引數外，請參閱 通用引數 區段。

ls ls

列出部署到的套件 封裝管理員.

參數 parameters-2

ls目標的所有引數都說明於 通用引數 區段。

rm rm

從移除套裝 封裝管理員.

參數 parameters-3

rm目標的所有引數都說明於 通用引數 區段。

解除安裝 uninstall

解除安裝套裝。 套件會留在伺服器上並處於解除安裝狀態。

參數 parameters-4

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

封裝 package

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

參數 parameters-5

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

使用篩選器 using-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>

匯入模式 import-mode

此 mode 元素會定義內容在匯入套件時如何影響存放庫。 可以使用以下值：

當篩選器包含否 mode 元素，的預設值 replace 已使用。

說明 help

參數 parameters-6

在套件中包含縮圖影像或屬性檔案 including-a-thumbnail-image-or-properties-file-in-the-package

取代預設的封裝組態檔以自訂封裝屬性。 例如，加入縮圖影像以區分中的套件 封裝管理員.

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

最新的AEM專案原型會為內部部署和AMS實作實施最佳實務套件結構，並建議用於所有AEM專案。