Como desenvolver projetos AEM usando o Eclipse

Este guia descreve como usar o Eclipse para desenvolver projetos baseados em AEM.

Visão geral

Para começar a desenvolver AEM no Eclipse, são necessárias as etapas a seguir.

Cada um deles é explicado mais detalhadamente no restante deste Como.

• Instalar o Eclipse 4.3 (Kepler)
• Configure seu projeto AEM com base no Maven
• Preparar suporte JSP para Eclipse no Maven POM
• Importar o projeto Maven para o Eclipse

Instalar o Eclipse

Baixe o "Eclipse IDE for Java EE Developers" da página Downloads do Eclipse.

Instale o Eclipse seguindo as Instruções de instalação.

Configure seu projeto AEM com base em Maven

Em seguida, configure seu projeto usando o Maven conforme descrito em Construir projetos AEM usando o Apache Maven.

Preparar suporte JSP para Eclipse

O Eclipse também pode fornecer suporte ao trabalho com o JSP, por exemplo,

• conclusão automática de bibliotecas de tags
• Consentização do Eclipse de objetos definidos por <cq:defineObjects /> e <sling:defineObjects />

Para que isso funcione:

1. Siga as instruções em Como trabalhar com JSPs em Construir projetos AEM usando o Apache Maven.

2. Adicione o seguinte à seção <build /> no POM do módulo de conteúdo.

   O plug-in de suporte Maven do Eclipse, m2e, não fornece suporte para o plug-in maven-jspc-e, e essa configuração instrui o m2e a ignorar o plug-in e a tarefa relacionada de limpar os resultados da compilação temporária.

   Isso não é um problema: como observado em Como trabalhar com JSPs, o plug-in maven-jspc-nesta configuração só é usado para validar a compilação de JSPs como parte do processo de compilação. O Eclipse já informa quaisquer problemas em JSPs e não depende deste plug-in Maven para poder fazer isso.

   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>
   

Importar o projeto Maven para o Eclipse

1. No Eclipse, escolha Arquivo > Importar…

2. Na caixa de diálogo Importar, escolha Maven > Projetos Maven existentes e clique em "Avançar".

   

3. Digite o caminho para a pasta de nível superior do projeto e clique em "Selecionar tudo" e "Concluir".

   

4. Agora, todos os usuários estão prontos para usar o Eclipse para desenvolver seu projeto AEM, incluindo a conclusão automática do JSP.

   

   OBSERVAÇÃO

   Se você incluir /libs/foundation/global.jsp ou outros JSPs em /libs, precisará copiá-los para o seu projeto para que o Eclipse possa resolver a inclusão. Ao mesmo tempo, é necessário certificar-se de que ele não esteja incluído em seu pacote de conteúdo pela Maven. Como fazer isso é descrito em Como criar projetos AEM usando o Apache Maven.