Eclipse のExperience Manager開発者ツール は、 Eclipse plugin for Apache Sling Apache License 2 に基づいてリリースされました。
このツールは、AEM 開発を容易にする次のような機能を提供します。
AEM Developer Tools を使用する前に、次の作業が必要です。
eclipse.ini
設定ファイル ( Eclipse の FAQ.macOS では、Eclipse.app を右クリックし、「パッケージの内容を表示」を選択して、eclipse.ini
を探します。
前述の要件を満たしたら、次の手順でプラグインをインストールできます。
AEM 開発者ツールの web サイトを開きます。
を インストールリンク.
または、インストールリンクを使用する代わりにアーカイブをダウンロードできます。 この方法ではオフラインインストールが可能ですが、自動アップデート通知は受けられません。
Eclipse で、 ヘルプ メニュー
クリック 新しいソフトウェアのインストール.
クリック 追加….
内 名前 フィールドに入力 AEM Developer Tools
.
内 場所 「 」フィールドで、インストール URL をコピーします。
「Add」をクリックします。
両方を選択 AEM および Sling プラグイン
「Next」をクリックします。
Install Details ウィンドウで、「Next」を再度クリックします。
使用許諾契約書に同意し、「Finish」をクリックします。
「Restart Now」をクリックして、Eclipse を再起動します。
Eclipse では、パースペクティブは、ウィンドウ内で使用可能なアクションとビューを決定し、Eclipse 内のリソースとタスク指向のやり取りを可能にします。 パースペクティブについて詳しくは、Eclipse のドキュメントを参照してください。
Eclipse 用Experience Manager開発ツール AEMプロジェクトとインスタンスを完全に制御できるAEMパースペクティブを提供します。 AEM パースペクティブを開くには、次の操作を行います。
この Eclipse のExperience Manager開発者ツール には、Eclipse でのプロジェクト設定をすばやく習得できる、サンプルのマルチモジュールプロジェクトが付属しています。 また、AEMのいくつかの機能のベストプラクティスガイドとしても機能します。 プロジェクトのアーキタイプについて詳しくは、こちらを参照してください。
サンプルプロジェクトを作成するには、次の手順に従います。
内 ファイル > 新規 > プロジェクト メニュー、参照 AEM 「 」セクションで「 」を選択します。 AEM Sample Multi-Module Project.
「Next」をクリックします。
m2eclipse がアーキタイプカタログをスキャンする必要があるので、この手順には少し時間がかかることがあります。
メニューから「com.adobe.granite.archetypes : sample-project-archetype : <highest-number>
」を選択し、「Next」をクリックします。
サンプルプロジェクトの次のフィールドを指定します。
「Next」をクリックします。
次に、Eclipse が接続するAEMサーバーを設定します。
デバッガー機能を使用するには、デバッグモードでAEMを起動する必要があります。これを実現するには、次のコマンドをコマンドラインに追加します。
-nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
「終了」をクリックします。プロジェクト構造が作成されます。
新規インストールの場合(より具体的には、Maven の依存関係をダウンロードしたことがない場合)は、プロジェクトを作成するとエラーが表示されることがあります。この場合は、 無効なプロジェクト定義の解決.
New Project 機能を使用して、適切な構造を次の手順で作成できます。
手順に従って、 マルチモジュールプロジェクトのサンプル 次のプロジェクトが作成され、問題の健全な分離を可能にします。
PROJECT.ui.apps
:/apps
および /etc
のコンテンツ用PROJECT.ui.content
:/content
の作成済みコンテンツ用PROJECT.core
Java™バンドルの場合 (Java™コードを追加すると興味深くなります )PROJECT.it.launcher
および PROJECT.it.tests
:統合テスト用PROJECT.ui.apps
プロジェクトの内容をパッケージの apps
フォルダーと etc
フォルダーに置き換えます。
PROJECT.ui.apps
/src
/main
/content
/jcr_root
/apps
を展開します。apps
フォルダーを右クリックし、Show In/System Explorer を選択します。apps
フォルダーと etc
フォルダーを削除し、その場所にコンテンツパッケージの apps
フォルダーと etc
フォルダーを配置します。PROJECT.ui.apps
プロジェクトを右クリックし、「Refresh」を選択します。次に、 PROJECT.ui.content
そのコンテンツフォルダーを、次のいずれかのパッケージに置き換えます。
PROJECT.ui.content
/src
/main
/content
/jcr_root
/content
を展開します。PROJECT.ui.content
プロジェクトを右クリックし、「Refresh」を選択します。次に、コンテンツパッケージの内容に対応するように、これら 2 つのプロジェクトの filter.xml
ファイルを更新する必要があります。それには、コンテンツパッケージの META-INF/vault/filter.xml
ファイルを別のテキスト/コードエディターで開きます。
filter.xml
ファイルの例を次に示します。<?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
<filter root="/apps/foo"/>
<filter root="/apps/foundation/components/bar"/>
<filter root="/etc/designs/foo"/>
<filter root="/content/foo"/>
<filter root="/content/dam/foo"/>
<filter root="/content/usergenerated/content/foo"/>
</workspaceFilter>
2 つのプロジェクトに分割されたパッケージのコンテンツについては、これらのフィルタールールも 2 つに分割し、それに応じて filter.xml
2 つのプロジェクトのファイル。
Eclipse で PROJECT.ui.apps/src/main/content/META-INF/filter.xml
を開きます。
<workspaceFilter>
要素の内容を、/apps
または /etc
で始まる、パッケージのルールに置き換えます
例えば、次のようにします。
<?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
<filter root="/apps/foo"/>
<filter root="/apps/foundation/components/bar"/>
<filter root="/etc/designs/foo"/>
</workspaceFilter>
次に、PROJECT.ui.content/src/main/content/META-INF/filter.xml
を開きます。
ルールを、/content
で始まる、パッケージのルールに置き換えます。
例えば、次のようにします。
<?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
<filter root="/content/foo"/>
<filter root="/content/dam/foo"/>
<filter root="/content/usergenerated/content/foo"/>
</workspaceFilter>
すべての変更を保存してください。これで、新しいコンテンツが AEM インスタンスに同期するようになりました。
Servers パネルで、接続が開始されていることを確認します。開始していない場合は開始します。
「Clean and Publish」アイコンをクリックします。
完了したら、インスタンスでパッケージが動作しており、保存時には、変更が自動的にインスタンスに同期します。
プロジェクトからパッケージを再ビルドする場合は、PROJECT.ui.apps
または PROJECT.ui.content
を右クリックし、Run As/Maven install を選択します。
これで、パッケージ(例えば、PROJECT.ui.apps-0.0.1-SNAPSHOT.zip
)を含んだターゲットフォルダーが作成されました。
無効な依存関係およびプロジェクト定義を解決するには、次の手順を実行します。
必要な依存関係が自動的にダウンロードされます。これには少し時間がかかる場合があります。
Apache Sling IDE tooling for Eclipse の公式 web サイトでは、次の有益な情報を参照できます。
次の公式の Eclipse ドキュメントは、環境の設定に役立ちます。