AEM as a Cloud Service SDK Build Analyzer Maven 플러그인

AEM as a Cloud Service SDK Build Analyzer Maven 플러그인은 다양한 컨텐츠 패키지 프로젝트의 구조를 분석합니다.

AEM Maven 프로젝트에 포함하는 방법에 대한 자세한 내용은 Maven 플러그인 설명서 를 참조하십시오.

노트

다음 위치에서 Maven 중앙 리포지토리에 있는 플러그인의 최신 버전을 참조하도록 Maven 프로젝트를 업데이트하는 것이 좋습니다. https://repo1.maven.org/maven2/com/adobe/aem/aemanalyser-maven-plugin/

플러그인은 프로젝트에 구성된 SDK가 아니라 사용 가능한 최신 SDK를 사용합니다.

다음은 이 단계의 일부로 실행되는 분석기를 설명하는 테이블입니다.

모듈 함수, 예제 및 문제 해결 로컬 SDK Cloud Manager
api-regions-exportsimports 모든 OSGI 번들이 Maven 프로젝트에 포함된 다른 번들의 Export-package 선언에서 충족된 Import-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.

 

문제를 해결하려면 패키지를 제공하는 번들이 배포에 포함되어 있는지 확인하거나 잘못된 이름 또는 잘못된 버전이 사용되었는지 확인하기 위해 내보낼 번들의 매니페스트를 확인합니다.
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로 지정된 초기 컨텐츠가 포함되어 있는 경우 AEM에서 Cloud Service 클러스터형 환경으로 문제가 발생합니다. 경고는 다음과 같습니다.

 

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

 

초기 컨텐츠를 포인터 문으로 변환하는 문제를 해결하려면 참조 설명서 를 참조하십시오.
bundle-resources 번들에 Sling-Bundle-Resources 헤더로 지정된 리소스가 포함되어 AEM에서 Cloud Service 클러스터 환경으로 문제가 되는 경우 경고를 제공합니다. 경고는 다음과 같습니다.

 

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

 

리소스를 repoint 문으로 변환하는 문제를 해결하려면 Repoinit 설명서를 참조하십시오.
api-regions

 

api-regions-check-order

 

api-regions-dependencies

 

api-regions-duplicates
이러한 분석기는 Sling 기능 모델을 따르는 가공물을 만드는 컨텐츠 패키지와 관련된 일부 세부 정보를 기능 모델 변환 프로세스에서 확인합니다. 모든 오류는 Adobe 고객 지원 센터에 보고해야 합니다.
api-regions-crossfeature-dups 고객 OSGI 번들에 AEM을 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 모든 지시 섹션의 구문을 확인합니다
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)

알려진 문제

다음은 Build Analyzer Maven 플러그인을 사용할 때 발생하는 알려진 문제 목록입니다.

로컬 SDK에서 Build Analyzer Maven 플러그인을 실행하지 못했습니다.

Build Analyzer Maven 플러그인 버전이 1.1.2보다 낮은 로컬 SDK와 함께 사용하는 경우 플러그인을 실행하면 아래 오류가 발생할 수 있습니다. 이 경우 프로젝트를 플러그인의 최신 버전으로 업데이트합니다.

[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 Project Archetype을 사용하여 프로젝트를 설정하는 경우 아래 와 같이 루트 Maven pom.xml에서 속성을 조정하십시오.

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

이 페이지에서는