AEM Developer Tools for Eclipse

Visão geral

As Ferramentas do desenvolvedor do AEM para Eclipse são um plug-in do Eclipse com base no plug-in do Eclipse para Apache Sling lançado sob a licença do Apache 2.

Ele oferta vários recursos que facilitam AEM desenvolvimento:

• Integração perfeita com instâncias AEM por meio do Eclipse Server Connector.
• Sincronização de pacotes de conteúdo e OSGI.
• Suporte de depuração com capacidade de troca automática de código.
• Inicialização simples de projetos AEM por meio de um Assistente de criação de projeto específico.
• Edição fácil das propriedades do JCR.

Requisitos

Antes de usar as ferramentas do desenvolvedor AEM, é necessário:

• Baixe e instale o Eclipse IDE para desenvolvedores Java EE. Atualmente, as ferramentas de desenvolvedor do AEM são compatíveis com o Eclipse Kepler ou mais recente

• Pode ser usado com AEM versão 5.6.1 ou mais recente

• Configure a instalação do eclipse para garantir que você tenha pelo menos 1 gigabyte de memória heap editando o arquivo de configuração eclipse.ini conforme descrito em Perguntas frequentes do Eclipse.

Como instalar as ferramentas do desenvolvedor AEM para o Eclipse

Depois de atender aos requisitos acima, você pode instalar o plug-in da seguinte maneira:

1. Navegue pelo AEM Site de ferramentas do desenvolvedor.

2. Copie o Link de Instalação.

   Observe que, como alternativa, você pode baixar um arquivo em vez de usar o link de instalação. Isso permite a instalação offline, mas você perderá notificações automáticas de atualização dessa forma.

3. No Eclipse, abra o menu Ajuda.

4. Clique em Instalar novo software.

5. Clique em Adicionar….

6. Em Name, digite AEM Developer Tools.

7. Em Location copie o URL de instalação.

8. Clique em Ok.

9. Verifique os plug-ins AEM e Sling.

10. Clique em Avançar.

11. Clique em Avançar.

12. Aceite os contratos de lixeira e clique em Concluir.

13. Clique em Yes para reiniciar o Eclipse.

Como importar projetos existentes

A Perspectiva AEM

As Ferramentas de Desenvolvimento de AEM para Eclipse fornecem uma Perspectiva que oferta o controle total sobre seus projetos e instâncias de AEM.

Amostra de projeto de vários módulos

As ferramentas de desenvolvedor AEM para Eclipse vêm com uma amostra de projeto de vários módulos que ajudam você a se familiarizar rapidamente com a configuração de um projeto no Eclipse, além de servir como um guia de práticas recomendadas para vários recursos de AEM. Saiba mais sobre o Tipo de Arquivo do Projeto.

Siga estas etapas para criar o projeto de amostra:

1. No menu Arquivo > Novo > Projeto, navegue até a seção AEM e selecione AEM Amostra de Projeto Multimódulo.

   

2. Clique em Avançar.

   OBSERVAÇÃO

   Essa etapa pode levar algum tempo, pois m2eclipse precisa verificar os catálogos de arquétipos.

   

3. Escolha com.adobe.granite.archetypes : sample-project-archetype : (número mais alto) no menu e clique em Avançar.

   

4. Preencha um Nome, ID de grupo e um ID de artefato para o projeto de amostra. Você também pode optar por definir algumas propriedades avançadas.

   

5. Em seguida, configure um servidor AEM ao qual o Eclipse se conectará.

   Para usar o recurso do depurador, é necessário ter iniciado o AEM no modo de depuração - o que pode ser obtido, por exemplo, adicionando o seguinte à linha de comando:

       -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
   

   

6. Clique em Concluir. A estrutura do projeto é criada.

   OBSERVAÇÃO

   Numa instalação nova (mais especificamente: quando as dependências maven nunca foram baixadas), você pode criar o projeto com erros. Nesse caso, siga o procedimento descrito em Resolvendo definição de projeto inválida.

Resolução de problemas

Resolvendo Definição de Projeto Inválida

Para resolver dependências inválidas e definição de projeto, siga estas instruções:

1. Selecione todos os projetos criados.
2. Clique com o botão direito do mouse. No menu Maven selecione Atualizar projetos.
3. Verifique Forçar Atualizações de Instantâneos/Versões.
4. Clique em OK. O Eclipse tenta baixar as dependências necessárias.

Habilitando a autocompletar da biblioteca de tags em arquivos JSP

A autoconclusão da biblioteca de tags funciona fora da caixa, visto que as dependências adequadas são adicionadas ao projeto. Há um problema conhecido ao usar o AEM Uber Jar, que não inclui os arquivos tld e TagExtraInfo necessários.

Para contornar isso, verifique se o artefato org.apache.sling.scripting.jsp.taglib está localizado no classpath antes do AEM Uber Jar. Para projetos Maven, coloque a seguinte dependência no pom.xml antes do Uber Jar.

<dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.scripting.jsp.taglib</artifactId>
  <scope>provided</scope>
</dependency>

Certifique-se de adicionar a versão correta para a implantação do AEM.

Mais informações

A ferramenta oficial Apache Sling IDE para o site Eclipse fornece informações úteis:

• A ferramenta Apache Sling IDE para o Guia do Usuário do Eclipse, esta documentação o guiará pelos conceitos gerais, integração de servidor e recursos de implantação suportados pelas Ferramentas de Desenvolvimento AEM.
• A seção Resolução de problemas.
• Os problemas conhecidos são listas.

A seguinte documentação oficial do Eclipse pode ajudar a configurar seu ambiente:

• Introdução ao Eclipse
• Sistema de ajuda do Eclipse Luna
• Integração Maven (m2eclipse)