AEMas a Cloud ServiceSDK建置分析器Maven外掛程式 maven-analyzer-plugin

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

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

NOTE
建議您更新Maven專案,以參考中的最新版外掛程式 Maven中央存放庫。

外掛程式使用最新可用的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 : [/]

若要進行疑難排解,請參閱Repoinit檔案,將初始內容轉換為repoinit陳述式。

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]

若要進行疑難排解,請參閱將資源轉換為repoinit陳述式 Repoinit檔案.

api-regions

api-regions-check-order

api-regions-dependencies

api-regions-duplicates

這些分析器會檢查與 從內容套件轉換至功能模型的程式 建立符合Sling功能模型的成品。 任何錯誤都應向Adobe客戶支援回報。
api-regions-crossfeature-dups

驗證客戶OSGi套件組合沒有會覆寫AEMas a Cloud Service公用API的Export-package宣告

[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
檢查所有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

執行Filevault驗證器。 依預設,會啟用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中執行組建分析器Maven外掛程式

搭配使用本機SDK時,組建分析器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>
recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c