AEM Project Archetype

AEM Project Archetype是Maven範本,可建立以最簡化、最佳實務為基礎的Adobe Experience Manager(AEM)專案,做為您網站的起點。

小費

您可在GitHub上找到最 新的AEM Project Archetype

資源

  • 原型檔案(本檔案): 總結了原型體系結構及其不同模組。
  • 以下教學課程是以此原型為基礎:

功能

使用狀況

要生成項目,請根據需要調整以下命令行:

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=24 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
  • Set aemVersion=cloud for AEM as a Cloud Service;
    aemVersion=6.5.0 Adobe Managed Services ,或內部部署設定。
    「核心元件」相依性僅會針對非雲端版本新增,因為「核心元件」是以雲端服務形式提供給AEM的OOTB。
  • 調整 appTitle="My Site" 以定義網站標題和元件群組。
  • 調整 appId="mysite" 以定義Maven artifactId、元件、設定和內容資料夾名稱,以及用戶端程式庫名稱。
  • 調整 groupId="com.mysite" 以定義Maven groupId和Java Source Package。
  • 查閱可用屬性的清單,查看您是否需要調整更多屬性。

可用屬性

名稱 預設 說明
appTitle 應用程式標題將用於網站標題和元件群組(例如 "My Site")。
appId 技術名稱將用於元件、設定和內容資料夾名稱,以及用戶端程式庫名稱(例如 "mysite")。
artifactId ${appId} 基本Maven對象ID(例如 "mysite")。
groupId 基本Maven群組ID(例如 "com.mysite")。
package ${groupId} Java源包(例如 "com.mysite")。
version 1.0-SNAPSHOT 專案版本(例如 1.0-SNAPSHOT)。
aemVersion cloud Target AEM版本(可以 cloud於AEM做為雲端服務;或 6.5.0,或 6.4.4Adobe Managed Services 或內部部署)。
sdkVersion latest 當可 aemVersion=cloud 以指 定SDK版本時 (例如 2020.02.2265.20200217T222518Z-200130)。
includeDispatcherConfig y 包含針對雲或AMS/on-premise的調度程式配置,具體取決於 aemVersion (可以是 yn)。
frontendModule general 包含Webpack前端構建模組,用於生成客戶端庫(可以是常規 general 站點 none 的客戶端庫;可以是實 angularreact SPA編輯器的單頁應用程 )。
language en 語言程式碼(ISO 639-1),以建立內容結構,例如 en, deu)。
country us 國家/地區代碼(ISO 3166-1),以建立內容結構,例如 US)。
singleCountry y 包含語言主版內容結構(可 y以是 n或)。
includeExamples n 包含元 件庫 (可以 y是或 n)示例站點。
includeErrorHandler n 包含自訂的404回應頁面,該頁面將會是整個例項的全域(可以是 yn)。
includeCommerce n 包括 CIF核心元件相依性 ,並生成相應的對象。
commerceEndpoint 僅CIF必需。 要使用的商務系統GraphQL服務的可選端點(例如 https://hostname.com/grapql)。
datalayer y 啟動與 Adobe用戶端資料層的整合
amp n 啟用 AMP ,支援產生的專案範本。

Analyzer模組

AEM Analyzer Maven增效模組會分析各種內容套件專案的結構。

如需如 何將AEM Analyzer Maven Plugin專案包含在AEM Maven專案中的詳細資訊 ,請參閱AEM Analyzer Maven Plugin檔案。 外掛程式已包含在AEM Maven原型第25版及更新版本中。

下表說明在此步驟中執行的分析器。 請注意,有些會在本機SDK中執行,而有些則只會在Cloud Manager管道部署期間執行。

模組 函式、範例與疑難排解 本機SDK Cloud Manager
api-regions-exportsimports 檢查所有OSGI捆綁包是否都有其Import-Package聲明,該聲明由Maven項目中其它包含的捆綁包的Export-package聲明滿足。

 

若要疑難排解,請查看您要匯出的套件資訊清單,以判斷使用的是錯誤名稱或版本。
requirements-capabilities 檢查在OSGI捆綁包中建立的所有要求聲明是否由Maven項目中包含的其他捆綁包的功能聲明滿足。

 

若要疑難排解,請查看您預期會宣告功能包的資訊清單,以判斷其遺失的原因。
bundle-content 如果搭售包含以Sling-Initial-Content指定的初始內容,則會發出警告,這在AEM中是Cloud Service叢集環境。
api-regions-crossfeature-dups 驗證客戶OSGI搭售沒有將AEM覆寫為雲端服務之公開API的匯出套件宣告

系統需求

原型 AEM as a Cloud Service AEM 6.5 AEM 6.4 Java SE 馬文
24 持續 6.5.5.0+ 6.4.8.1+ 8, 11 3.3.9+

將您的本機開發環境設 定為AEM(Cloud Service SDK )或 舊版AEM

已知問題

在Windows上運行並生成調度程式配置時,您應在提升的命令提示符或Linux的Windows子系統中運行(請參 見#329)。

在交互模式下執行原型時(無參數 -B ),不能更改具有預設值的屬性,除非最終確認被關閉,然後通過將具有預設值的屬性包括在問題中來重複問題(有關詳細資訊,請參閱ARCHETYPE-308 )。

進一步閱讀

有關使用原型的詳細資訊,包括其優點、選項及其模組的工作方式,請參閱使 用原型文檔。

本頁內容