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. 読み込みダイアログで、プロジェクトの 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. 設定ダイアログで、「アプリケーションサーバー」の横にある「設定」を選択して、Generic サーバーを設定します。
  4. デバッグの開始時にブラウザーを開く場合は、開始ページを適切な URL に設定します。
  5. vlt autosync を使用する場合は、「起動前」タスクをすべて削除します。使用しない場合は、適切な Maven タスクを設定します。
  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 によるバンドルのデバッグ

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

このページ