AEM as a Cloud Service SDK aem-as-a-cloud-service-sdk

AEM as a Cloud Service SDK由下列成品組成:

  • 快速入門Jar — 用於本機開發的AEM執行階段。
  • Java™ API Jar — 此Java™ Jar/Maven相依性會公開所有可用於針對AEM as a Cloud Service開發的允許Java™ API。 先前稱為Uberjar。
  • Javadoc Jar - Java™ API Jar的Java檔案。
  • Dispatcher工具 — 用來在本機針對Dispatcher開發的工具集。 為UNIX®和Windows分隔成品。

此外,部分先前已部署AEM 6.5或更早版本的客戶則使用下列成品。 如果本機編譯無法搭配QuickStart Jar使用,並且您懷疑它來自從AEM部署的as a Cloud Service移除介面,請聯絡客戶支援。 他們可決定您是否需要存取權。 它需要在後端進行變更。

  • 6.5已棄用的Java™ API Jar — 自AEM 6.5起已移除的額外一組介面。
  • 6.5已棄用的Javadoc Jar — 此額外一組介面的Java檔案。
NOTE
AEM as a Cloud Service和SDK在許多不同方面有所差異。 對於需要快速反複變更的情況,Adobe已推出快速開發環境。 如需詳細資訊,請檢視快速開發環境

為SDK建立 building-for-the-sdk

AEM as a Cloud Service SDK可用來建置和部署自訂程式碼。 請參閱AEM專案原型檔案。 基本上,會執行下列步驟:

  • 編譯程式碼 — 已編譯Source程式碼,產生產生的內容封裝。
  • 建置成品 — 在此過程中建置成品。
  • 分析組合 — 使用Maven分析器外掛程式分析組合,這會尋找Maven專案中的問題,例如遺漏相依性。
  • 部署成品 — 將成品部署到本機伺服器。

Cloud Manager在部署至雲端環境時會執行相同的步驟。 在本機執行組建可允許本機開發和測試。 開發人員在提交至原始檔控制之前,可以有效地識別程式碼或結構問題。 此程式有助於防止因觸發Cloud Manager部署而造成的延遲,因為部署需要更長的時間。

NOTE
AEM as a Cloud Service SDK應該以Cloud Manager的組建環境所支援的Java散發和版本來建置。 AEM as a Cloud Service客戶可從軟體發佈入口網站下載Oracle JDK。 由於Adobe針對Adobe Experience Manager專案中的Oracle Java技術提供的授權和支援條款,他們的Java 11支援已延長至2026年9月。

存取AEM as a Cloud Service SDK accessing-the-aem-as-a-cloud-service-sdk

  • 您可以檢視AEM Admin Console的​ 關於Adobe Experience Manager ​圖示,瞭解您正在生產環境中執行的AEM版本。
  • 可以從軟體發佈入口網站下載QuickStart Jar和Dispatcher工具的ZIP檔。 SDK清單的存取權僅限於AEM Managed Services或AEM as a Cloud Service上擁有環境的人員。
  • Java™ API Jar和Javadoc Jar可以透過Maven工具(命令列或您偏好的IDE)下載。
  • Maven專案Pom應該參照以下API Jar套件。 任何子封裝pom的相依性也都應參考。
<dependency>
  <groupId>com.adobe.aem</groupId>
  <artifactId>aem-sdk-api</artifactId>
  <version>2019.11.3006.20191108T223635Z-191201</version>
  <scope>provided</scope>
</dependency>
NOTE
SDK的版本專案應符合AEM as a Cloud Service的版本。 您可以登入AEM,檢視目前使用的版本。 在熒幕的右上角,前往問號並按一下​ 關於Adobe Experience Manager

使用新的SDK版本重新整理本機專案 refreshing-a-local-project-with-a-new-skd-version

何時建議使用新的SDK重新整理本機專案?

Adobe 建議 ​在每月維護發行後重新整理。

任何每日維護版本發行後,可選擇 ​重新整理。 當客戶的生產執行個體成功升級至新的AEM版本時,系統會通知客戶。 對於每日維護發行,新的SDK可能不會有重大變更,如果有的話。 不過,Adobe建議您偶爾使用最新的SDK重新整理本機AEM開發人員環境,然後重建並測試自訂應用程式。 每月維護發行通常會包含更具影響力的變更,因此開發人員應立即重新整理、重建和測試。

若要使用新的SDK版本重新整理本機專案:

  1. 請確定所有有用的內容都已認可給原始檔控制。 或者,儲存在可變動的內容套件中,以供稍後匯入。
  2. 本機開發測試內容必須分開儲存,這樣它就不會部署為Cloud Manager管道建置的一部分。 原因是它只用於本機開發。
  3. 停止目前執行中的快速入門。
  4. crx-quickstart資料夾移至其他資料夾,以便安全儲存。
  5. 請注意新的AEM版本,Cloud Manager中註明了該版本(用於識別新的QuickStart Jar版本以供進一步下載)。
  6. 從軟體發佈入口網站下載版本符合生產AEM版本的QuickStart Jar。
  7. 建立全新的資料夾,並將新的QuickStart Jar放進去。
  8. 以所需的執行模式(重新命名檔案或透過-r在執行模式中傳遞)啟動新的QuickStart。
    請確定資料夾中沒有舊快速入門的殘餘。
  9. 建置您的AEM應用程式。
  10. 透過封裝管理程式,將您的AEM應用程式部署到本機AEM。
  11. 透過「封裝管理員」安裝本機環境測試所需的任何可變內容封裝。
  12. 視需要繼續開發及部署變更。

如果有內容應隨每個新的AEM快速入門版本一起安裝,請將其納入內容套件和專案的原始檔控制中。 然後,每次都進行安裝。

Adobe建議您經常更新SDK,例如每兩週。 此外,請每天處理完整的本機狀態,以免在應用程式中意外依賴有狀態資料。

如果您使用雲端服務的CryptoSupport、SMTP郵件設定或CryptoSupport API,加密的屬性會以金鑰保護。 CryptoSupport API檔案中有更多詳細資料。 此金鑰會在AEM環境首次啟動時自動產生。 雖然雲端設定會負責自動重複使用環境特定的CryptoKey,但必須將密碼金鑰插入本機開發環境中。

依預設,AEM設定為將關鍵資料儲存在資料夾的資料夾中,但為了方便在開發中重複使用,AEM程式可以在第一次啟動時使用"-Dcom.adobe.granite.crypto.file.disable=true"初始化。 此程式會在"/etc/key"產生加密資料。

若要重複使用包含加密值的內容套件:

  • 當您初次啟動本機quickstart.jar時,請務必新增以下引數:"-Dcom.adobe.granite.crypto.file.disable=true"。 Adobe可選擇性地建議您一律新增此功能。
  • 第一次啟動執行個體時,請建立包含根"/etc/key"篩選器的套件。 此套件內含要在所有您想要重複使用的環境中重複使用的秘密。
  • 匯出任何包含密碼的可變內容。 或者,您可以透過/crx/de查詢加密的值,以便將其新增到安裝時重複使用的套件中。
  • 每當您啟動新的執行個體時(若要以新版本取代,或多個開發環境應共用認證進行測試),請安裝步驟2和3中產生的套件。 如此可讓您重複使用內容,而不需要手動重新設定。 原因是現在密碼金鑰處於同步中。
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab