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

Eclipse 로고용 개발자 도구 Experience Manager

개요 overview

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

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

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

요구 사항 requirements

AEM 개발자 도구를 사용하기 전에 다음을 수행해야 합니다.

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

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

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

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

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

    또는 설치 링크를 사용하는 대신 아카이브를 다운로드할 수 있습니다. 이 방법을 사용하면 오프라인 설치가 가능하지만 이러한 방식으로 자동 업데이트 알림 누락을 받지 않습니다.

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

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

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

  6. 이름 필드에 AEM Developer Tools을(를) 입력하십시오.

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

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

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

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

  11. 설치 세부 정보 창에서 다음 ​을 다시 클릭합니다.

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

  13. Eclipse를 다시 시작하려면 RestartNow ​를 클릭하십시오.

AEM 관점 the-aem-perspective

Eclipse에서 관점은 창 내에서 사용할 수 있는 작업 및 보기를 결정하고 Eclipse의 리소스와 작업 지향 상호 작용을 가능하게 합니다. 큐브 뷰에 대한 자세한 내용은 Eclipse 설명서를 참조하십시오.

Eclipse용 Experience Manager 개발 도구 ​는 AEM 프로젝트 및 인스턴스를 완벽하게 제어할 수 있는 AEM 관점을 제공합니다. AEM Perspective를 열려면

  1. Eclipse 메뉴 모음에서 > 관점 > 관점 열기 > 기타 ​를 선택합니다.
  2. 대화 상자에서 AEM ​을(를) 선택하고 열기 ​를 클릭합니다.

Eclipse의 AEM 관점

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

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

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

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

    AEM 샘플 다중 모듈 프로젝트

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

    note note
    NOTE
    m2eclipse는 Archetype 카탈로그를 스캔해야 하므로 이 단계는 잠시 걸릴 수 있습니다.
  3. 메뉴에서 com.adobe.granite.archetypes : sample-project-archetype : <highest-number>을(를) 선택한 후 다음 ​을(를) 클릭합니다.

    Archetype 버전 선택

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

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

    Archetype 속성 정의

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

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

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

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

    AEM 서버에 연결

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

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

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

새 프로젝트 기능을 사용하여 올바른 구조를 만들 수 있습니다.

  1. 지침에 따라 샘플 다중 모듈 프로젝트를 만드십시오. 문제를 건강하게 분리할 수 있는 다음 프로젝트가 자동으로 만들어집니다.

    • /apps/etc 콘텐츠에 대한 PROJECT.ui.apps
    • 작성된 /content에 대한 PROJECT.ui.content
    • Java™ 번들에 대한 PROJECT.core(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 파일이 표시되는 모습의 예입니다.
    code language-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(으)로 시작하는 패키지의 규칙으로 바꿉니다.

      • 예:

        code language-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"/>
        </workspaceFilter>
        
    3. PROJECT.ui.content/src/main/content/META-INF/filter.xml을(를) 엽니다.

    4. 규칙을 /content(으)로 시작하는 패키지로 바꾸십시오.

      • 예:

        code language-xml
        <?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. 청소 및 Publish 아이콘을 클릭합니다.

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

프로젝트에서 패키지를 다시 빌드하려면 PROJECT.ui.apps 또는 PROJECT.ui.content을(를) 마우스 오른쪽 단추로 클릭하고 다음 계정으로 실행 > Maven 설치 ​를 선택합니다.

이제 패키지 내부에 대상 폴더를 만들었습니다(예: PROJECT.ui.apps-0.0.1-SNAPSHOT.zip).

문제 해결 troubleshooting

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

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

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

Eclipse는 필요한 종속성을 다운로드합니다. 잠시 기다려 주십시오.

추가 정보 more-information

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

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab