ドキュメントAEM 6.5ユーザーガイド

AEM Developer Tools for Eclipse aem-developer-tools-for-eclipse

Last update: Thu Apr 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Developer

AEM Developer Tools for Eclipse 用の円形の画像モチーフ。

概要 overview

AEM Developer Tools は、Apache License 2 に従ってリリースされた Apache Sling 向け Eclipse プラグイン をベースとする Eclipse プラグインです。

このツールは、AEM 開発を容易にする次のような機能を提供します。

  • Eclipse Server Connector による AEM インスタンスとのシームレスな統合。
  • コンテンツと OSGI バンドルの同期。
  • コードのホットスワップ機能を備えたデバッグサポート。
  • 固有のプロジェクト作成ウィザードからの AEM プロジェクトの簡単なブートストラップ
  • JCR プロパティの容易な編集。

要件 requirements

AEM Developer Tools を使用する前に、以下の手順を実行します。

  • Eclipse IDE for Java™ EE Developers をダウンロードしてインストールします。AEM Developer Tools は現在、Eclipse Kepler 以降をサポートします。

  • AEM バージョン 5.6.1 以降で使用できます。

  • Eclipse に関する FAQ の説明に従って、eclipse.ini 設定ファイルを編集し、ヒープメモリが 1 GB 以上になるように Eclipse を設定します。

NOTE
macOS では、Eclipse.app を右クリックし、「パッケージの内容を表示」を選択して、eclipse.ini を探します。

AEM Developer Tools for Eclipse のインストール方法 how-to-install-the-aem-developer-tools-for-eclipse

前述の要件を満たしたら、次の手順でプラグインをインストールできます。

  1. AEM Developer Tools の web サイト（https://eclipse.adobe.com/aem/dev-tools/）を参照します。

  2. インストール用リンク ​をコピーします。

    または、インストール用リンクを使用する代わりにアーカイブをダウンロードできます。この方法ではオフラインインストールが可能ですが、自動アップデート通知は受け取れません。

  3. Eclipse で、ヘルプ ​メニューを開きます。

  4. 「Install New Software」をクリックします。

  5. 「Add…」をクリックします。

  6. 「Name」に「AEM Developer Tools」と入力します。

  7. 「Location」にインストール用 URL をコピーします。

  8. 「OK」をクリックします。

  9. 「AEM」プラグインと「Sling」プラグインの両方をオンにします。

  10. 「Next」をクリックします。

  11. 「次へ」をクリックします。

  12. 使用許諾契約書に同意し、「Finish」をクリックします。

  13. 「Yes」をクリックして、Eclipse を再起動します。

既存プロジェクトの読み込み方法 how-to-import-existing-projects

NOTE
AEM からダウンロードした際に Eclipse でバンドルを操作する方法を参照してください。

AEM パースペクティブ the-aem-perspective

AEM Development Tools for Eclipse には、AEM プロジェクトおよびインスタンスを完全にコントロールできるパースペクティブが同梱されています。

chlimage_1-2

サンプルのマルチモジュールプロジェクト sample-multi-module-project

AEM Developer Tools には、Eclipse でのプロジェクト設定を素早く習得できる、サンプルのマルチモジュールプロジェクトが付属しています。また、AEM のいくつかの機能のベストプラクティスガイドとしても役立ちます。プロジェクトのアーキタイプについて詳しくは、こちらを参照してください。

サンプルプロジェクトを作成するには、次の手順を実行します。

  1. File／New／Project メニューで、「AEM」セクションを参照して、「AEM Sample Multi-Module Project」を選択します。

    chlimage_1-69

  2. 「次へ」をクリックします。

    note note
    NOTE
    m2eclipse がアーキタイプカタログをスキャンする必要があるので、この手順にはしばらく時間がかかることがあります。

    chlimage_1-70

  3. メニューから「com.adobe.granite.archetypes：sample-project-archetype：（最も大きい数字）」を選択して、「次へ」をクリックします。

    chlimage_1-71

  4. サンプルプロジェクトの​ 名前、グループ ID および​ アーティファクト ID を入力します。いくつかの高度なプロパティを設定することもできます。

    chlimage_1-72

  5. 次に、Eclipse の接続先となる AEM サーバーを設定します。

    デバッガー機能を使用するには、AEM をデバッグモードで起動します。コマンドラインに以下を追加するなどして、デバッグモードで起動できます。

    code language-none 
        -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123

    chlimage_1-73

  6. 「終了」をクリックします。プロジェクト構造が作成されます。

    note note
    NOTE
    新規インストールでは（より具体的には、Maven の依存関係をダウンロードしたことがない場合は）、プロジェクトを作成するとエラーが表示されることがあります。その場合は、無効なプロジェクト定義の解決で説明されている手順に従ってください。

トラブルシューティング troubleshooting

無効なプロジェクト定義の解決 resolving-invalid-project-definition

無効な依存関係およびプロジェクト定義を解決するには、次の手順を実行します。

  1. 作成したプロジェクトをすべて選択します。
  2. 右クリックします。Maven メニューで「Update Projects」を選択します。
  3. 「スナップショット／リリースの強制更新」をオンにします。
  4. 「OK」をクリックします。Eclipse は必要な依存関係のダウンロードを試みます。

JSP ファイルでのタグライブラリのオートコンプリートの有効化 enabling-tag-library-autocompletion-in-jsp-files

適切な依存関係がプロジェクトに追加されていれば、タグライブラリのオートコンプリートはデフォルトで機能します。必要な tld ファイルと TagExtraInfo ファイルが含まれていない AEM Uber Jar を使用する場合、既知の問題が 1 つ存在します。

この問題を回避するには、org.apache.sling.scripting.jsp.taglib アーティファクトを AEM Uber Jar より前のクラスパスに配置します。Maven プロジェクトの場合は、pom.xml 内で、Uber Jar より前に次の依存関係を配置します。

<dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.scripting.jsp.taglib</artifactId>
  <scope>provided</scope>
</dependency>

AEM のデプロイメントに適したバージョンを追加してください。

詳細情報 more-information

Apache Sling IDE tooling for Eclipse の公式 web サイトでは、次の有益な情報を参照できます。

次の公式の Eclipse ドキュメントは、環境の設定に役立ちます。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2