Eclipse を使用して AEM プロジェクトを開発する方法 how-to-develop-aem-projects-using-eclipse

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

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

NOTE

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

概要 overview

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

各手順の詳細については、このトピックで後述します。

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

NOTE

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

Eclipse のインストール install-eclipse

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

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

Maven に基づく AEM プロジェクトの設定 set-up-your-aem-project-based-on-maven

次に、AEM プロジェクトをビルドする方法に記載されている手順に従って、Maven を使用してプロジェクトを設定します。

Eclipse 用の JSP サポートの準備 prepare-jsp-support-for-eclipse

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

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

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

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

code language-xml

code language-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>

<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 プロジェクトの読み込み import-the-maven-project-into-eclipse

Eclipse で、ファイル／インポートを選択します。
インポートダイアログで、Maven／既存の Maven プロジェクトを選択し、「次へ」をクリックします。
プロジェクトの最上位のフォルダーのパスを入力し、「すべてを選択」、「終了」の順にクリックします。

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

chlimage_1-43

note note

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

NOTE

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

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2