IntelliJ IDEA를 사용하여 AEM 프로젝트를 개발하는 방법

개요

IntelliJ에서 AEM 개발을 시작하려면 다음 단계가 필요합니다.

각 방법은 본 방법(How-To)의 나머지 부분에서 더 자세히 설명합니다.

  • IntelliJ 설치
  • Maven을 기반으로 AEM 프로젝트 설정
  • Maven POM에서 IntelliJ에 대한 JSP 지원 준비
  • IntelliJ로 마스터 프로젝트 가져오기
노트

이 안내서는 IntelliJ IDEA Ultimate Edition 12.1.4 및 AEM 5.6.1을 기반으로 합니다.

IntelliJ IDEA설치

JetBrain의 다운로드 페이지에서 IntelliJ IDEA를 다운로드합니다.

그런 다음 해당 페이지의 설치 지침을 따릅니다.

Maven을 기반으로 AEM 프로젝트 설정

그런 다음 Apache MavenHow-To Build AEM Projects에 설명된 대로 Maven을 사용하여 프로젝트를 설정합니다.

IntelliJ IDEA에서 AEM 프로젝트를 사용하여 작업을 시작하려면 5분 후 시작하기의 기본 설정이 충분합니다.

IntelliJ IDEA에 대한 JSP 지원 준비

IntelliJ IDEA는 JSP 작업(예:

  • 태그 라이브러리의 자동 완성
  • <cq:defineObjects /><sling:defineObjects />에 의해 정의된 개체 인식

이 작업을 수행하려면 How-To Build AEM Projects using JSP를 사용한 방법 작업에 대한 지침을 따르십시오.

마스터 프로젝트 가져오기

  1. IntelliJ IDEA에서 가져오기 대화 상자를 엽니다.

    • 아직 열려 있는 프로젝트가 없으면 시작 화면에서 프로젝트 가져오기 선택
    • 기본 메뉴에서 파일 -> 프로젝트 가져오기 선택
  2. 가져오기 대화 상자에서 프로젝트의 POM 파일을 선택합니다.

    chlimage_1-45

  3. 아래 대화 상자에 표시된 대로 기본 설정으로 계속 진행합니다.

    chlimage_1-46

  4. 다음완료​를 클릭하여 다음 대화 상자를 계속 진행합니다.

  5. 이제 IntelliJ IDEA를 사용하여 AEM 개발을 사용하도록 설정되었습니다.

    chlimage_1-47

IntelliJ IDEA로 JSP 디버깅

IntelliJ IDEA를 사용하여 JSP를 디버깅하는 데 다음 단계가 필요합니다.

  • 프로젝트에서 웹 패싯 설정
  • JSR45 지원 플러그인 설치
  • 디버그 프로필 구성
  • 디버그 모드용 AEM 구성

프로젝트에서 웹 패싯 설정

IntelliJ IDEA는 디버깅할 JSP를 찾을 위치를 이해해야 합니다. IDEA는 content-package-maven-plugin 설정을 해석할 수 없으므로 수동으로 구성해야 합니다.

  1. 파일 -> 프로젝트 구조​로 이동
  2. 콘텐츠 모듈 선택
  3. 모듈 목록 위의 +​을 클릭하고 ​을 선택합니다.
  4. 웹 리소스 디렉터리로 아래 스크린샷에 표시된 대로 프로젝트의 content/src/main/content/jcr_root subdirectory을 선택합니다.

chlimage_1-48

JSR45 지원 플러그인설치

  1. IntelliJ IDEA 설정의 플러그인 창으로 이동합니다.
  2. JSR45 통합 플러그인으로 이동하여 그 옆에 있는 확인란을 선택합니다
  3. 적용​을 클릭합니다.
  4. 요청될 때 IntelliJ IDEA를 다시 시작합니다.

chlimage_1-49

디버그 프로필구성

  1. 실행 -> 구성 편집​으로 이동
  2. +​을 클릭하고 JSR45 원격​을 선택합니다.
  3. 구성 대화 상자에서 응용 프로그램 서버 옆에 있는 구성​을 선택하고 범용 서버를 구성합니다.
  4. 디버깅을 시작할 때 브라우저를 열려면 시작 페이지를 적절한 URL로 설정합니다.
  5. vlt 자동 동기화를 사용하는 경우 실행 전 작업을 모두 제거하거나,
  6. 시작/연결 창에서 필요한 경우 포트를 조정합니다.
  7. IntelliJ IDEA에서 제안하는 명령줄 인수 복사

chlimage_1-50 chlimage_1-51

디버그 모드에 대해 AEM 구성

필요한 마지막 단계는 IntelliJ IDEA에서 제안한 JVM 옵션으로 AEM을 시작하는 것입니다.

이 작업은 AEM jar 파일을 직접 시작하고 다음 명령줄을 사용하여 이러한 옵션을 추가하여 수행할 수 있습니다.

java -Xdebug -Xrunjdwp:transport=dt_socket,address=58242,suspend=n,server=y -Xmx1024m -XX:MaxPermSize=256M -jar cq-quickstart-5.6.1.jar

아래와 같이 crx-quickstart/bin/start에서 시작 스크립트에 이러한 옵션을 추가할 수도 있습니다.

# ...

# default JVM options
if [ -z "$CQ_JVM_OPTS" ]; then
 CQ_JVM_OPTS='-server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true'
fi

CQ_JVM_OPTS="$CQ_JVM_OPTS -Xdebug -Xrunjdwp:transport=dt_socket,address=58242,suspend=n,server=y"

# ...

디버깅 시작

이제 AEM에서 JSP를 디버깅할 준비가 되었습니다.

  1. 실행 -> 디버그 -> 디버그 프로필​을 선택합니다.
  2. 구성 요소 코드에서 중단점 설정
  3. 브라우저에서 페이지 액세스

chlimage_1-52

IntelliJ IDEA를 사용한 디버깅 번들

번들의 코드는 표준 범용 원격 디버그 연결을 사용하여 디버깅할 수 있습니다. 원격 디버깅](https://www.jetbrains.com/idea/webhelp/run-debug-configuration-remote.html)에 대한 [Jetbrain 설명서를 따를 수 있습니다.

이 페이지에서는