AEM Developer Tools for Eclipse

概要

「AEM Developer Tools」は、 Eclipse plugin for Apache Sling Apache License 2 に基づいてリリースされました。

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

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

要件

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

  • ダウンロードとインストール Java™ EE 開発者向け Eclipse IDE. AEM Developer Tools は現在、Eclipse Kepler 以降をサポートします。

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

  • Eclipse のインストールを設定し、1 GB 以上のヒープメモリがあることを確認するには、 eclipse.ini 設定ファイル ( Eclipse の FAQ.

メモ

macOSで右クリック Eclipse.app​を選択し、 パッケージコンテンツを表示 を見つける eclipse.ini.

AEM Developer Tools for Eclipse のインストール方法

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

  1. 次を参照: AEM Developer Tools ウェブサイト: https://eclipse.adobe.com/aem/dev-tools/.

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

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

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

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

  5. クリック 追加….

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

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

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

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

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

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

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

  13. クリック はい をクリックして、Eclipse を再起動します。

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

AEM パースペクティブ

AEM Development Tools for Eclipse には、AEMプロジェクトとインスタンスを完全に制御できるパースペクティブが付属しています。

chlimage_1-2

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

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

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

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

    chlimage_1-69

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

    メモ

    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. 終了」をクリックします。プロジェクト構造が作成されます。

    メモ

    新規インストール時(具体的には次の手順に従います)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 サイトでは、次の有益な情報を参照できます。

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

このページ