AEM 專案原型

AEM專案原型會建立依最佳作法為基礎所簡化的Adobe Experience Manager專案，作為您專屬AEM專案的開端。 使用此原型時必須提供的屬性可讓您指定此專案所有部分的名稱，以及控制某些選擇性功能。

為何使用原型

使用AEM專案原型，您只需按幾下滑鼠，即可建立以最佳實務為基礎的AEM專案。 使用原型時，所有片段都已準備就緒，因此雖然產生的專案最小，但已實施所有 主要功能 AEM的URL編號，因此您只需要在上方建置並延伸。

當然，成功的AEM專案涉及許多元素，但使用AEM專案原型是堅實的基礎，強烈建議對任何AEM專案使用。

快速入門

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

• WKND教學課程 — 如需在AEM上進行開發的詳細介紹，包括如何運用原型，請參閱 AEM Sites - WKND教學課程快速入門 此實用範例將逐步說明如何使用原型來實作簡單專案。
• WKND事件教學課程 — 如果您特別想知道如何在AEM上開發單頁應用程式(SPA)，請務必檢視專屬的 WKND事件教學課程.
• 自行下載並開始使用！ — 您可以輕鬆下載GitHub上可用的目前專案原型，並透過以下方式建立您的第一個專案 請依照下列簡單步驟操作.

使用原型的好處

AEM原型由模組組成：

• 核心：此Java套件組合包含所有核心功能（例如OSGi服務、監聽器和排程器）以及與元件相關的Java程式碼（例如servlet和請求篩選器）。
• it.tests：是以Java為基礎的整合測試。
• ui.apps：包含 /apps 和 /etc 專案的一部分，即JS和CSS clientlibs、元件和範本。
• ui.content：包含使用ui.apps模組元件的範例內容。
• ui.config：包含專案的執行模式專用OSGi設定。
• ui.frontend.general： （選擇性） 包含使用一般Webpack型前端建置模組所需的成品。
• ui.frontend.react： （選擇性） 包含使用原型根據React建立SPA專案時所需的成品。
• ui.frontend.angular： （選擇性） 包含使用原型根據Angular建立SPA專案時所需的成品。
• ui.tests：包含以Selenium為基礎的UI測試。
• 全部：是單一內容套件，內嵌所有已編譯的模組（套件組合和內容套件），包括任何廠商相依性。
• 分析：對專案執行分析，這為部署至AEMas a Cloud Service提供額外的驗證。

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

如何使用原型

若要使用原型，您首先需要建立一個專案，該專案會在本機檔案結構中產生模組，如下所示 先前已說明. 作為專案產生的一部分，可以定義專案的一些屬性，例如專案名稱、版本等。

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

建立專案

若要開始使用，您只需使用 AEM Eclipse擴充功能 並依照新增專案精靈的指示選擇 AEM範例多模組專案 以使用原型的發行版本。

當然，您也可以直接叫用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專案原型的。
• 設定 aemVersion=cloud 的 AEMas a Cloud Service；
  設定 aemVersion=6.5.0 的 Adobe Managed Services或內部部署。
  僅針對非雲端AEM版本新增核心元件相依性，因為核心元件是針對AEMas a Cloud Service提供的OOTB。
• 調整 appTitle="My Site" 以定義網站標題和元件群組。
• 調整 appId="mysite" 以定義Maven artifactId、元件、設定和內容資料夾名稱以及使用者端資料庫名稱。
• 調整 groupId="com.mysite" 以定義Maven groupId和Java來源套件。
• 查詢可用屬性清單，檢視是否有更多要調整的內容。

屬性

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

設定檔

執行時，產生的maven專案支援不同的部署設定檔 mvn install.

建置和安裝

若要建置在專案根目錄中執行的所有模組，請使用以下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

此 pom.xml 在專案的根目錄(<src-directory>/<project>/pom.xml)稱為上層POM，可驅動專案結構並管理專案的相依性和某些全域屬性。

全域專案屬性

此 <properties> 上層POM的區段會定義在AEM執行個體上部署專案所必需的幾個全域屬性，例如使用者名稱/密碼、主機名稱/連線埠等。

這些屬性設定為部署至本機AEM執行個體，因為這是開發人員最常進行的建置。 請注意，有一些屬性要部署至作者執行個體以及發佈執行個體。 這也是認證設定為使用AEM執行個體進行驗證的地方。 使用預設的admin：admin憑證。

設定這些屬性以便在部署到更高級別的環境時可以覆寫它們。 如此一來，POM檔案就不需要變更，變數如下 aem.host 和 sling.password 可透過命令列引數覆寫：

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

模組結構

此 <modules> 上層POM的區段會定義專案將建立的模組。 預設會建置專案 先前定義的標準模組： core、ui.apps、ui.content、ui.tests和it.launcher。 隨著專案發展，永遠可以新增更多模組。

相依性

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

Uber-Jar

主要相依性之一是 AEM Java API Jar. 這將包括所有AEM API，而AEM版本只有一個相依性專案。

核心元件

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

核心元件會在預設執行模式下自動安裝在AEM中，並由範例WKND網站使用。 在 生產執行模式 (nosamplecontent)核心元件無法使用。

因此，若要在所有部署中運用核心元件，最佳實務是將它們納入Maven專案。

測試

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

• core中的單元測試：此測試會示範套件組合中包含之程式碼的典型單元測試。 若要測試，請執行：
  • mvn clean test
• 伺服器端整合測試：這些會在AEM環境中(亦即AEM伺服器上)執行單元測試。 若要測試，請執行：
  • mvn clean verify -PintegrationTests
• 使用者端Hobbes.js測試：這些是驗證瀏覽器端行為的JavaScript瀏覽器端測試。 若要測試：
  1. 在瀏覽器中載入AEM，就像編寫頁面一樣。
  2. 在中開啟頁面 開發人員模式
  3. 開啟左側面板並切換至 測試 標籤。
  4. 尋找產生的 MyName測試 並執行它們。

後續步驟

因此您已建置並安裝AEM專案原型。 現在該怎麼辦？ 雖然原型很小，但包含許多根據建議最佳實務設定的強大AEM功能範例。 這些範本可指示您如何在專案中利用這些功能。 對於任何專案，您可能需要：

• 透過擴充現有核心元件來自訂元件
• 新增其他範本
• 調整本地化結構
• 瞭解前端建置模組