Show Menu
TÓPICOS×

Ferramentas de desenvolvedor do AEM para Eclipse

Visão geral

As ferramentas de desenvolvedor do AEM para Eclipse são um plug-in do Eclipse baseado no plug-in do Eclipse para o Apache Sling lançado sob a licença do Apache 2.
Ele oferece vários recursos que facilitam o desenvolvimento do AEM:
  • Integração perfeita com instâncias do 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 do 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 o 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 eclipse.ini configuração conforme descrito nas Perguntas frequentes do Eclipse .
No macOS, você precisa clicar com o botão direito do mouse em Eclipse.app e selecionar Mostrar conteúdo do pacote para encontrar seu eclipse.ini .

Como instalar as ferramentas do desenvolvedor do AEM para o Eclipse

Depois de cumprir os requisitos acima, você pode instalar o plug-in da seguinte maneira:
  1. 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.
  2. No Eclipse, abra o menu Ajuda .
  3. Clique em Instalar novo software .
  4. Clique em Adicionar... .
  5. Em Nome , digite Ferramentas do desenvolvedor do AEM.
  6. Em Local , copie o URL de instalação.
  7. Click Ok .
  8. Verifique os plug-ins AEM e Sling .
  9. Clique em Avançar .
  10. Clique em Avançar .
  11. Aceite os contratos de lixeira e clique em Concluir .
  12. Clique em Sim para reiniciar o Eclipse.

A perspectiva do AEM

As Ferramentas de desenvolvimento do AEM para Eclipse são enviadas com uma Perspectiva que oferece controle total sobre seus projetos e instâncias do AEM.

Exemplo de projeto de vários módulos

As Ferramentas de desenvolvedor do AEM para Eclipse vêm com uma amostra de projeto de vários módulos que ajuda 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 do 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 Sample Multi-Module Project .
  2. Clique em Avançar .
    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 , uma ID de grupo e uma 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. Click Finish . A estrutura do projeto é criada.
    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 Resolução de 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.

Habilitar 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 sua implantação do AEM.

More information

A ferramenta oficial Apache Sling IDE para o site Eclipse fornece informações úteis:
A seguinte documentação oficial do Eclipse pode ajudar a configurar seu ambiente: