ドキュメントAEM 6.4開発ガイド

IntelliJ IDEA を使用して AEM プロジェクトを開発する方法 how-to-develop-aem-projects-using-intellij-idea

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Developer
CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

概要 overview

IntelliJ でのAEM開発を開始するには、次の手順が必要です。

それぞれについては、このハウツーの後半で詳しく説明します。

  • IntelliJ のインストール
  • Maven に基づいてAEMプロジェクトをセットアップする
  • Maven POM での IntelliJ 用の JSP サポートの準備
  • IntelliJ への Maven プロジェクトの読み込み
NOTE
このガイドは、IntelliJ IDEA Ultimate Edition 12.1.4 およびAEM 5.6.1 に基づいています。

IntelliJ IDEA のインストール install-intellij-idea

次から IntelliJ IDEA をダウンロード： JetBrains のダウンロードページ.

次に、このページのインストール手順に従います。

Maven に基づいてAEMプロジェクトをセットアップする set-up-your-aem-project-based-on-maven

次に、Apache Maven を使用して AEM プロジェクトをビルドする方法に記載されている手順に従って、Maven を使用してプロジェクトを設定します。

IntelliJ IDEA で AEM プロジェクトを使用するには、5 分で完了する作業準備で説明する基本設定を行ってください。

IntelliJ IDEA 用の JSP サポートの準備 prepare-jsp-support-for-intellij-idea

IntelliJ IDEA では、JSP を使用する際のサポートも提供できます。例：

  • タグライブラリの自動補完
  • <cq:defineObjects /> と <sling:defineObjects /> で定義されたオブジェクトの認知

サポートを有効にするには、Apache Maven を使用して AEM プロジェクトをビルドする方法の JSP を使用する方法に記載されている手順に従います。

Maven プロジェクトの読み込み import-the-maven-project

  1. 次の手順を使用して、IntelliJ IDEA で​ 読み込み ​ダイアログを開きます。

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

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

    chlimage_1-45

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

    chlimage_1-46

  4. 以降のダイアログで繰り返し「次へ」をクリックし、最後に「終了」をクリックします。

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

    chlimage_1-47

IntelliJ IDEA を使用した JSP のデバッグ debugging-jsps-with-intellij-idea

IntelliJ IDEA で JSP をデバッグするには、次の手順が必要です

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

プロジェクトでの Web ファセットの設定 set-up-a-web-facet-in-the-project

IntelliJ IDEA は、デバッグ用の JSP をどこで見つけるかを理解する必要があります。 IDEA では content-package-maven-plugin 設定を解釈できないので、これを手動で設定する必要があります。

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

chlimage_1-48

JSR45 サポートプラグインのインストール install-the-jsr-support-plugin

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

chlimage_1-49

デバッグプロファイルの設定 configure-a-debug-profile

  1. 実行／設定を編集 ​に移動します。
  2. 「+」をクリックして「JSR45 Remote」を選択します。
  3. 設定ダイアログで、「アプリケーションサーバー」の横にある「設定」を選択して、Generic サーバーを設定します。
  4. デバッグの開始時にブラウザーを開く場合は、開始ページを適切な URL に設定します。
  5. vlt autosync を使用する場合は、「起動前」タスクをすべて削除します。使用しない場合は、適切な Maven タスクを設定します。
  6. スタートアップ／接続 ​ウィンドウで、必要に応じてポートを調整します。
  7. IntelliJ IDEA が処理するコマンドライン引数をコピーします。

chlimage_1-50 chlimage_1-51

デバッグモード用のAEMの設定 configure-aem-for-debug-mode

最後に必要な手順は、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 の起動スクリプトにこれらのオプションを追加することもできます。

# ...

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/jp/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ja).

# default JVM options

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/jp/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ja).
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"

# ...

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/jp/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ja).

デバッグを開始 start-debugging

これで、AEMでの JSP のデバッグ用に設定されました。

  1. 実行／デバッグ／デバッグプロファイル ​を選択します。
  2. コンポーネントコードにブレークポイントを設定する
  3. ブラウザーでページにアクセスする

chlimage_1-52

IntelliJ IDEA によるバンドルのデバッグ debugging-bundles-with-intellij-idea

バンドル内のコードは、標準の汎用リモートデバッグ接続を使用してデバッグできます。 次の手順を実行できます。 リモートデバッグに関する Jetbrain ドキュメント.

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e