設定本機AEM執行階段

Adobe Experience Manager (AEM) 可透過 AEM as a Cloud Service SDK 的 Quickstart Jar 在本機上執行。如此一來，開發人員就能在將自訂程式碼、設定和內容送交來源控制項前，先行部署和測試，然後再部署至 AEM as a Cloud Service 環境。

請注意 ~ 用作使用者目錄的簡寫。 在Windows中，這相當於 %HOMEPATH%.

安裝Java

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

1. 下載並安裝最新的Java SDK 11
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 ServiceSDK。
2. 導覽至 AEMas a Cloud Service 標籤
3. 排序方式 發佈日期 在 降序 訂購
4. 按一下最新的 AEM SDK 結果列
5. 檢閱並接受EULA，然後點選 下載 按鈕

從AEM SDK zip解壓縮Quickstart Jar

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

設定本機AEM作者服務

本機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作者服務，網址為 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 Publish服務

本機AEM Publish Service為開發人員提供AEM的本機體驗使用者將擁有的體驗，例如瀏覽存放在AEM上的網站。 本機AEM Publish服務非常重要，因為它與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 Publish Service，網址為 http://localhost:4503 在網頁瀏覽器中

Windows:

$ 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

在發行前模式下設定本機AEM服務

本機AEM執行階段可以啟動 發行前模式 允許開發人員針對AEMas a Cloud Service的下一版本功能進行建置。 透過傳遞以下專案來啟用發行前： -r prerelease 引數在本機AEM執行階段第一個開頭。 這可同時用於本機AEM Author和AEM Publish服務。

# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease

模擬內容發佈

在真實的Cloud Service環境中，內容會使用從Author Service散發到Publish Service Sling內容發佈 和Adobe管道。 此 Adobe管道 是僅可用於雲端環境的獨立微服務。

在開發期間，可能最好使用本機Author和Publish服務來模擬內容的分發。 這可透過啟用舊版復寫代理程式來達成。

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啟動模式

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

不斷變化的環境， dev， stage 和 prod對於開發人員來說，這有助於確保環境特定的設定可由AEM正確定義和解析。 建議主要針對預設值執行本機開發 dev 環境執行模式。

可用的排列如下：

請注意，連線埠號碼可以是本機開發機器上任何可用的連線埠，但依照慣例：

• 連線埠 4502 用於 本機AEM作者服務
• 連線埠 4503 用於 本機AEM Publish服務

若要變更這些專案，可能需要調整AEM SDK設定

停止本機AEM執行階段

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

選擇性本機AEM執行階段設定工作

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

何時更新快速入門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 SDK上的AEM Package Manager和內容套件備份任何內容，並在新的AEM SDK上重新安裝它們。

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

疑難排解

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

按兩下「快速入門Jar 」以開始時，會顯示錯誤強制回應視窗，防止AEM在本機啟動。

這是因為AEMas a Cloud Service快速入門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」會立即中止

從命令列啟動「快速入門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

這是因為AEMas a Cloud Service需要Java SDK 11，而您執行的是其他版本，很可能是Java 8。 若要解決此問題，請下載並安裝 oracleJava SDK 11.
安裝Java SDK 11後，從命令列執行下列動作，確認其為作用中版本。

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

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

其他資源

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

Business.Adobe.com 資源

Multichannel Communication Targeted Content Asset Collections Content Intelligence Mobile Forms Responsive Forms