AEM 專案原型

AEM專案原型會建立基於最佳實務的簡化Adobe Experience Manager專案，作為您專屬AEM專案的起點。 使用此原型時必須提供的屬性可讓您指定此專案所有部分的名稱，並控制某些選用功能。

為何使用原型

使用AEM專案原型，只需按幾下鍵，即可建立以最佳實務為基礎的AEM專案。 透過使用原型，所有片段都已就緒，這樣雖然產生的專案最小，但已實作AEM的所有主要功能，讓您只需在上面建置並延伸即可。

當然，有許多元素會進入成功的AEM專案，但使用AEM專案原型是堅實的基礎，且強烈建議用於任何AEM專案。

快速入門

專案原型可讓您輕鬆開始在AEM上開發。 您可以透過多種方式執行您的第一步。

原型的使用

AEM原型由模組組成：

  • 核心:是Java套件，其中包含所有核心功能，例如OSGi服務、接聽程式和排程程式，以及元件相關的Java程式碼，例如servlet和請求篩選器。
  • it.tests:是Java型整合測試。
  • ui.apps:包含 /apps 專 /etc 案的和部分，例如JS和CSSclientlib、元件和範本。
  • ui.content:包含使用ui.apps模組中元件的範例內容。
  • ui.config:包含專案的執行模式專屬OSGi設定。
  • ui.frontend.general: （選用） 包含使用一般Webpack型前端建置模組所需的成品。
  • ui.frontend.react: （選用） 包含使用原型根據React建立SPA專案時所需的成品。
  • ui.frontend.angular: （選用） 包含使用原型根據Angular建立SPA專案時所需的成品。
  • ui.tests:包含基於硒的UI測試。
  • 全部:是單一內容包，它嵌入所有已編譯模組（包和內容包），包括任何供應商依賴項。
  • 分析:在專案上執行分析，提供部署至AEM as aCloud Service的額外驗證。

Maven中呈現的AEM原型模組會部署至AEM，作為代表應用程式、內容和必要OSGi套件組合的內容套件。

如何使用原型

若要使用原型，您必須先建立專案，專案會以先前說明的形式，產生本機檔案結構中的模組。 在產生專案時，可以定義專案的許多屬性，例如專案名稱、版本等。

使用Maven建立專案會建立可部署至AEM的成品（套件和OSGi套件組合）。 其他Maven命令和設定檔可用來將專案成品部署至AEM執行個體。

建立專案

若要開始使用，您最簡單的方式是使用AEM Eclipse擴充功能，然後依照「新增專案」精靈，選擇​AEM Sample Multi-Module Project​來使用已發行版本的原型。

當然，您也可以直接叫用Maven。

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

將adobe-public設定檔新增至您的Maven settings.xml檔案，以便自動將repo.adobe.com新增至Maven建置程式。

您可在此處🔗找到範例POM 。

屬性

使用原型建立專案時，可使用下列屬性。

名稱 預設 說明
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。
注意

如果首次以互動式模式執行原型，則無法變更具有預設值的屬性（如需詳細資訊，請參閱ARCHETYPE-308）。 當最終的屬性確認被拒絕且調查表重複時，或通過在命令行中傳遞參數(例如，-DoptionIncludeExamples=n)。

注意

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

設定檔

運行mvn install時，生成的Maven項目支援不同的部署配置檔案。

設定檔ID 說明
autoInstallBundle 將核心套件搭配maven-sling-plugin安裝至felix主控台
autoInstallPackage 將ui.content和ui.apps內容套件與content-package-maven-plugin安裝至套件管理器，以在localhost，連接埠4502上安裝預設的製作例項。 可使用aem.host和aem.port用戶定義的屬性更改主機名和埠。
autoInstallPackagePublish 將ui.content和ui.apps內容套件（內容套件 — maven-plugin）安裝至套件管理器，以在localhost，連接埠4503上預設發佈執行個體。 可使用aem.host和aem.port用戶定義的屬性更改主機名和埠。
autoInstallSinglePackage 將all內容套件與content-package-maven-plugin一起安裝至套件管理器，以在localhost，連接埠4502上預設製作例項。 可使用aem.host和aem.port用戶定義的屬性更改主機名和埠。
autoInstallSinglePackagePublish 將all內容套件與content-package-maven-plugin安裝至套件管理器，以在localhost，連接埠4503上預設發佈執行個體。 可使用aem.host和aem.port用戶定義的屬性更改主機名和埠。
integrationTests 在AEM例項上執行提供的整合測試（僅針對verify階段）
precompiledScripts 在項目生成時自動定義，precompiledScripts屬性設定為y。 預設情況下，配置檔案處於活動狀態，並在ui.apps內生成具有預編譯指令碼的OSGi捆綁，該捆綁將包含在all內容包中。 可以使用-DskipScriptPrecompilation=true禁用配置檔案。

建置和安裝

要生成在項目根目錄中運行的所有模組，請使用以下Maven命令。

mvn clean install

如果您有執行中的AEM執行個體，則可以建置並封裝整個專案，並使用下列Maven命令部署至AEM。

mvn clean install -PautoInstallPackage

要將其部署到發佈實例，請運行此命令。

mvn clean install -PautoInstallPackagePublish

或者，要部署到發佈實例，請運行此命令。

mvn clean install -PautoInstallPackage -Daem.port=4503

或者，若只要將套件部署至作者，請執行此命令。

mvn clean install -PautoInstallBundle

父POM

位於項目根目錄(<src-directory>/<project>/pom.xml)的pom.xml稱為父POM，驅動項目結構並管理項目的依賴項和某些全局屬性。

全局項目屬性

父POM的<properties>部分定義了對於在AEM實例上部署項目很重要的幾個全局屬性，如用戶名/密碼、主機名/埠等。

這些屬性設定為部署至本機AEM例項，因為這是開發人員最常做的組建。 請注意，有些屬性可部署至製作執行個體和發佈執行個體。 這也是設定憑證以透過AEM例項驗證的地方。 會使用預設管理員：管理員憑證。

設定這些屬性，以便在部署到更高級別環境時可以覆蓋這些屬性。 這樣，POM檔案就不必更改，但aem.host和sling.password等變數可以通過命令行參數被覆蓋：

mvn -PautoInstallPackage clean install -Daem.host=production.hostname -Dsling.password=productionpasswd

模組結構

父POM的<modules>區段定義專案將建置的模組。 預設情況下，項目生成以前定義的標準模組:核心、ui.apps、ui.content、ui.tests和it.launcher。 隨著專案的演變，您一律可以新增更多模組。

相依關係

上層POM的<dependencyManagement>區段會定義專案中使用的所有相依性和API版本。 版本應在父POM中管理。 核心和ui.apps等子模組不應包含任何版本資訊。

Uber-Jar

其中一個關鍵相依性是AEM Java API Jar。 這會包含所有AEM API，其中只包含AEM版本的單一相依性項目。

注意

最佳實務是，您應更新uber-jar版本以符合AEM的目標版本。 例如，如果您打算部署至AEM 6.4，則應將uber-jar的版本更新至6.4.0。

核心元件

AEM專案原型當然會運用核心元件。

核心元件會以預設執行模式自動安裝於AEM中，並供範例WKND網站使用。 在生產執行模式(nosamplecontent)中，核心元件不可用。

因此，若要在所有部署中運用核心元件，最好將其納入Maven專案。

注意

核心元件的每個版本通常之後都會有AEM專案原型的版本，這樣最新的原型就會使用核心元件的最新版本。

不過，新版本的原型可能不會直接遵循新版本的核心元件，因此您可能會想要將核心元件的相依性更新為最新版本。

注意

core.wcm.components.examples是一組範例頁面，說明核心元件的範例。 作為最佳實務，為生產用途部署專案時，您應移除此相依性和子套件包含。

測試

專案中包含三個層級的測試，且由於它們是不同類型的測試，因此會以不同的方式或在不同的位置執行。

  • 核心單元測試：這可展示套件中程式碼的傳統單元測試。 要測試，請執行：
    • mvn clean test
  • 伺服器端整合測試：這些會在AEM環境(即AEM伺服器)中執行類似單元的測試。 要測試，請執行：
    • mvn clean verify -PintegrationTests
  • 用戶端Hobbes.js測試：這些是以JavaScript為基礎的瀏覽器端測試，可驗證瀏覽器端行為。 要測試：
    1. 在瀏覽器中載入AEM，如同您要編寫頁面一樣。
    2. 在開發人員模式中開啟頁面
    3. 開啟左側面板，然後切換到​Tests​頁簽。
    4. 找到生成的​MyName測試​並運行它們。

後續步驟

因此，您已建立並安裝AEM專案原型。 現在呢？ 原型很小，但包含許多根據建議最佳實務設定的強大AEM功能範例。 使用這些說明如何在專案中運用這些功能。 針對您可能需要的任何專案：

本頁內容