このガイドでは、Eclipse を使用して AEM ベースのプロジェクトを開発する方法について説明します。
アドビでは、Eclipse による AEM ソリューションの開発を支援する AEM Developer Tools for Eclipse を提供しています。
Eclipse で AEM の開発を開始するには、次の手順を実行する必要があります。
各手順の詳細については、このページで後述します。
このガイドは Eclipse 4.3(Kepler)と AEM 5.6.1 を基に作成されています。
Eclipse のダウンロードページ から「Eclipse IDE for Java EE Developers」をダウンロードします。
インストール手順に従って Eclipse をインストールします。
次に、AEM プロジェクトをビルドする方法に記載されている手順に従って、Maven を使用してプロジェクトを設定します。
Eclipse では JSP との連携もサポートされます。サポートされる項目の例を次に示します。
サポートを有効にするには、次の手順を実行します。
Apache Maven を使用して AEM プロジェクトを作成する方法の JSP を使用する方法に記載されている説明に従います。
コンテンツモジュールの POM 内の <build /> セクションに次の項目を追加します。
Eclipse の Maven サポートプラグインである m2e は maven-jspc-plugin のサポートを提供しません。この設定は、プラグインおよび一時的なコンパイルの結果のクリーンアップの関連タスクを無視するように m2e に通知します。
このことは問題ではありません。JSP を使用する方法で説明されているように、この設定における maven-jspc-plugin は、作成プロセスの一環として JSP コンパイルの検証にのみ使用されます。Eclipse は JSP における問題を既にレポート済みであり、レポート用にこの Maven プラグインを使用することはありません。
myproject/content/pom.xml
<build>
<!-- ... -->
<pluginManagement>
<plugins>
<!--This plugin's configuration is used to store Eclipse m2e settings only. It has no influence on the Maven build itself.-->
<plugin>
<groupId>org.eclipse.m2e</groupId>
<artifactId>lifecycle-mapping</artifactId>
<version>1.0.0</version>
<configuration>
<lifecycleMappingMetadata>
<pluginExecutions>
<pluginExecution>
<pluginExecutionFilter>
<groupId>org.apache.sling</groupId>
<artifactId>maven-jspc-plugin</artifactId>
<versionRange>[2.0.6,)</versionRange>
<goals>
<goal>jspc</goal>
</goals>
</pluginExecutionFilter>
<action>
<ignore/>
</action>
</pluginExecution>
<pluginExecution>
<pluginExecutionFilter>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-clean-plugin</artifactId>
<versionRange>[2.4.1,)</versionRange>
<goals>
<goal>clean</goal>
</goals>
</pluginExecutionFilter>
<action>
<ignore/>
</action>
</pluginExecution>
</pluginExecutions>
</lifecycleMappingMetadata>
</configuration>
</plugin>
</plugins>
</pluginManagement>
</build>
Eclipse で、File/Import を選択します。
Import ダイアログで、Maven/Existing Maven Projects を選択し、「Next」をクリックします。
プロジェクトの最上位のフォルダーのパスを入力し、「すべてを選択」、「終了」の順にクリックします。
これで、Eclipse を使用して AEM プロジェクトを開発するための設定(JSP のオートコンプリートを含む)がすべて完了しました。
/libs/foundation/global.jsp
または内の他の JSP/libs
を含める場合は、これらをプロジェクトにコピーして、Eclipse が包含を解決できるようにする必要があります。同時に、Maven によってコンテンツパッケージにバンドルされていないことを確認する必要があります。これをおこなう方法については、Apache Maven を使用して AEM プロジェクトを作成する方法で説明されています。