Como desenvolver projetos de AEM usando o Eclipse

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

Visão geral

Para começar a usar o desenvolvimento do AEM no Eclipse, as seguintes etapas são necessárias.

Cada uma delas é explicada com mais detalhes no restante desta instrução.

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

Instalar o Eclipse

Baixe o "Eclipse IDE para desenvolvedores Java EE" no Página de downloads do Eclipse.

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

Configurar o projeto do AEM com base no Maven

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

Preparar suporte a JSP para o Eclipse

O Eclipse também pode fornecer suporte para trabalhar com JSP, por exemplo,

• preenchimento automático de bibliotecas de tags
• Reconhecimento 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 in Como criar projetos AEM usando o Apache Maven.

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

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

   Isso não é um problema: como observado no Como trabalhar com JSPs, o maven-jspc-plugin nessa configuração é usado apenas para validar a compilação de JSPs como parte do processo de build. O Eclipse já relata problemas em JSPs e não depende desse plug-in Maven para 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 "Próximo".

   

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

   

4. Agora tudo está pronto para usar o Eclipse para desenvolver seu projeto AEM, incluindo autopreenchimento JSP.

   

   OBSERVAÇÃO

   Se você incluir /libs/foundation/global.jsp ou outros JSPs no /libs, você deve copiá-lo para o seu projeto para que o Eclipse possa resolver a inclusão. Ao mesmo tempo, você precisa garantir que ele não seja incluído no seu pacote de conteúdo pelo Maven. Como fazer isso é descrito em Como construir projetos AEM usando o Apache Maven.