AEM 專案原型

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

秘訣

您可以在GitHub上找到最新的AEM專案原型

資源

  • 原型檔案(本檔案): 原型架構及其不同模組的概述。
  • 下列教學課程是以此原型為基礎:

功能

  • 最佳作法: 使用所有Adobe的最新建議作法Bootstrap您的網站。
  • 低程式碼: 編輯範本、建立內容、部署CSS,而您的網站已可上線。
  • 雲端就緒: 如有需要, 請使用AEM as a Cloud Service,在數天內上線,並簡化擴充性和維護作業。
  • Dispatcher: 專案只有以可確保速度與安全 的Dispatcher設定完成。
  • 多網站: 如有需要,原型會為多語言和多 區域設定產生內容結構
  • 核心元件: 作者可以使用多功能的標準元件集,建立幾乎 任何版面配置
  • 可編輯的範本: 幾乎可組合任 何不含程式碼的範本,並定義作者可編輯的項目。
  • 回應式配置: 在範本或個別頁面上, 定義元素對已定 義斷點的重排方式。
  • 頁首與頁尾: 不使用程式碼,使用元件的本 地化功能來組合和本地化
  • 樣式系統: 允許作者套用不同樣式來避免建 立自 訂元件。
  • 前端建置: 前端開發人員可 以透過Webpack、 TypeScript和 SASS模擬AEM頁 面並建立用戶端程式庫。
  • WebApp-Ready: 針對使用 🔗 Reactor Angular的網站,請使用 SPA SDK 保留應用程式的內容內編寫。
  • 啟用商務: 針對要將AEM Commerce與商務解決 案(如管理商務核 🔗 心元件) 整合的專案
  • 范常式式碼: 結帳HelloWorld元件,以及範例模型、servlet、篩選器和排程器。
  • 開放來源: 如果某個項目不如預期,將有助於 🔗 您的改善!

使用狀況

若要產生專案,請根據您的需求調整下列命令列:

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=XX \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
  • 以最新的原型版本號碼取代XX
  • AEM設定aemVersion=cloud作為Cloud Service;
    Adobe Managed Services或內部部署設定aemVersion=6.5.0
    僅會針對非雲端aem版本新增核心元件相依性,因為AEM會以Cloud Service的形式提供核心元件。
  • 調整appTitle="My Site"以定義網站標題和元件群組。
  • 調整appId="mysite"以定義Maven工件Id、元件、配置和內容資料夾名稱,以及客戶端庫名稱。
  • 調整groupId="com.mysite"以定義Maven groupId和Java源包。
  • 查詢可用屬性清單,查看是否有其他需要調整的項目。

可用屬性

名稱 預設 說明
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版本(對於AEM as a Cloud Service,可以是cloud;或6.5.0,或6.4.4(適用於Adobe Managed Services或內部部署)。
sdkVersion latest aemVersion=cloud可指定 SDK版本時(例如2020.02.2265.20200217T222518Z-200130)。
includeDispatcherConfig y 包含雲端或AMS/內部部署的Dispatcher設定,視aemVersion值而定(可以是yn)。
frontendModule general 包括Webpack前端構建模組,用於生成常規站點的客戶端庫(可以是generalnone;可為angularreact,適用於實作SPA編輯器的單頁應用程式。
language en 語言代碼(ISO 639-1),以從(例如en, deu)。
country us 國家/地區代碼(ISO 3166-1),以從(例如US)。
singleCountry y 包含語言主版內容結構(可以是yn)。
includeExamples n 包含元件庫示例站點(可以是yn)。
includeErrorHandler n 包含對整個執行個體具有全域性的自訂404回應頁面(可以是yn)。
includeCommerce n 包含CIF核心元件相依性並產生對應的成品。
commerceEndpoint 僅CIF為必要。 要使用的商務系統GraphQL服務的可選端點(例如https://hostname.com/grapql)。
datalayer y 啟動與Adobe客戶端資料層的整合。
amp n 對生成的項目模板啟用AMP支援。
enableDynamicMedia n 在專案原則設定中啟用基礎DynamicMedia元件,並在核心影像元件的原則中啟用Dynamic Media功能。
enableSSR n 為前端項目啟用SSR的選項

系統需求

原型 AEM as a Cloud Service AEM 6.5 Java SE 馬文
28 持續 6.5.7.0+ 8, 11 3.3.9+

AEM as aCloud ServiceSDK或為舊版AEM設定本機開發環境。

已知問題

在Windows上執行並產生調度程式配置時,您應在提升的命令提示字元或Linux的Windows子系統中執行(請參閱#329)。

在互動式模式中執行原型時(沒有-B參數),具有預設值的屬性無法變更,除非最終確認被解除,然後確認會將具有預設值的屬性納入問題中以重複問題(請參閱
ARCHETYPE-308以取得詳細資訊)。

開始含有File -> New -> Maven Project的新專案時,您無法在Eclipse中使用此原型,因為後續產生指令碼archetype-post-generate.groovy由於Eclipse問題而將不會執行。 因應措施是使用上述命令列,然後在Eclipse中使用 File -> Import -> Existing Maven Project

進一步閱讀

如需使用原型的詳細資訊,包括其優點、選項及其模組的運作方式,請參閱使用原型檔案。

本頁內容