ドキュメント

Eclipse を使用してAEM アプリをデバッグする方法

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

AEM アプリケーションをデバッグするには、Java リモートデバッグ を使用します。

説明 description

環境

  • Adobe Experience Manager（AEM） 6.4
  • Adobe Experience Manager（AEM） 6.5

問題/症状

リモート（またはローカル）AEM サーバーで動作しているアプリケーションをデバッグする方法を教えてください。

解決策 resolution

AEM アプリケーションをデバッグするには、Java リモートデバッグ を使用します。

警告： アプリケーションのパフォーマンスに大きな影響を与える可能性があるので、必要でない限り、実稼動環境でリモートデバッグを有効にしないでください。

手順 1：リモートデバッグ JVM パラメーターの追加

リモートデバッグを使用するには、次の JVM パラメーターでAEMを起動する必要があります。
-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n

次のいずれかの操作を行って、パラメーターを追加できます。

  • crx-quickstart/bin/start スクリプト CQ_JVM_OPTS 環境変数に追加します（サーバーは常にデバッグモードで開始します）。
  • AEMを java -jar で直接開始する際に、パラメーターとして含めます。 例：java -Xmx512m -agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n -jar cq-author-4502.jar

メモ

  • 必要に応じて、「。…,address=8000,…」で定義したポートを 8000 から環境で適切に機能するものに変更できます。
  • 動作していないことに気付いた場合は、-nofork コマンドラインオプションを指定して java プロセスをフォークしないでください。
  • 開始スクリプトは crx-quickstart/bin の下にあります。

手順 2：リモートデバッグセッションの開始

Eclipse からリモートデバッグセッションを開始するには、次の手順を実行します。

  1. Eclipse を開きます。
  2. 「 実行 」を選択します >   デバッグ設定
  3. 「リモート Java アプリケーション」を右クリックし、「新規」を選択します。
  4. プロジェクトの下でAEM プロジェクトを選択します。
  5. 上記で定義されている jvm パラメーターの「address」設定で指定されているポートを入力します。 この例では、ポートは 8000 （および接続先のマシンのホスト名、おそらく localhost）です
  6. デバッグセッションを開始するには、保存後、デバッグ設定画面で 新しい設定 をダブルクリックします。
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f