Adobe內容套件Maven外掛程式

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

將已構建的包部署到AEM由Adobe內容包Maven插件執行，並啟用了使用AEM包管理器通常執行的任務的自動化：

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

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

套件和AEM專案結構

AEM as aCloud 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專案。 目標會系結至Maven建置生命週期的install階段。

參數

除了下列參數外，請參閱Common Parameters一節中的說明。

ls

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

參數

公用參數部分中描述了ls目標的所有參數。

rm

從包管理器中刪除包。

參數

公用參數部分中描述了rm目標的所有參數。

解除安裝

卸載軟體包。 軟體包仍在伺服器上處於卸載狀態。

參數

公用參數部分介紹了卸載目標的所有參數。

套件

建立內容套件。 包目標的預設配置包括保存已編譯檔案的目錄的內容。 要執行包目標，需要完成編譯生成階段。 套件目標會系結至Maven組建生命週期的套件階段。

參數

除了下列參數外，請參閱Common Parameters部分中name參數的說明。

使用篩選器

使用篩選元素來定義套件內容。 這些篩選器會新增至套件META-INF/vault/filter.xml檔案中的workspaceFilter元素。

以下篩選器示例顯示要使用的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專案。