Ferramentas de desenvolvedor do AEM para Eclipse

Última atualização: 4 de maio de 2023

Criado para:

  • Desenvolvedor
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Visão geral

O AEM Developer Tools for Eclipse é um plug-in Eclipse com base no Plug-in do Eclipse para o Apache Sling lançado sob a licença do Apache 2.

Ela oferece vários recursos que facilitam AEM desenvolvimento:

  • Integração perfeita com instâncias AEM por meio do Eclipse Server Connector.
  • Sincronização para pacotes de conteúdo e OSGI.
  • Suporte à depuração com capacidade de troca dinâmica de código.
  • Inicialização simples de projetos de 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 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 eclipse.ini arquivo de configuração, conforme descrito na Perguntas frequentes sobre o Eclipse.

NOTE
No macOS, é necessário clicar com o botão direito do mouse em Eclipse.app e depois selecione Mostrar conteúdo do pacote para encontrar seu eclipse.ini.

Como instalar as Ferramentas de Desenvolvedor do AEM para o Eclipse

Uma vez que tenha cumprido o requisitos acima, você pode instalar o plug-in da seguinte maneira:

  1. Navegue pelo AEM Site das 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á as notificações de atualização automáticas dessa maneira.

  3. No Eclipse, abra o Ajuda menu.

  4. Clique em Instalar novo software.

  5. Clique em Adicionar….

  6. Em Nome digite AEM Ferramentas do desenvolvedor.

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

  8. Clique em Ok.

  9. Verifique ambos AEM e Sling plug-ins.

  10. Clique em Avançar.

  11. Clique em Avançar.

  12. Aceite os contratos do lixão e clique em Concluir.

  13. Clique em Sim para reiniciar o Eclipse.

Como Importar Projetos Existentes

NOTE

A perspectiva AEM

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.

chlimage_1-2

Exemplo de projeto de vários módulos

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:

  1. No Arquivo > Novo > Projeto navegue até o menu AEM e selecione AEM exemplo de projeto de vários módulos.

    chlimage_1-69

  2. Clique em Avançar.

    NOTE
    Essa etapa pode demorar um pouco, pois m2eclipse precisa verificar os catálogos de arquétipo.

    chlimage_1-70

  3. Choose com.adobe.granite.archetypes : sample-project-archetype : (número mais alto) no menu e, em seguida, clique em Próximo.

    chlimage_1-71

  4. 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.

    chlimage_1-72

  5. 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

    chlimage_1-73

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

    NOTE
    Numa nova instalação (mais especificamente: quando as dependências maven nunca tiverem sido baixadas), você poderá criar o projeto com erros. Neste 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, proceda da seguinte maneira:

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

Ativação do autopreenchimento da biblioteca de tags em arquivos JSP

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.

Mais informações

O site oficial Apache Sling IDE tooling for Eclipse fornece informações úteis:

O seguinte funcionário Eclipse a documentação pode ajudar a configurar seu ambiente:

Página anterior
Próxima página

Experience Manager