Adobe Experience Manager(AEM)可透過AEMas a Cloud Service SDK的Quickstart Jar在本機執行。 這可讓開發人員在將自訂程式碼、設定和內容提交至原始碼控制項之前,先進行部署和測試,然後將其部署至AEMas a Cloud Service環境。
請注意 ~
用作用戶目錄的簡稱。 在Windows中,這等同於 %HOMEPATH%
.
Experience Manager是Java應用程式,因此需要Java SDK支援開發工具。
java -version
java --version
AEMas a Cloud ServiceSDK(或AEM SDK)包含用於在本機執行AEM製作和發佈以供開發的Quickstart Jar,以及相容的Dispatcher工具版本。
aem-sdk-XXX.zip
檔案本機AEM作者服務可為開發人員提供本機體驗,供數位行銷人員/內容作者共用,以建立和管理內容。 AEM Author Service的設計目的,是要同時提供製作和預覽環境,讓您能針對其執行大部分的功能開發驗證,成為本機開發程式的重要元素。
建立資料夾 ~/aem-sdk/author
複製 快速入門JAR 檔案 ~/aem-sdk/author
將重新命名為 aem-author-p4502.jar
從命令列執行下列動作,以啟動本機AEM Author Service:
java -jar aem-author-p4502.jar
admin
. 任何管理員密碼都是可接受的,但建議使用本機開發的預設密碼,以減少重新設定的需求。您 不能 將AEM啟動為Cloud Service快速入門Jar 按兩下.
在存取本機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 Publish Service與AEM SDK整合時很重要 Dispatcher工具 並可讓開發人員對最終面向使用者的體驗進行煙霧測試和微調。
建立資料夾 ~/aem-sdk/publish
複製 快速入門JAR 檔案 ~/aem-sdk/publish
將重新命名為 aem-publish-p4503.jar
從命令列執行下列動作,以啟動本機AEM Publish Service:
java -jar aem-publish-p4503.jar
admin
. 任何管理員密碼都是可接受的,但建議使用本機開發的預設密碼,以減少重新設定的需求。您 不能 將AEM啟動為Cloud Service快速入門Jar 按兩下.
在存取本機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
本機AEM執行階段可在 預發行模式 可讓開發人員根據AEM as a Cloud Service的下一版功能進行建置。 若要啟用發行前版本,請將 -r prerelease
本機AEM執行階段首次開始的引數。 這可與本機AEM製作和AEM發佈服務搭配使用。
# 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環境中,內容會使用 Sling內容分送 和Adobe管道。 此 Adobe管道 是孤立的微服務,僅適用於雲端環境。
在開發期間,可能希望使用本機「作者」和「發佈」服務來模擬內容的分佈。 這可以通過啟用舊版複製代理來實現。
複製代理僅可在本地Quickstart JAR中使用,並僅提供內容分發的模擬。
登入 作者 服務,並導覽至 http://localhost:4502/etc/replication/agents.author.html.
按一下 預設代理(發佈) 以開啟預設的復寫代理。
按一下 編輯 以開啟代理的配置。
在 設定 頁簽,更新下列欄位:
在 運輸 頁簽,更新下列欄位:
http://localhost:4503/bin/receive?sling:authRequestLogin=1
admin
admin
按一下 確定 儲存設定並啟用 預設 復寫代理。
您現在可以變更Author服務上的內容,並發佈至Publish服務。
快速入門罐的命名, aem-<tier>_<environment>-p<port number>.jar
指定啟動方式。 AEM在特定層級、製作或發佈中啟動後,就無法變更為替代層級。 若要這麼做, crx-Quickstart
必須刪除在首次運行期間生成的資料夾,並且必須重新運行Quickstart Jar。 環境和埠可以變更,但需要停止/啟動本機AEM執行個體。
不斷變化的環境, dev
, stage
和 prod
,對於開發人員來說非常有用,以確保AEM正確定義並解析環境特定設定。 建議主要針對預設情況進行地方開發 dev
環境執行模式。
可用的排列如下:
快速啟動Jar檔案名 | 模式說明 |
---|---|
aem-author-p4502.jar |
在埠4502上以開發運行模式作為作者 |
aem-author_dev-p4502.jar |
在埠4502上以開發執行模式製作(與 aem-author-p4502.jar ) |
aem-author_stage-p4502.jar |
在4502埠的測試執行模式中作為作者 |
aem-author_prod-p4502.jar |
在埠4502的「生產」運行模式中作為作者 |
aem-publish-p4503.jar |
在埠4503上以開發運行模式發佈 |
aem-publish_dev-p4503.jar |
在埠4503上以開發執行模式發佈(與 aem-publish-p4503.jar ) |
aem-publish_stage-p4503.jar |
在連接埠4503上以測試運行模式發佈 |
aem-publish_prod-p4503.jar |
在埠4503上以生產運行模式發佈 |
請注意,埠號可以是本地開發電腦上的任何可用埠,但按慣例:
變更這些項目可能需要調整AEM SDK設定
若要停止本機AEM執行階段(AEM製作或發佈服務),請開啟用來啟動AEM執行階段的命令列視窗,然後點選 Ctrl-C
. 等待AEM關閉。 關閉過程完成後,命令行提示可用。
每月至少更新AEM SDK一次,或在每月最後一個星期四(即AEMas a Cloud Service「功能發行」的發行時間)。
將Quickstart Jar更新到新版本需要替換整個本地開發環境,從而導致本地AEM儲存庫中的所有代碼、配置和內容丟失。 請確定任何不應銷毀的程式碼、設定或內容都能安全提交至Git,或從本機AEM例項匯出為AEM Packages。
升級AEM SDK可有效建立全新AEM執行階段,包括新的存放庫,這表示對先前AEM SDK的存放庫所做的任何變更都會遺失。 以下是可行的策略,以協助在AEM SDK升級之間持續保存內容,且可分散使用或搭配使用:
includepaths
指令,將內容從先前的AEM SDK存放庫複製到新的AEM SDK存放庫。請記住,使用上述方法在AEM SDK升級之間維護程式碼,表示開發反模式。 非可支配的程式碼應源自您的開發IDE,並透過部署流入AEM SDK。
按兩下要啟動的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
從命令行啟動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後,從命令列執行命令以確認其為作用中版本:
java -version
java --version