AEM as a Cloud Service SDK

AEMas a Cloud ServiceSDK由下列成品組成：

  • 快速入門Jar — 用於本機開發的AEM執行階段
  • Java API Jar — 此Java Jar/Maven相依性會公開所有允許的Java API，這些API可用於針對AEM開發作為Cloud Service。 先前稱為Uberjar
  • Javadoc Jar - Java API Jar的Javadocs
  • 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 — 其他已連線程式集的Javadoc

針對SDK進行建置

AEMas a Cloud ServiceSDK可用來建置和部署自訂程式碼。 如需詳細資訊，請參閱 AEM專案原型檔案. 基本上，會執行下列步驟：

  • 編譯程式碼. 如預期般編譯原始程式碼，產生結果內容套件
  • 建置成品. 在此過程中會建立成品
  • 分析套件組合. 套件組合會使用Maven分析器外掛程式進行分析，外掛程式會尋找Maven專案中的問題，例如遺漏相依性
  • 部署成品. 成品會部署至本機伺服器。

Cloud Manager在部署至雲端環境時也會執行相同的步驟。 在本機執行組建可進行本機開發和測試，讓開發人員在認可原始檔控制並觸發Cloud Manager部署（可能需要更長時間）之前，就能有效率地發現程式碼或結構問題。

存取AEMas a Cloud ServiceSDK

  • 您可以檢查AEMAdmin Console 關於Adobe Experience Manager 圖示來瞭解您正在生產環境中執行的AEM版本。
  • 快速入門jar和Dispatcher工具可以從 軟體發佈入口網站. 請注意，存取SDK清單的許可權僅限於具有AEM Managed Services或AEMas 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>
注意

SDK的版本專案應符合AEMas a Cloud Service的版本。 您可以登入AEM，然後前往畫面右上角的問號並選取「 」，檢視您使用的版本 關於Adobe Experience Manager

使用新SDK版本重新整理本機專案

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

它是 建議 至少在每月維護發行後重新整理。

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

以下是重新整理本機環境的建議程式：

  1. 請確定已將任何有用的內容提交到原始檔控制中的專案，或是可在可變內容套件中取得，以便稍後匯入
  2. 本機開發測試內容需要單獨儲存，這樣它就不會部署為Cloud Manager管道構建的一部分。 這是因為它只需要用於本機開發
  3. 停止目前執行中的快速入門
  4. 移動 crx-quickstart 資料夾放入不同的資料夾以便安全儲存
  5. 記下新的AEM版本，在Cloud Manager中記錄（這將用於識別新的QuickStart Jar版本以供進一步下載）
  6. 從軟體發佈入口網站下載版本符合生產AEM版本的QuickStart JAR
  7. 建立全新的資料夾，並將新的QuickStart Jar放入
  8. 使用所需的執行模式啟動新的QuickStart （重新命名檔案或透過以下方式傳入執行模式） -r)。
    • 確定資料夾中沒有遺留的舊快速入門。
  9. 建置您的AEM應用程式
  10. 透過PackageManager將您的AEM應用程式部署到本機AEM
  11. 透過PackageManager安裝本機環境測試所需的任何可變內容套件
  12. 視需要繼續開發及部署變更

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

建議時常更新SDK （例如每兩週），並每天處置完整的本機狀態，以免意外依賴應用程式中的狀態資料。

如果您依賴CryptoSupport (藉由在AEM中設定Cloudservices或SMTP郵件服務的認證，或在您的應用程式中使用CryptoSupport API)，則加密的屬性將會以在AEM環境首次啟動時自動產生的金鑰加密。 雖然cloudsetup會負責自動重複使用環境特定的CryptoKey，但必須將密碼金鑰插入本機開發環境中。

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

若要能夠重複使用包含加密值的內容套件，您需要遵循以下步驟：

  • 當您最初啟動本機quickstart.jar時，請務必新增以下引數： 」-Dcom.adobe.granite.crypto.file.disable=true「。 建議一律新增此專案，但可省略。
  • 第一次啟動執行個體時，請建立包含根「 」篩選器的套件/etc/key「。 這會將密碼儲存在您希望重複使用的所有環境中重複使用
  • 匯出任何包含密碼的可變內容，或透過以下方式查詢加密值： /crx/de 以將其新增至將在安裝中重複使用的套件
  • 每當您啟動新的執行個體時（或是以新版本取代，或是多個開發環境應共用憑證以進行測試），請安裝步驟2和3中產生的套件，以便能夠重複使用內容，而無需手動重新設定。 這是因為加密金鑰現在處於同步狀態。

本頁內容