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外掛程式版本比 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>