As Ferramentas de 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.
Ela oferece vários recursos que facilitam AEM desenvolvimento:
Antes de usar as Ferramentas do desenvolvedor do AEM, é necessário:
Baixe e instale o Eclipse IDE para desenvolvedores Java EE. AEM Ferramentas de desenvolvedor atualmente oferecem suporte ao Eclipse Kepler ou mais recente
Pode ser usado com AEM versão 5.6.1 ou mais recente
Configure sua instalação do eclipse para garantir que você tenha pelo menos 1 gigabyte de memória heap editando seu arquivo de configuração eclipse.ini
conforme descrito nas Perguntas frequentes do Eclipse.
No macOS, é necessário clicar com o botão direito do mouse em Eclipse.app e depois selecionar Mostrar conteúdo do pacote para localizar seu eclipse.ini
.
Depois de atender aos requisitos acima, você pode instalar o plug-in da seguinte maneira:
Navegue pelo AEM Site de Ferramentas do Desenvolvedor.
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á as notificações de atualização automáticas dessa maneira.
No Eclipse, abra o menu Ajuda.
Clique em Instalar novo software.
Clique em Adicionar….
Em Nome, digite AEM Ferramentas do desenvolvedor.
Em Local copie o URL de instalação.
Clique em Ok.
Verifique os plug-ins AEM e Sling.
Clique em Avançar.
Clique em Avançar.
Aceite os contratos de lixeira e clique em Finish.
Clique em Yes para reiniciar o Eclipse.
As Ferramentas de Desenvolvimento de AEM para o Eclipse são fornecidas com uma Perspectiva que oferece controle total sobre seus projetos e instâncias de AEM.
O AEM Developer Tools for Eclipse vem com uma amostra de projeto de vários módulos que ajuda você a se familiarizar rapidamente com a configuração do projeto no Eclipse, além de servir como um guia de práticas recomendadas para vários recursos AEM. Saiba mais sobre o Arquétipo de projeto.
Siga estas etapas para criar o projeto de amostra:
No menu File > New > Project, navegue até a seção AEM e selecione AEM Exemplo de projeto multimódulo.
Clique em Avançar.
Essa etapa pode demorar um pouco, pois m2eclipse precisa verificar os catálogos de arquétipo.
Escolha com.adobe.granite.archetypes : sample-project-archetype : (número mais alto) no menu e clique em Next.
Preencha um Nome, ID do grupo e um ID do artefato para o projeto de amostra. Também é possível optar por definir algumas propriedades avançadas.
Em seguida, você deve configurar 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 feito, por exemplo, adicionando o seguinte à linha de comando:
-nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
Clique em Concluir. A estrutura do projeto é criada.
Numa nova instalação (mais especificamente: quando as dependências maven nunca tiverem sido baixadas), você poderá criar o projeto com erros. Nesse caso, siga o procedimento descrito em Resolvendo Definição de Projeto Inválida.
Para resolver dependências inválidas e definição de projeto, proceda da seguinte maneira:
O autopreenchimento da biblioteca de tags funciona imediatamente, 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 adequada para a implantação do AEM.
O site oficial Apache Sling IDE tooling for Eclipse fornece informações úteis:
A seguinte documentação oficial Eclipse pode ajudar a configurar seu ambiente: