Eclipse を使用して AEM プロジェクトを開発する方法

このガイドでは、Eclipse を使用して AEM ベースのプロジェクトを開発する方法について説明します。

メモ

アドビでは、Eclipse による AEM ソリューションの開発を支援する AEM Developer Tools for Eclipse を提供しています。

概要

Eclipse で AEM の開発を開始するには、次の手順を実行する必要があります。

各手順の詳細については、このページで後述します。

  • Eclipse 4.3（Kepler）のインストール
  • Maven に基づく AEM プロジェクトの設定
  • Maven POM での Eclipse 用の JSP サポートの準備
  • Eclipse への Maven プロジェクトの読み込み
メモ

このガイドは Eclipse 4.3（Kepler）と AEM 5.6.1 を基に作成されています。

Eclipse のインストール

Eclipse のダウンロードページから「Eclipse IDE for Java EE Developers」をダウンロードします。

インストール手順に従って Eclipse をインストールします。

Maven に基づく AEM プロジェクトの設定

次に、Apache Mavenを使用してAEMプロジェクトをビルドする方法の説明に従って、Mavenを使用してプロジェクトをセットアップします。

Eclipse 用の JSP サポートの準備

Eclipse では JSP との連携もサポートされます。サポートされる項目の例を次に示します。

  • タグライブラリのオートコンプリート
  • <cq:defineObjects /> と <sling:defineObjects /> で定義されたオブジェクトの Eclipse での認識

サポートを有効にするには、次の手順を実行します。

  1. Apache Mavenを使用してAEMプロジェクトをビルドする方法のJSPを使用する方法の手順に従ってください。

  2. コンテンツモジュールの 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 への Maven プロジェクトの読み込み

  1. Eclipse で、File／Import を選択します。

  2. Import ダイアログで、Maven／Existing Maven Projects を選択し、「Next」をクリックします。

    chlimage_1-41

  3. プロジェクトの最上位のフォルダーのパスを入力して、「Select All」、「Finish」の順にクリックします。

    chlimage_1-42

  4. これで、Eclipse を使用して AEM プロジェクトを開発するための設定（JSP のオートコンプリートを含む）がすべて完了しました。

    chlimage_1-43

    メモ

    /libs/foundation/global.jspまたは他のJSPを/libsに含める場合は、Eclipseがインクルージョンを解決できるように、そのJSPをプロジェクトにコピーする必要があります。 同時に、Mavenによってコンテンツパッケージにバンドルされていないことを確認する必要があります。 これを実現する方法については、Apache Mavenを使用してAEMプロジェクトをビルドする方法を参照してください。

このページ