Eclipse용 AEM 개발자 도구 aem-developer-tools-for-eclipse

Eclipse용 AEM 개발자 도구에 대한 원형 이미지 모티브

개요 overview

"AEM 개발자 도구"는 Apache 라이선스 2에 따라 릴리스된 Apache Sling용 Eclipse 플러그인을 기반으로 하는 Eclipse 플러그인입니다.

AEM 개발을 쉽게 만드는 몇 가지 기능을 제공합니다.

  • Eclipse Server Connector를 통해 AEM 인스턴스와 원활하게 통합됩니다.
  • 콘텐츠 및 OSGI 번들 모두에 대한 동기화.
  • 코드 핫 스왑 기능으로 디버깅 지원.
  • 특정 프로젝트 만들기 마법사를 통한 AEM 프로젝트 단순 Bootstrap.
  • JCR 속성을 쉽게 편집할 수 있습니다.

요구 사항 requirements

AEM 개발자 도구를 사용하기 전에 다음을 수행하십시오.

  • Java™ EE 개발자용 Eclipse IDE를 다운로드하여 설치합니다. AEM 개발자 도구는 현재 Eclipse Kepler 이상을 지원합니다

  • AEM 버전 5.6.1 이상에서 사용할 수 있습니다.

  • Eclipse FAQ에 설명된 대로 eclipse.ini 구성 파일을 편집하여 Eclipse 설치를 구성하여 힙 메모리가 1GB 이상 있는지 확인합니다.

NOTE
macOS에서 Eclipse.app ​을(를) 마우스 오른쪽 단추로 클릭한 다음 패키지 내용 표시 ​를 선택하여 eclipse.ini을(를) 찾습니다.

Eclipse용 AEM 개발자 도구를 설치하는 방법 how-to-install-the-aem-developer-tools-for-eclipse

위의 요구 사항을 충족하면 다음과 같이 플러그인을 설치할 수 있습니다.

  1. https://eclipse.adobe.com/aem/dev-tools/에서 AEM 개발자 도구 웹 사이트를 찾아봅니다.

  2. 설치 링크 ​를 복사합니다.

    또는 설치 링크를 사용하는 대신 아카이브를 다운로드할 수 있습니다. 이렇게 하면 오프라인 설치가 가능하지만 자동 업데이트 알림이 없습니다.

  3. Eclipse에서 도움말 메뉴를 엽니다.

  4. 새 소프트웨어 설치 ​를 클릭합니다.

  5. 추가… ​를 클릭합니다.

  6. 이름 ​에서 AEM 개발자 도구를 입력합니다.

  7. 위치 ​에서 설치 URL을 복사합니다.

  8. 확인 ​을 클릭합니다.

  9. AEMSling 플러그인을 모두 확인하십시오.

  10. 다음 ​을 클릭합니다.

  11. 다음 ​을 클릭합니다.

  12. 사용권 계약에 동의하고 마침 ​을 클릭합니다.

  13. Eclipse를 다시 시작하려면 ​를 클릭하세요.

기존 프로젝트를 가져오는 방법 how-to-import-existing-projects

NOTE
AEM에서 번들을 다운로드할 때 Eclipse에서 번들로 작업하는 방법을 참조하세요.

AEM 관점 the-aem-perspective

AEM Development Tools for Eclipse에는 AEM 프로젝트 및 인스턴스를 완벽하게 제어할 수 있는 관점이 포함되어 있습니다.

chlimage_1-2

샘플 다중 모듈 프로젝트 sample-multi-module-project

"AEM 개발자 도구"에는 Eclipse의 프로젝트 설정을 빠르게 시작하는 데 도움이 되는 샘플 다중 모듈 프로젝트가 포함되어 있습니다. 또한 여러 AEM 기능에 대한 모범 사례 안내서 역할을 합니다. Project Archetype에 대해 자세히 알아보기.

샘플 프로젝트를 만들려면 다음 단계를 완료하십시오.

  1. 파일 > 새로 만들기 > 프로젝트 메뉴에서 AEM 섹션으로 이동하여 AEM 샘플 다중 모듈 프로젝트 ​를 선택합니다.

    chlimage_1-69

  2. 다음 ​을 클릭합니다.

    note note
    NOTE
    m2eclipse는 Archetype 카탈로그를 스캔해야 하므로 이 단계는 시간이 걸릴 수 있습니다.

    chlimage_1-70

  3. 메뉴에서 com.adobe.granite.archetypes : sample-project-archetype : (가장 높은 숫자) ​을(를) 선택한 후 다음 ​을(를) 클릭합니다.

    chlimage_1-71

  4. 샘플 프로젝트에 대해 이름, 그룹 ID아티팩트 ID ​를 입력하십시오. 일부 고급 속성을 설정하도록 선택할 수도 있습니다.

    chlimage_1-72

  5. 이제 Eclipse가 연결할 수 있는 AEM 서버를 구성합니다.

    디버거 기능을 사용하려면 AEM을 디버그 모드로 시작했는지 확인하십시오. 이 모드는 명령줄에 다음을 추가하여 수행할 수 있습니다.

    code language-none
        -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
    

    chlimage_1-73

  6. 마침 ​을 클릭합니다. 프로젝트 구조가 생성됩니다.

    note note
    NOTE
    새로 설치 시(특히, Maven 종속 항목을 다운로드한 적이 없는 경우) 프로젝트가 오류와 함께 생성될 수 있습니다. 이 경우 잘못된 프로젝트 정의 해결에 설명된 절차를 따르십시오.

문제 해결 troubleshooting

잘못된 프로젝트 정의 해결 중 resolving-invalid-project-definition

잘못된 종속성 및 프로젝트 정의를 해결하려면 다음과 같이 진행합니다.

  1. 생성된 모든 프로젝트를 선택합니다.
  2. 마우스 오른쪽 버튼을 클릭합니다. Maven 메뉴에서 프로젝트 업데이트 ​를 선택합니다.
  3. 스냅숏/릴리스의 강제 업데이트 ​를 확인하세요.
  4. 확인 ​을 클릭합니다. Eclipse는 필요한 종속성을 다운로드하려고 합니다.

JSP 파일에서 태그 라이브러리 자동 완성 사용 enabling-tag-library-autocompletion-in-jsp-files

적절한 종속성이 프로젝트에 추가되면 태그 라이브러리 자동 완성이 즉시 작동합니다. AEM Uber Jar를 사용할 때 필요한 tld 및 TagExtraInfo 파일이 포함되지 않는 알려진 문제가 있습니다.

이를 해결하려면 org.apache.sling.scripting.jsp.taglib 아티팩트가 AEM Uber Jar 앞의 클래스 경로에 있는지 확인합니다. Maven 프로젝트의 경우 Uber Jar 앞에 pom.xml에 다음 종속성을 배치합니다.

<dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.scripting.jsp.taglib</artifactId>
  <scope>provided</scope>
</dependency>

AEM 배포에 적합한 버전을 추가해야 합니다.

추가 정보 more-information

Eclipse용 공식 Apache Sling IDE 툴링 웹사이트는 다음과 같은 유용한 정보를 제공합니다.

다음의 공식 Eclipse 설명서는 환경을 설정하는 데 도움이 될 수 있습니다.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2