設定本機AEM執行階段

Adobe Experience Manager(AEM)可透過AEMas a Cloud Service SDK的Quickstart Jar在本機執行。 這可讓開發人員在將自訂程式碼、設定和內容提交至原始碼控制項之前，先進行部署和測試，然後將其部署至AEMas a Cloud Service環境。

請注意 ~ 用作用戶目錄的簡稱。 在Windows中，這等同於 %HOMEPATH%.

安裝Java

Experience Manager是Java應用程式，因此需要Java SDK支援開發工具。

1. [下載並安裝最新的Java SDK 11](https://experience.adobe.com/#/downloads/content/software-distribution/en/general.html?1_group.propertyvalues.property=.%2Fjcr%3Acontent%2Fmetadata%2Fdc%3AsoftwareType&1_group.propertyvalues.operation=equals&1_group.propertyvalues.0_values=software-type%3Atoling&fulltext=Oracle%7E+JDK%7E+11%7E&orderby=%40jcr%3Cont%2Fjcr%3Alast&modified by.sort=dest&p.st=dest&p.llep.p.p=14)
2. 執行以下命令以確認Java 11 SDK是否已安裝：
   • Windows:java -version
   • macOS / Linux : java --version

下載AEMas a Cloud ServiceSDK

AEMas a Cloud ServiceSDK(或AEM SDK)包含用於在本機執行AEM製作和發佈以供開發的Quickstart Jar，以及相容的Dispatcher工具版本。

1. 登入 https://experience.adobe.com/#/downloads 與Adobe ID
   • 請注意，您的Adobe組織 必須 布建AEMas a Cloud Service以下載AEMas a Cloud Service SDK。
2. 導覽至 AEMas a Cloud Service 標籤
3. 排序依據 發佈日期 in 降序 訂購
4. 按一下最新 AEM SDK 結果行
5. 檢閱並接受EULA，然後點選 下載 按鈕

從AEM SDK zip解壓縮Quickstart Jar

1. 將下載的郵遞區號解壓縮 aem-sdk-XXX.zip 檔案

設定本機AEM Author服務

本機AEM作者服務可為開發人員提供本機體驗，供數位行銷人員/內容作者共用，以建立和管理內容。 AEM Author Service的設計目的，是要同時提供製作和預覽環境，讓您能針對其執行大部分的功能開發驗證，成為本機開發程式的重要元素。

1. 建立資料夾 ~/aem-sdk/author

2. 複製 快速入門JAR 檔案 ~/aem-sdk/author 將重新命名為 aem-author-p4502.jar

3. 從命令列執行下列動作，以啟動本機AEM Author Service:

   • java -jar aem-author-p4502.jar
     • 提供管理員密碼作為 admin. 任何管理員密碼都是可接受的，但建議使用本機開發的預設密碼，以減少重新設定的需求。

   您 不能 將AEM啟動為Cloud Service快速入門Jar 按兩下.

4. 在存取本機AEM Author Service http://localhost:4502 在網頁瀏覽器中

Windows:

$ mkdir -p c:\Users\<My User>\aem-sdk\author
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\author\aem-author-p4502.jar
$ cd c:\Users\<My User>\aem-sdk\author
$ java -jar aem-author-p4502.jar

macOS / Linux :

$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar

設定本機AEM發佈服務

本機AEM發佈服務可為開發人員提供AEM的本機體驗一般使用者將擁有的體驗，例如瀏覽AEM上放置的網站。 本機AEM Publish Service與AEM SDK整合時很重要 Dispatcher工具 並可讓開發人員對最終面向使用者的體驗進行煙霧測試和微調。

1. 建立資料夾 ~/aem-sdk/publish

2. 複製 快速入門JAR 檔案 ~/aem-sdk/publish 將重新命名為 aem-publish-p4503.jar

3. 從命令列執行下列動作，以啟動本機AEM Publish Service:

   • java -jar aem-publish-p4503.jar
     • 提供管理員密碼作為 admin. 任何管理員密碼都是可接受的，但建議使用本機開發的預設密碼，以減少重新設定的需求。

   您 不能 將AEM啟動為Cloud Service快速入門Jar 按兩下.

4. 在存取本機AEM發佈服務 http://localhost:4503 在網頁瀏覽器中

窗口：

$ mkdir -p c:\Users\<My User>\aem-sdk\publish
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\publish\aem-publish-p4503.jar
$ cd c:\Users\<My User>\aem-sdk\publish
$ java -jar aem-publish-p4503.jar

macOS / Linux :

$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar

模擬內容分發

在真正的Cloud Service環境中，內容會使用 Sling內容分送 和Adobe管道。 此 Adobe管道 是孤立的微服務，僅適用於雲端環境。

在開發期間，可能希望使用本機「作者」和「發佈」服務來模擬內容的分佈。 這可以通過啟用舊版複製代理來實現。

1. 登入 作者 服務，並導覽至 http://localhost:4502/etc/replication/agents.author.html.

2. 按一下 預設代理（發佈） 以開啟預設的復寫代理。

3. 按一下 編輯 以開啟代理的配置。

4. 在 設定 頁簽，更新下列欄位：

   • 已啟用 — 檢查true
   • 代理用戶Id — 將此欄位留空

   

5. 在 運輸 頁簽，更新下列欄位：

   • URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
   • 使用者 - admin
   • 密碼 - admin

   

6. 按一下 確定 儲存設定並啟用 預設 復寫代理。

7. 您現在可以變更Author服務上的內容，並發佈至Publish服務。

快速啟動Jar啟動模式

快速入門罐的命名， aem-<tier>_<environment>-p<port number>.jar 指定啟動方式。 AEM在特定層級、製作或發佈中啟動後，就無法變更為替代層級。 若要這麼做， crx-Quickstart 必須刪除在首次運行期間生成的資料夾，並且必須重新運行Quickstart Jar。 環境和埠可以變更，但需要停止/啟動本機AEM執行個體。

不斷變化的環境， dev, stage 和 prod，對於開發人員來說非常有用，以確保AEM正確定義並解析環境特定設定。 建議主要針對預設情況進行地方開發 dev 環境執行模式。

可用的排列如下：

請注意，埠號可以是本地開發電腦上的任何可用埠，但按慣例：

• 埠 4502 用於 本機AEM作者服務
• 埠 4503 用於 本機AEM發佈服務

變更這些項目可能需要調整AEM SDK設定

停止本機AEM執行階段

若要停止本機AEM執行階段（AEM製作或發佈服務），請開啟用來啟動AEM執行階段的命令列視窗，然後點選 Ctrl-C. 等待AEM關閉。 關閉過程完成後，命令行提示將可用。

可選的本地AEM運行時設定任務

• OSGi設定環境變數和機密變數 為 為AEM本機執行階段特別設定，而不是使用aio CLI管理。

何時更新Quickstart Jar

每月至少更新AEM SDK一次，或在每月最後一個星期四(即AEMas a Cloud Service「功能發行」的發行時間)。

升級AEM SDK時如何避免內容遺失

升級AEM SDK可有效建立全新AEM執行階段，包括新的存放庫，這表示對先前AEM SDK的存放庫所做的任何變更都會遺失。 以下是可行的策略，以協助在AEM SDK升級之間持續保存內容，且可分散使用或搭配使用：

1. 建立專用於包含「範例」內容的內容套件，以輔助開發，並在Git中維護。 應透過AEM SDK升級而保存的任何內容都會保存在此套件中，並在升級AEM SDK後重新部署。
2. 使用 oak-upgrade 和 includepaths 指令，將內容從先前的AEM SDK存放庫複製到新的AEM SDK存放庫。
3. 使用AEM Package Manager備份任何內容，並在先前的AEM SDK上使用內容套件，然後在新的AEM SDK上重新安裝。

請記住，使用上述方法在AEM SDK升級之間維護程式碼，表示開發反模式。 非可支配的程式碼應源自您的開發IDE，並透過部署流入AEM SDK。

疑難排解

按兩下Quickstart Jar檔案會導致錯誤

按兩下要啟動的Quickstart Jar時，會顯示錯誤強制回應，使AEM無法在本機啟動。

這是因為AEMas a Cloud ServiceQuickstart Jar不支援按兩下Quickstart Jar以在本機啟動AEM。 而必須從該命令行運行Jar檔案。

若要啟動AEM Author服務， cd 進入包含Quickstart Jar的目錄，然後執行命令：

$ java -jar aem-author-p4502.jar

或者，若要啟動AEM發佈服務， cd 進入包含Quickstart Jar的目錄，然後執行命令：

$ java -jar aem-publish-p4503.jar

從命令行啟動快速啟動Jar會立即中止

從命令行啟動Quickstart Jar時，進程會立即中止，AEM服務不會啟動，出現以下錯誤：

➜  ~/aem-sdk/author: java -jar aem-author-p4502.jar
Loading quickstart properties: default
Loading quickstart properties: instance
java.lang.Exception: Quickstart requires a Java Specification 11 VM, but your VM (Java HotSpot(TM) 64-Bit Server VM / Oracle Corporation) reports java.specification.version=1.8
  at com.adobe.granite.quickstart.base.impl.Main.checkEnvironment(Main.java:1046)
  at com.adobe.granite.quickstart.base.impl.Main.<init>(Main.java:646)
  at com.adobe.granite.quickstart.base.impl.Main.main(Main.java:981)
Quickstart: aborting

這是因為AEM as a Cloud Service需要Java SDK 11，而您執行的是不同版本，很可能是Java 8。 若要解決此問題，請下載並安裝 [OracleJava SDK 11](https://experience.adobe.com/#/downloads/content/software-distribution/en/general.html?1_group.propertyvalues.property=.%2Fjcr%3Acontent%2Fmetadata%2Fdc%3AsoftwareType&1_group.propertyvalues.operation=equals&1_group.propertyvalues.0_values=software-type%3Atoling&fulltext=Oracle%7E+JDK%7E+11%7E&orderby=%40jcr%3Cont%2Fjcr%3Alast&modified by.sort=dest&p.st=dest&p.llep.p.p=14).
安裝Java SDK 11後，從命令列執行下列動作，以確認其為作用中版本。

安裝Java 11 SDK後，從命令列執行命令以確認其為作用中版本：

• Windows: java -version
• macOS / Linux : java --version

其他資源

• 下載AEM SDK
• AdobeCloud Manager
• 下載Docker
• Experience ManagerDispatcher檔案