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 プロジェクトの設定

次に、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. プロジェクトの最上位のフォルダーのパスを入力し、「すべてを選択」、「終了」の順にクリックします。

    chlimage_1-42

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

    chlimage_1-43

    メモ

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

このページ