在Adobe Experience Manager as a Cloud Service中升級aem.js範本

本文提供在Adobe Experience Manager as a Cloud Service中升級aem.js範本的指引,著重說明相容性考量、工作流程影響和建議的最佳做法。

說明 description

環境

Adobe Experience Manager as a Cloud Service (所有版本),aem.js指令碼v3.0.0-v3.1.8

問題/症狀

  • 您要將上游變更合併到aem.js的現有專案中。
  • 在合併變更之前,您需要檢查對自訂區塊、指令碼、預覽或發佈的影響。

原因

AEM範本是入門專案。 對上游樣板的變更不會自動更新現有的專案;開發人員會檢閱變更並將變更整合到他們的專案存放庫中。 專案特定行為屬於aem.js以外的擴充功能,而非程式庫的本機修改。

解決方法 resolution

請依照下列步驟解決問題:

  1. 檢閱版本3.0.0與3.1.8之間aem.js樣板中匯入的變更。

  2. 驗證您的實作是否使用版本3.1.0。 此發行版本引入重大變更,從decorateSections()中移除章節中繼資料處理。 此變更被識別為回歸,並在版本3.1.1中還原。

  3. 如果您的實作使用版本3.1.0,請升級至版本3.1.1或更新版本,以還原區段中繼資料處理。

  4. 檢閱版本3.1.1透過3.1.8匯入的變更。 這些版本包括相依性更新和微幅修正,例如解決重複頁首和頁尾區塊並更新程式碼路徑解析。

  5. 評估對實作的影響,並確認沒有重大變更會影響發佈、預覽或區塊轉譯工作流程。 除了版本3.1.0中的回歸之外,在這些工作流程中未識別出任何重大變更。

  6. 升級前驗證功能分支中的變更。 設定分支以使用預覽環境,並在推送更新後的程式碼後檢閱變更。

  7. 發佈變更之前,請先在本機測試變更。 使用AEM CLI來擷取內容及驗證更新。 下列指令可協助您在發佈前檢閱變更:

    code language-none
    aem content clone
    aem up
    aem content diff
    aem content push --dry-run
    
  8. 設定主要分支的分支保護規則,並在合併變更前要求提取請求、狀態檢查和最新的分支。 這有助於確保所有變更在到達生產環境之前都會在預覽環境中檢閱和驗證。

  9. 升級之後,在本機和預覽環境中徹底測試自訂區塊和指令碼相依性,以驗證相容性。

  10. 確認發佈、預覽、區塊呈現、區段中繼資料處理、自訂區塊和指令碼相依性在升級後是否如預期般運作。

recommendation-more-help
experience-cloud-kcs-help-kbarticles