AEMas a Cloud ServiceSDK建置Analyzer Maven外掛程式

AEMas a Cloud ServiceSDK建置Analyzer Maven外掛程式會分析各種內容套件專案的結構。

請參閱 Maven外掛程式檔案 以取得如何將其納入AEM maven專案的資訊。

注意

建議您更新Maven專案,以參考Maven中央存放庫中此位置的最新外掛程式版本:https://repo1.maven.org/maven2/com/adobe/aem/aemanalyser-maven-plugin/

外掛程式會使用最新可用的SDK,而非專案中設定的SDK。

下表說明在此步驟中執行的分析器。

模組 函式、範例和疑難排解 本機SDK Cloud Manager
api-regions-exportsimports 檢查所有OSGI套件組合是否都有其Import-Package聲明由Maven項目中其他包含套件組合的Export-package聲明滿足。 錯誤看起來會像這樣:

 

[ERROR] org.acme:mybundle:0.0.1-SNAPSHOT: Bundle org.acme:mybundle:0.0.1-SNAPSHOT is importing package(s) org.acme.foo in start level 20 but no bundle is exporting these for that start level.

 

若要進行疑難排解,請查看提供套件的套件組合是否包含在部署中,或查看您要匯出的套件組合資訊清單,以判斷使用的名稱是否錯誤或版本是否錯誤。
bundle-unversioned-packages 檢查OSGi套件組合是否指定具有「匯出套件」聲明的版本,以及具有「匯入套件」聲明的版本範圍。 錯誤看起來會像這樣:

 

[ERROR] org.acme:mybundle:0.0.1-SNAPSHOT: Bundle org.acme:mybundle:0.0.1-SNAPSHOT is exporting package org.acme.foo without a version.

 

若要疑難排解,請務必新增 package-info.java 指定要匯出的版本的套件。
requirements-capabilities 檢查在OSGI套件組合中生成的所有要求聲明是否由Maven項目中包含的其他套件組合的功能聲明滿足。 錯誤看起來會像這樣:

 

[ERROR] org.acme:mybundle:0.0.1-SNAPSHOT: Artifact org.acme:mybundle:0.0.1-SNAPSHOT requires org.foo.bar in start level 20 but no artifact is providing a matching capability in this start level.

 

若要進行疑難排解,請查看您希望聲明功能以確定為何缺少該功能的套件清單,或檢查需要套件的清單,以確認其中的要求正確。
bundle-content 如果套件組合包含以Sling-Initial-Content指定的初始內容,則會發出警告,這在AEMas a Cloud Service叢集環境中會造成問題。 警告看起來像這樣:

 

[WARNING] org.acme:mybundle:0.0.1-SNAPSHOT: Found initial content : [/]

 

若要疑難排解將初始內容轉換為重新指向陳述式,請參閱重新指向檔案。
bundle-resources 如果套件組合包含以Sling-Bundle-Resources標頭指定的資源,則會發出警告,這在AEMas a Cloud Service叢集環境中會造成問題。 警告看起來像這樣:

 

[WARNING] org.acme:mybundle:0.0.1-SNAPSHOT: Found bundle resources : [/libs/sling/explorer!/resources/explorer]

 

若要疑難排解將資源轉換為重新指向陳述式,請參閱 重新指向檔案.
api-regions

 

api-regions-check-order

 

api-regions-dependencies

 

api-regions-duplicates
這些分析器會檢查與 內容包到特徵模型轉換過程 會建立符合Sling特徵模型的工件。 應將任何錯誤報告給Adobe客戶支援。
api-regions-crossfeature-dups 驗證客戶OSGI套件組合沒有覆寫AEMas a Cloud Service之公用API的匯出套件宣告

 

[WARNING] org.acme:mybundle:0.0.1-SNAPSHOT: Package overlap found between region global and bundle org.acme:mybundle:0.0.1.SNAPSHOT which comes from feature: [org.acme:myproject.analyse:slingosgifeature:0.0.1-SNAPSHOT]. Both export package: com.day.util

 

若要修正,請停止匯出屬於AEM公用API一部分的套件。
repoinit 檢查所有重新指向節的語法
bundle-nativecode 驗證OSGI套件組合不安裝原生程式碼。
configuration-api 驗證重要的OSGi設定。

 

Configuration org.apache.felix.webconsole.internal.servlet.OsgiManager: Configuration is not allowed (com.mysite:mysite.all:1.0.0-SNAPSHOT|com.mysite:mysite.ui.config:1.0.0-SNAPSHOT)
region-deprecated-api 檢查 棄用的api 已使用

 

[WARNING] com.mysite:mysite.core:1.0.0-SNAPSHOT: Usage of deprecated package found : org.apache.sling.settings : Avoid these features at runtime: run modes, file system access (com.mysite:mysite.all:1.0.0-SNAPSHOT)
artifact-rules 驗證相依性(例如套件組合和內容套件),以防止成品中的已知問題。

 

[WARNING] [artifact-rules] com.adobe.acs:acs-aem-commons-bundle:5.0.4: Use at least version 5.0.10 (com.mysite:mysite.all:1.0.0-SNAPSHOT)
aem-env-var 根據 變數命名指南

 

[ERROR] Configuration org.apache.felix.webconsole.internal.servlet.OsgiManager: Value for property 'port' must not use env vars prefixed with INTERNAL_ or ADOBE_ (com.mysite1:my-site-1.all:1.0.0-SNAPSHOT|com.mysite1:my-site-1.ui.config:1.0.0-SNAPSHOT)
content-package-validation 執行檔案驗證器。 預設會啟用jackrabbit-docviewparser,以檢查部署期間所安裝之套件內xml的正確格式內容語法。

 

[main] WARN org.apache.sling.feature.analyser.task.impl.CheckContentPackages - ValidationViolation: "jackrabbit-docviewparser: Invalid XML found: The reference to entity "se" must end with the ';' delimiter.", filePath=jcr_root/apps/somename/configs/com.adobe.test.Invalid.xml, nodePath=/apps/somename/configs/com.adobe.test.Invalid

 

要修復,請檢查由分析器命名的檔案,以了解xml問題。

已知問題

以下是使用Build Analyzer Maven外掛程式時的已知問題清單。

無法在本機SDK中執行Build Analyzer Maven外掛程式

將本機SDK與Build Analyzer Maven外掛程式版本比 1.1.2,執行外掛程式可能會導致下列錯誤。 在此情況下,請將您的專案更新為最新版外掛程式。

[ERROR] Failed to execute goal com.adobe.aem:aemanalyser-maven-plugin:1.1.0:analyse (default-analyse) on project mysite.analyse: Execution default-analyse of goal com.adobe.aem:aemanalyser-maven-plugin:1.1.0:analyse failed: arraycopy: source index -1 out of bounds for char[65536] -> [Help 1]

如果您使用AEM專案原型來設定專案,請務必調整根Maven中的屬性 pom.xml 比如下面。

   ...
   <properties>
      ...
      <aemanalyser.version>1.1.2</aemanalyser.version> <!-- Make sure to use the latest release -->
      ...
   </properties>

本頁內容