Eclipse용 AEM 개발자 도구

개요

Eclipse용 AEM 개발자 도구는 Apache Sling용 Eclipse 플러그인 apache 라이센스 2에서 릴리스되었습니다.

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

  • Eclipse Server Connector를 통해 AEM 인스턴스와의 원활한 통합
  • 컨텐츠 및 OSGi 번들을 위한 동기화
  • 코드 핫 스왑 기능을 사용하여 디버깅 지원
  • 특정 프로젝트 생성 마법사를 통해 AEM 프로젝트의 간단한 부트스트랩
  • 손쉽게 JCR 속성 편집

요구 사항

AEM 개발자 도구를 사용하려면 먼저 다음을 수행해야 합니다.

노트

macOS에서 마우스 오른쪽 단추를 클릭해야 합니다 Eclipse.app 그런 다음 패키지 내용 표시 당신의 eclipse.ini.

Eclipse용 AEM 개발자 도구를 설치하는 방법

일단 당신이 요구 사항 위에서 다음과 같이 플러그인을 설치할 수 있습니다.

  1. 를 엽니다. AEM 개발자 도구 웹 사이트.

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

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

  3. Eclipse에서 도움말 메뉴 아래의 제품에서 사용할 수 있습니다.

  4. 클릭 새 소프트웨어 설치.

  5. 클릭 추가….

  6. in 이름 enter AEM Developer Tools.

  7. in 위치 설치 URL을 복사합니다.

  8. 추가​를 클릭합니다.

  9. 둘 다 확인 AEMSling plugins.

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

  11. 에서 설치 세부 정보다음 다시 한 번

  12. 사용권 계약에 동의하고 를 클릭합니다. 완료.

  13. 클릭 RestartNow eclipse를 다시 시작하려면

AEM 관점

Eclipse에서 관점은 창 내에서 사용할 수 있는 작업 및 보기를 결정하고 Eclipse의 리소스와 작업 지향 상호 작용을 활성화합니다. 원근에 대한 자세한 내용은 Eclipse 설명서.

AEM Development Tools for Eclipse에서는 AEM 프로젝트 및 인스턴스를 완전히 제어할 수 있는 AEM Perspective를 제공합니다. AEM Perspective를 열려면

  1. Eclipse 메뉴 모음에서 를 선택합니다 -> 원근 -> 원근 열기 -> 기타.
  2. 선택 AEM 대화 상자에서 를 클릭하고 열기.

Eclipse의 AEM 관점

샘플 다중 모듈 프로젝트

AEM Developer Tools for Eclipse에는 여러 AEM 기능에 대한 모범 사례 안내서로서 Eclipse에서 프로젝트 설정을 빠르게 확인할 수 있도록 지원하는 샘플 다중 모듈 프로젝트가 포함되어 있습니다. Project Archetype에 대해 자세히 알아보기.

다음 단계에 따라 샘플 프로젝트를 만듭니다.

  1. 에서 파일 > 새로 만들기 > 프로젝트 메뉴에서 AEM 섹션을 선택하고 AEM 샘플 다중 모듈 프로젝트.

    AEM 샘플 다중 모듈 프로젝트

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

    노트

    m2eclipse가 원형 카탈로그를 스캔해야 하므로 이 단계는 잠시 걸릴 수 있습니다.

  3. 선택 com.adobe.granite.archetypes : sample-project-archetype : <highest-number> 메뉴에서 를 클릭한 다음 다음.

    원형 버전 선택

  4. 샘플 프로젝트에 대해 다음 필드를 제공합니다.

    • 이름
    • 그룹 Id
    • 아티팩트 Id
    • appId - 다음을 확장해야 할 수 있습니다. 고급 옵션을 사용하여 이 값을 설정할 수 있습니다.
    • appTitle - 다음을 확장해야 할 수 있습니다. 고급 옵션을 사용하여 이 값을 설정할 수 있습니다.
    • 패키지 - 다음을 확장해야 할 수 있습니다. 고급 옵션을 사용하여 이 값을 설정할 수 있습니다.

    원형 속성 정의

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

  6. 그런 다음 Eclipse가 연결할 AEM 서버를 구성합니다.

    디버거 기능을 사용하려면 디버그 모드에서 AEM을 시작해야 합니다. 이 작업은 명령줄에 다음을 추가하여 수행할 수 있습니다.

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

    AEM 서버에 연결

  7. 클릭 완료. 프로젝트 구조가 만들어집니다.

    노트

    새로 설치하는 경우(특히 maven 종속성이 다운로드되지 않은 경우) 오류가 발생하여 프로젝트를 만들 수 있습니다. 이 경우 다음에 설명된 절차를 따르십시오. 잘못된 프로젝트 정의 해결.

기존 프로젝트를 가져오는 방법

를 사용할 수 있습니다 새 프로젝트 올바른 구조를 만드는 기능:

  1. 지침에 따라 을(를) 만듭니다 샘플 다중 모듈 프로젝트 또한 다음 프로젝트를 만들어 문제를 안전하게 분리할 수 있습니다.

    • PROJECT.ui.apps 대상 /apps/etc 콘텐츠
    • PROJECT.ui.content 대상 /content 저자가
    • PROJECT.core Java 번들 (Java 코드를 추가하려는 즉시 이 번들이 유용하게 사용될 수 있음)
    • PROJECT.it.launcherPROJECT.it.tests 통합 테스트
  2. 의 컨텐츠를 바꿉니다 PROJECT.ui.apps 프로젝트를 appsetc 패키지의 폴더:

    1. 프로젝트 탐색기 패널에서 펼칩니다 PROJECT.ui.apps > src > main > content > jcr_root > apps.
    2. 을(를) 마우스 오른쪽 단추로 클릭합니다. apps 폴더를 선택하고 표시 위치 > 시스템 탐색기.
    3. 삭제 appsetc 이제 표시되어야 하는 폴더를 여기에 지정합니다. appsetc 컨텐츠 패키지의 폴더입니다.
    4. Eclipse에서 PROJECT.ui.apps 프로젝트 및 새로 고침.
  3. 그럼 같은 방법으로 PROJECT.ui.content 컨텐츠 폴더를 패키지 중 하나로 바꿉니다.

    1. 프로젝트 탐색기 패널에서 펼칩니다 PROJECT.ui.content > src > main > content > jcr_root > content.
    2. 더 깊은 컨텐츠 폴더를 마우스 오른쪽 단추로 클릭하고 표시 위치 -> 시스템 탐색기.
    3. 이제 표시해야 하는 컨텐츠 폴더를 삭제하고 컨텐츠 패키지의 컨텐츠 폴더를 여기에 배치합니다.
    4. Eclipse에서 PROJECT.ui.content 프로젝트 및 새로 고침.
  4. 이제 filter.xml 이 두 프로젝트의 파일이 컨텐츠 패키지의 컨텐츠에 해당합니다. 이를 위해 META-INF/vault/filter.xml 별도의 텍스트/코드 편집기에 컨텐츠 패키지의 파일입니다.

    • 다음은 filter.xml 찾을 수 있는 파일:
    <?xml version="1.0" encoding="UTF-8"?>
    <workspaceFilter version="1.0">
        <filter root="/apps/foo"/>
        <filter root="/apps/foundation/components/bar"/>
        <filter root="/etc/designs/foo"/>
        <filter root="/content/foo"/>
        <filter root="/content/dam/foo"/>
        <filter root="/content/usergenerated/content/foo"/>
    </workspaceFilter>
    
  5. 두 프로젝트로 분할된 패키지의 콘텐츠는 이러한 필터 규칙을 두 개로 분할하고 그에 따라 업데이트해야 합니다 filter.xml 두 프로젝트의 파일.

    1. Eclipse에서 PROJECT.ui.apps/src/main/content/META-INF/filter.xml.

    2. 의 컨텐트 바꾸기 <workspaceFilter> 다음으로 시작하는 패키지 규칙이 있는 요소 /apps/etc

      • 예:

        <?xml version="1.0" encoding="UTF-8"?>
        <workspaceFilter version="1.0">
           <filter root="/apps/foo"/>
           <filter root="/apps/foundation/components/bar"/>
           <filter root="/etc/designs/foo"/>
        </workspaceFilter>
        
    3. 그런 다음 엽니다. PROJECT.ui.content/src/main/content/META-INF/filter.xml.

    4. 규칙을 다음으로 시작하는 패키지의 규칙으로 바꿉니다 /content.

      • 예:

        <?xml version="1.0" encoding="UTF-8"?>
        <workspaceFilter version="1.0">
           <filter root="/content/foo"/>
           <filter root="/content/dam/foo"/>
           <filter root="/content/usergenerated/content/foo"/>
        </workspaceFilter>
        
  6. 모든 변경 사항을 저장해야 합니다. 이제 해당 새 컨텐츠를 AEM 인스턴스에 동기화할 수 있습니다.

  7. 서버 패널에서 연결이 시작되었는지, 시작하지 않았는지 확인합니다.

  8. 을(를) 클릭합니다. 정리 및 게시 아이콘.

완료되면 인스턴스에서 패키지를 실행해야 하며 저장 시 변경 사항이 자동으로 인스턴스에 동기화됩니다.

프로젝트에서 패키지를 다시 빌드하려면 PROJECT.ui.apps 또는 PROJECT.ui.content다음으로 실행 -> Maven 설치.

이제 패키지(예: PROJECT.ui.apps-0.0.1-SNAPSHOT.zip).

문제 해결

잘못된 프로젝트 정의 해결

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

  1. 생성된 프로젝트를 모두 선택합니다.
  2. 마우스 오른쪽 단추를 클릭합니다.
  3. 컨텍스트 메뉴에서 Maven -> 프로젝트 업데이트.
  4. 확인 스냅샷/릴리스의 강제 업데이트.
  5. 확인​을 클릭합니다.

Eclipse는 필요한 종속성을 다운로드합니다. 시간이 좀 걸릴 수 있습니다.

추가 정보

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

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

이 페이지에서는