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值而定（可以是y或n）。
frontendModule general 包括Webpack前端構建模組，用於生成常規站點的客戶端庫(可以是general或none;可為angular或react，適用於實作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回應頁面（可以是y或n）。
includeCommerce n 包含CIF核心元件相依性並產生對應的成品。
commerceEndpoint 僅CIF為必要。 要使用的商務系統GraphQL服務的可選端點(例如https://hostname.com/grapql)。
datalayer y 啟動與Adobe客戶端資料層的整合。
amp n 對生成的項目模板啟用AMP支援。
enableDynamicMedia n 在專案原則設定中啟用基礎DynamicMedia元件，並在核心影像元件的原則中啟用Dynamic Media功能。
enableSSR n 為前端項目啟用SSR的選項
precompiledScripts n 預編譯來自ui.apps的伺服器端指令碼，並將它們作為ui.apps專案中的次要套件組合項目附加到組建中的選項。 aemVersion 應設為 cloud。

系統需求

原型 AEM as a Cloud Service AEM 6.5 Java SE 馬文
30 持續 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。

進一步閱讀

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

本頁內容