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 プロジェクトの設定

次に、Apache Mavenを使用してAEMプロジェクトをビルドする方法の説明に従って、Mavenを使用してプロジェクトをセットアップします。

IntelliJ IDEAでAEMプロジェクトの操作を開始するには、5分で開始するの基本設定で十分です。

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

IntelliJ IDEA では JSP との連携もサポートされます。サポートされる項目の例を次に示します。

  • タグライブラリのオートコンプリート
  • <cq:defineObjects />と<sling:defineObjects />で定義されたオブジェクトの認識

この機能を使用するには、 Apache Mavenを使用してAEMプロジェクトをビルドする方法のJSPを使用する方法の手順に従ってください。

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

  1. IntelliJ IDEAで​インポート​ダイアログを開き、

    • まだプロジェクトを開いていない場合は、ようこそ画面で「プロジェクトを読み込み」を選択します。
    • メインメニューから「ファイル —>プロジェクトを読み込む」を選択します。

  2. Import ダイアログで、プロジェクトの POM ファイルを選択します。

    chlimage_1-45

  3. 次のダイアログに示すデフォルト設定を使用して続行します。

    chlimage_1-46

  4. 次へ​と​完了​をクリックして、次のダイアログを続けます。

  5. これで、IntelliJ IDEA を使用した AEM 開発用の設定は完了です。

    chlimage_1-47

IntelliJ IDEA による JSP のデバッグ

IntelliJ IDEA を使用して JSP をデバッグするには、次の手順をおこなう必要があります。

  • プロジェクトでの Web ファセットの設定
  • JSR45 サポートプラグインのインストール
  • デバッグプロファイルの設定
  • デバッグモード用の AEM の設定

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

デバッグ用の JSP を検索する場所を IntelliJ IDEA で認識する必要があります。IDEA では content-package-maven-plugin 設定を解釈できないので、これを手動で設定する必要があります。

  1. ファイル —>プロジェクト構造​に移動します。
  2. コンテンツ​モジュールを選択します。
  3. モジュールのリストの上の​+​をクリックし、Web​を選択します。
  4. Webリソースディレクトリとして、次のスクリーンショットに示すように、プロジェクトのcontent/src/main/content/jcr_root subdirectoryを選択します。

chlimage_1-48

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

  1. IntelliJ IDEA設定の​プラグイン​ウィンドウに移動します。
  2. JSR45 Integration​プラグインに移動し、その横にあるチェックボックスをオンにします
  3. 「適用」をクリックします。
  4. 再起動するよう要求されたら、IntelliJ IDEA を再起動します。

chlimage_1-49

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

  1. 実行/設定を編集​に移動します。
  2. +​を押し、JSR45 Remote​を選択します。
  3. 設定ダイアログで、「アプリケーションサーバー」の横にある「設定」を選択し、汎用サーバーを設定します。
  4. デバッグの開始時にブラウザーを開く場合は、開始ページを適切な URL に設定します。
  5. vlt autosyncを使用する場合は、起動前に​すべてのタスクを削除し、使用しない場合は適切なMavenタスクを設定します
  6. Startup/Connection​ペインで、必要に応じてポートを調整します
  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. Run -> Debug -> Your Debug Profile​を選択します。
  2. コンポーネントのコードにブレークポイントを設定します。
  3. ブラウザーでページにアクセスします。

chlimage_1-52

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

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

このページ