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 MavenHow-To Work with JSPsの手順に従ってください。

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統合​プラグインに移動し、その横のチェックボックスを選択します
  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. [実行 —>デバッグ —>デバッグプロファイル]を選択します。
  2. コンポーネントのコードにブレークポイントを設定します。
  3. ブラウザーでページにアクセスします。

chlimage_1-52

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

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

このページ

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now