AEM 專案原型

「項AEM目原型」將建立一個基於最佳做法的最小的Adobe Experience Manager項目，作為您自己項目的AEM起點。 使用此原型時必須提供的屬性允許您指定此項目所有部分的名稱以及控制某些可選特徵。

為什麼使用原型

使用「AEM項目原型」，您只需按幾下鍵，即可構建基於最佳實踐AEM的項目。 通過使用原型，所有的部件都已經到位，這樣，雖然最終的項目是最小的，但它已經實現了 關鍵功能 你AEM只需在上面建並延伸。

當然，在一個成功的項目中，有許AEM多要素，但使AEM用「項目原型」是一個堅實的基礎，強烈建議任何項AEM目使用。

快速入門

項目原型使得開始開發變得容易AEM。 您可以通過多種方式來採取您的第一步。

• WKND教程 — 有關開發(包括如AEM何利用原型)的重要介紹，請參閱 AEM Sites入門 — WKND教程 例如，用原型來實現一個簡單的項目。
• WKND事件教程 — 如果您對上的單頁應用程式(SPA)開發特別感興趣AEM，請務必簽出專用 WKND事件教程。
• 下載並自行啟動！ — 您可以輕鬆下載GitHub上提供的當前項目原型，並通過 執行以下簡單步驟。

使用原型得到什麼

原型AEM由模組組成：

• 核:是包含所有核心功能（如OSGi服務、偵聽器和調度程式）的Java包，以及與元件相關的Java代碼（如servlet和請求篩選器）。
• it.test:是基於Java的整合test。
• ui.apps:包含 /apps 和 /etc 項目的部分，即JS和CSS客戶端、元件和模板。
• ui.content:包含使用ui.apps模組中元件的示例內容。
• ui.config:包含項目的運行模式特定的OSGi配置。
• ui.frontend.general: （可選） 包含使用基於Webpack的常規前端生成模組所需的對象。
• ui.frontend.react: （可選） 包含使用原型建立基於「反應」(React)的項SPA目時所需的工件。
• ui.frontend.angular: （可選） 包含使用原型建立基於Angular的項SPA目時所需的工件。
• ui.test:包含基於硒的UItest。
• 全部:是一個內容包，它嵌入所有已編譯模組（包和內容包），包括任何供應商依賴項。
• 分析:對項目運行分析，為部署到AEMas a Cloud Service提供附加驗證。

Maven中表示的AEMArchetype模組被部署成AEM表示應用程式、內容和必要的OSGi包的內容包。

如何使用原型

要使用原型，首先需要建立一個項目，該項目將本地檔案結構中的模組生成為 以前。 作為項目生成的一部分，可以定義項目的許多屬性，如項目名稱、版本等。

使用Maven構建項目會建立可部署到的工件（包和OSGi捆綁包）AEM。 可以使用其他Maven命令和配置檔案將項目對象部署到實AEM例。

建立項目

要開始使用，您只需使用 Eclipse擴AEM展 並按照「新建項目」嚮導選擇 多模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托管服務或內部部署。
  只為非雲版本添加核心元件依賴項，因為為AEMas a Cloud Service提供核心元件。
• 調整 appTitle="My Site" 定義網站標題和元件組。
• 調整 appId="mysite" 定義Maven artifactId、元件、配置和內容資料夾名稱以及客戶端庫名稱。
• 調整 groupId="com.mysite" 定義Maven groupId和Java源包。
• 查找可用屬性清單，查看是否要調整更多屬性。

屬性

使用原型建立項目時，以下屬性可用。

設定檔

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

構建和安裝

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

mvn clean install

如果有正在運行的AEM實例，則可以生成並打包整個項目，然後使用以AEM下Maven命令進行部署。

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.test和it.launcher。 隨著項目的發展，始終可以添加更多模組。

相依關係

的 <dependencyManagement> 父POM的部分定義項目中使用的所有依賴項和API版本。 應在父POM中管理版本。 core和ui.apps等子模組不應包含任何版本資訊。

優步 — 賈爾

關鍵依賴項之一是 AEMJava API Jar。 這將包括所有API,AEM只有版本的一個依賴項AEM。

核心元件

本課AEM程的「項目原型」利用了「核心元件」。

核心元件以預設運行AEM模式自動安裝，並由示例WKND站點使用。 在 生產運行模式 (nosamplecontent)核心元件不可用。

因此，為了在所有部署中利用核心元件，最好將其納入Maven項目。

測試

項目中包含三個級別的測試，由於它們是不同類型的test，因此它們以不同的方式或在不同的位置執行。

• 核心單元test:這展示了捆綁包中包含的代碼的經典單元測試。 要test，請執行：
  • mvn clean test
• 伺服器端整合test:這些test在環AEM境（即在伺服器上）中運AEM行。 要test，請執行：
  • mvn clean verify -PintegrationTests
• 客戶端Hobbes.jstest:這些是基於JavaScript的瀏覽器端test，用於驗證瀏覽器端行為。 test:
  1. 在AEM瀏覽器中載入，就像您編寫頁面一樣。
  2. 在中開啟頁面 開發人員模式
  3. 開啟左面板並切換到 Test 頁籤。
  4. 查找生成的 MyNameTest 然後跑。

後續步驟

所以你建造並安裝了AEMProject Archetype。 現在怎麼辦？ 原型很小，但是包含許多根據推薦的最佳實踐AEM配置的強大功能示例。 使用這些功能可以說明如何在項目中利用這些功能。 對於您可能需要的任何項目：

• 通過擴展現有核心元件來定制元件
• 添加其他模板
• 適應本地化結構
• 瞭解前端生成模組