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 />で定義されるオブジェクトの認識

この機能を動作させるには、How-To Build AEM Projects using Apache MavenのHow-To Work with JSPsの手順に従ってください。

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

IntelliJ IDEAのインポートダイアログを開く
- まだプロジェクトを開いていない場合は、ようこそ画面で「プロジェクトを読み込み」を選択
- メインメニューからファイル —>プロジェクトを読み込むを選択
Import ダイアログで、プロジェクトの POM ファイルを選択します。
次のダイアログに示すデフォルト設定を使用して続行します。
次へと完了をクリックして、次のダイアログを続けます。
これで、IntelliJ IDEA を使用した AEM 開発用の設定は完了です。

IntelliJ IDEA による JSP のデバッグ

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

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

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

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

chlimage_1-48

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

IntelliJ IDEA設定のプラグインウィンドウに移動します
JSR45統合プラグインに移動し、その横のチェックボックスを選択します
「適用」をクリックします
再起動するよう要求されたら、IntelliJ IDEA を再起動します。

chlimage_1-49

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

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

# ...