現在表示中:

概要

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 で Import ダイアログを開きます。

    • プロジェクトを開いていない場合は、ようこそ画面の「Import Project」を選択します。
    • メインメニューから File/Import Project を選択します。
  2. Import ダイアログで、プロジェクトの POM ファイルを選択します。

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

    chlimage_1
  4. 以降のダイアログで「Next」をクリックし、最後に「Finish」をクリックします。

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

    chlimage_1

IntelliJ IDEA による JSP のデバッグ

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

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

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

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

  1. File/Project Structure に移動します。
  2. 「content」モジュールを選択します。
  3. モジュールのリストの上にある「+」をクリックして、「Web」を選択します。
  4. 次のスクリーンショットに示すように、「Web Resource Directory」として、プロジェクトの「content/src/main/content/jcr_root」サブディレクトリを選択します。
chlimage_1

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

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

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

  1. Run/Edit Configurations に移動します。
  2. 「+」をクリックして「JSR45 Remote」を選択します。
  3. 設定ダイアログで、「Application Server」の横にある「Configure」を選択して、Generic サーバーを設定します。
  4. デバッグの開始時にブラウザーを開く場合は、開始ページを適切な URL に設定します。
  5. vlt autosync を使用する場合は、「Before launch」タスクをすべて削除します。使用しない場合は、適切な Maven タスクを設定します。
  6. Startup/Connection ウィンドウで、必要に応じてポートを調整します。
  7. IntelliJ IDEA が処理するコマンドライン引数をコピーします。
chlimage_1
chlimage_1

デバッグモード用の 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 に移動して、使用するデバッグプロファイルを選択します。
  2. コンポーネントのコードにブレークポイントを設定します。
  3. ブラウザーでページにアクセスします。

 

chlimage_1

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

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

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー