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

AEM Developer Tools for Eclipse

最終更新日： 2023年5月4日
  • トピック：
  • Developing

作成対象：

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

概要

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

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

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

要件

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 のインストール方法

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

  1. AEM Developer Tools web サイトにアクセスします。

  2. を インストールリンク.

    または、インストールリンクを使用する代わりに、アーカイブをダウンロードできます。 これにより、オフラインでのインストールが可能になりますが、この方法では自動更新通知が送信されなくなります。

  3. Eclipse で、 ヘルプ メニュー

  4. クリック 新しいソフトウェアのインストール.

  5. クリック 追加….

  6. In 名前 「 AEM Developer Tools 」と入力します。

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

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

  9. 両方を選択 AEM および Sling プラグイン

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

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

  12. リンク契約に同意し、 完了.

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

既存プロジェクトの読み込み方法

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

AEM パースペクティブ

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

chlimage_1-2

サンプルのマルチモジュールプロジェクト

AEM Developer Tools for Eclipse には、サンプルのマルチモジュールプロジェクトが同梱されています。このプロジェクトは、Eclipse でのプロジェクト設定を手早く行うために役立つだけでなく、いくつかの AEM 機能に対するベストプラクティスガイドの役割も果たします。プロジェクトのアーキタイプについて詳しくは、こちらを参照してください。

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

  1. 内 ファイル > 新規 > プロジェクト メニュー、参照 AEM 「 」セクションで「 」を選択します。 AEM Sample Multi-Module Project.

    chlimage_1-69

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

    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 をデバッグモードで起動する必要があります。コマンドラインに以下を追加するなどして、デバッグモードで起動できます。

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

    chlimage_1-73

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

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

トラブルシューティング

無効なプロジェクト定義の解決

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

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

JSP ファイルでのタグライブラリのオートコンプリートの有効化

適切な依存関係がプロジェクトに追加されると、タグライブラリのオートコンプリートは初期設定の状態で動作します。 AEM Uber Jar を使用する際に発生する既知の問題の 1 つで、必要な tld ファイルと TagExtraInfo ファイルが含まれていません。

この問題を回避するには、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 のデプロイメントに適したバージョンを追加してください。

詳細情報

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

  • Apache Sling IDE tooling for Eclipse ユーザーガイド。このドキュメントでは、全体のコンセプト、AEM 開発ツールがサポートするサーバー統合およびデプロイメント機能について説明します。
  • トラブルシューティング情報
  • 既知の問題リスト

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

  • Eclipse 使用の手引き
  • Eclipse Luna ヘルプシステム
  • Maven 統合（m2eclipse）
recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e