文件AEM as a Cloud Service使用手冊

Adobe Experience Manager as a Cloud Service 發行前通道 prerelease-channel

Last update: Tue Jun 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 適用對象：
  • Experience Manager as a Cloud Service
  • 主題：

建立對象：

  • 管理員

了解如何使用發行前通道來取得即將推出的 AEM as a Cloud Service 功能預覽。

簡介 introduction

Adobe Experience Manager as a Cloud Service會定期提供新功能。 特定功能發行版本的新功能及即將推出的功能清單已發佈在發行說明中。

即將推出的功能通常以下列兩種方式之一提供：

  • 作為率先採用者計畫的一部分
  • 作為發行前管道的一部分

本檔案說明如何啟用發行前通道。 發行前通道可讓您存取將在AEM的未來功能版本中推出的早期功能。 這讓您有機會驗證新功能，並在未來發行前規劃採用。 如需Adobe Experience Manager (AEM) as a Cloud Service🔗發行排程的詳細資訊，請參閱檔案AEM發行說明。

啟用發行前通道以存取及試用即將推出的功能 enable-prerelease

可以在任何開發或沙箱環境中啟用發行前通道。中繼或生產環境中無法啟用發行前通道。

有兩種不同的方式可存取發行前通道：

雲端環境 cloud-environments

若要更新雲端環境以使用發行前通道，您必須新增一個環境變數。 您可以使用 Cloud Manager UI 或透過 CLI 執行此操作。

使用 UI 新增環境變數 add-with-ui

  1. 在 my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。

  2. 瀏覽至您要啟用發行前通道的程式。

  3. 選取您要啟用發行前通道的環境，並透過​ 方案 > 環境 > 環境設定 ​存取其設定。

  4. 新增一個新的環境變數

    table 0-row-4 1-row-4
    名稱 值 套用的服務 類型
    AEM_RELEASE_CHANNEL prerelease 全部 變數

  5. 儲存變更，環境將在啟用發行前通道後重新整理。

    新環境變數

使用 CLI 新增環境變數 add-with-cli

您也可以使用 Cloud Manager API 和 CLI 來更新環境變數。

  • 使用 Cloud Manager API 的環境變數端點，將 AEM_RELEASE_CHANNEL 環境變數設定為值 prerelease。

    code language-text 
    PATCH /program/{programId}/environment/{environmentId}/variables
[
        {
                "name" : "AEM_RELEASE_CHANNEL",
                "value" : "prerelease",
                "type" : "string"
        }
]

  • 也可以使用 Cloud Manager CLI

    code language-shell 
    aio cloudmanager:environment:set-variables <ENVIRONMENT_ID> --programId=<PROGRAM_ID> --variable AEM_RELEASE_CHANNEL "prerelease

如果您想要將環境還原為標準行為（非發行前通道），可以刪除變數。

本機 SDK local-sdk

您可以在本機快速入門SDK的發行前通道中存取即將推出的功能，並藉由設定您的Maven專案來參照位於Maven Central的發行前通道API Jar，針對新API進行編碼。 您也可以透過在發行前模式下啟動一般快速入門SDK，在本機開發環境中檢視存取發行前通道。

在發行前模式下啟動快速入門 SDK prerelease-mode

  1. 從軟體散發及安裝下載SDK，如存取AEM as a Cloud Service SDK中所述。
  2. 啟動 SDK 快速入門時，請包含引數 -r prerelease。

值為 sticky，因此只能在第一次啟動時選取它。重新安裝 SDK 以變更命令列選項。

由於每月功能發行之間可能會有多個 AEM 維護版本，因此您可以下載這些新的 SDK 並在 maven 專案中參照新的 SDK API Jar 版本。維護版本不會新增其他發行前功能，但可能包括其他較小幅的變更，例如錯誤修正、安全性修正和效能增強。
Javadoc 會發佈到 Maven Central。

針對發行前 SDK 進行建置 build-sdk

  1. 修改您的 Maven 專案的 pom.xml 以參照獨特的發行前 SDK API jar，這個檔案已發佈到 Maven Central。它包含用於發行前功能的任何新 Java API，並且相依於 SDK API jar。它使用相同的版本。

    例如，這裡是參照一般 API jar 的父系 pom 的相依性管理區段中的片段：

    code language-none 
    <dependencyManagement>
 <dependencies>
     <dependency>
         <groupId>com.adobe.aem</groupId>
         <artifactId>aem-sdk-api</artifactId>
         <version>${aem.sdk.api}</version>
         <scope>provided</scope>
     </dependency>

    然後是模組中的用法：

    code language-none 
     <dependencies>
  <dependency>
      <groupId>com.adobe.aem</groupId>
      <artifactId>aem-sdk-api</artifactId>
  </dependency>

    若要變更為發行前 SDK，只需將相依性從 com.adobe.aem:aem-sdk-api 變更為 com.adobe.aem:aem-prerelease-sdk-api，如下所述：

    code language-none 
    <dependencyManagement>
 <dependencies>
   <dependency>
         <groupId>com.adobe.aem</groupId>
         <artifactId>aem-prerelease-sdk-api</artifactId>
         <version>${aem.sdk.api}</version>
         <scope>provided</scope>
   </dependency>
<dependencies>
   <dependency>
      <groupId>com.adobe.aem</groupId>
      <artifactId>aem-prerelease-sdk-api</artifactId>
   </dependency>

    如同往常，個別專案可以使用相依性。

  2. 部署到您的本機伺服器。

  3. 如果滿意它在本機如預期般運作，請將程式碼提交至開發分支，並使用Cloud Manager非生產管道來部署至已啟用發行前通道的環境。

CAUTION
部署到中繼或生產環境時，絕不能使用 aem-prerelease-sdk-api artifactId。透過生產管道部署時，請一律使用 aem-sdk-api。同樣地，參照發行前 API 的程式碼不應該透過生產管道進行部署。

AEM CS SDK Build Analyzer Maven 外掛程式 v1.0 及更高版本將透過檢查相依性來偵測專案中是否使用了發行前 API。如果該分析器有找到，它將使用發行前 SDK API 來分析專案。

考量事項 considerations

使用發行前通道時，需要注意幾個事項。

  • 發行前通道不一定包含所有將在下一版中推出的新功能。
  • 發行前版本中的功能經過嚴格的品質保證，旨在提供完整的功能而不是測試版品質。如果您發現任何問題，請提報，就像您在懷疑一般 AEM 版本中的功能存在錯誤時所做的。
  • 若要判斷是否為發行前通道設定了環境，請前往AEM主控台的​ 關於 ​頁面，並檢查AEM版本號碼是否包含PRERELEASE尾碼，例如Adobe Experience Manager 2021.4.5226.20210427T070726Z-210429-PRERELEASE。

關於

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab