Show Menu
トピック×

IntelliJ IDEA を使用して AEM プロジェクトを開発する方法

概要

IntelliJ で AEM の開発を開始するには、次の手順を実行する必要があります。
各手順の詳細については、このページで後述します。
  • IntelliJ のインストール
  • Maven に基づく AEM プロジェクトの設定
  • Maven POM での IntelliJ 用の JSP サポートの準備
  • IntelliJ への Maven プロジェクトの読み込み
このガイドは IntelliJ IDEA Ultimate Edition 12.1.4 と AEM 5.6.1 を基に作成されています。

IntelliJ IDEA のインストール

JetBrains のダウンロードページ から IntelliJ IDEA をダウンロードします。
そのページのインストール手順に従ってください。

Maven に基づく AEM プロジェクトの設定

Next, set up your project using Maven as described in How-To Build AEM Projects using Apache Maven .
To start working with AEM projects in IntelliJ IDEA, the basic setup in Getting Started in 5 Minutes is sufficient.

IntelliJ IDEA 用の JSP サポートの準備

IntelliJ IDEA では JSP との連携もサポートされます。サポートされる項目の例を次に示します。
  • タグライブラリのオートコンプリート
  • awareness of objects defined by <cq:defineObjects /> and <sling:defineObjects />
For that to work, follow the instructions on How-To Work with JSPs in How-To Build AEM Projects using Apache Maven .

Maven プロジェクトの読み込み

  1. Open the Import dialog in IntelliJ IDEA by
    • selecting Import Project on the welcome screen if you have no project open yet
    • selecting File -> Import Project from the main menu
  2. Import ダイアログで、プロジェクトの POM ファイルを選択します。
  3. 次のダイアログに示すデフォルト設定を使用して続行します。
  4. Continue through the following dialogs by clicking Next and Finish .
  5. これで、IntelliJ IDEA を使用した AEM 開発用の設定は完了です。

IntelliJ IDEA による JSP のデバッグ

IntelliJ IDEA を使用して JSP をデバッグするには、次の手順をおこなう必要があります。
  • プロジェクトでの Web ファセットの設定
  • JSR45 サポートプラグインのインストール
  • デバッグプロファイルの設定
  • デバッグモード用の AEM の設定

プロジェクトでの Web ファセットの設定

デバッグ用の JSP を検索する場所を IntelliJ IDEA で認識する必要があります。IDEA では content-package-maven-plugin 設定を解釈できないので、これを手動で設定する必要があります。
  1. Go to File -> Project Structure
  2. Select the Content module
  3. Click + above the list of modules and select Web
  4. # で、下のスクリ content/src/main/content/jcr_root subdirectory ーンショットに示すように、プロジェクトのを選択します。

JSR45 サポートプラグインのインストール

  1. Go to the Plugins pane in the IntelliJ IDEA settings
  2. Navigate to the JSR45 Integration Plugin and select the check box next to it
  3. Click Apply
  4. 再起動するよう要求されたら、IntelliJ IDEA を再起動します。

デバッグプロファイルの設定

  1. Go to Run -> Edit Configurations
  2. Hit the + and select JSR45 Remote
  3. In the configuration dialog, select Configure next to Application Server and configure a Generic server
  4. デバッグの開始時にブラウザーを開く場合は、開始ページを適切な URL に設定します。
  5. Remove all Before launch tasks if you use vlt autosync, or configure appropriate Maven tasks if you don't
  6. On the Startup/Connection pane, adjust the port if required
  7. IntelliJ IDEA が処理するコマンドライン引数をコピーします。

デバッグモード用の 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. Select Run -> Debug -> Your Debug Profile
  2. コンポーネントのコードにブレークポイントを設定します。
  3. ブラウザーでページにアクセスします。

IntelliJ IDEA によるバンドルのデバッグ

標準の汎用リモートデバッグ接続を使用して、バンドル内のコードをデバッグできます。 リモートデバッグに関する Jetbrain のドキュメント の手順に従ってください。