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 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:

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

OBSERVAÇÃO

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.

Como instalar as Ferramentas de Desenvolvedor do 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á as notificações de atualização automáticas dessa maneira.

  3. No Eclipse, abra o menu Ajuda.

  4. Clique em Instalar novo software.

  5. Clique em Adicionar….

  6. Em Nome, digite AEM Ferramentas do desenvolvedor.

  7. Em Local 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 Finish.

  13. Clique em Yes para reiniciar o Eclipse.

Como Importar Projetos Existentes

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 menu File > New > Project, navegue até a seção AEM e selecione AEM Exemplo de projeto multimódulo.

    chlimage_1-69

  2. Clique em Avançar.

    OBSERVAÇÃO

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

    chlimage_1-70

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

    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.

    OBSERVAÇÃO

    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.

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 selecione Atualizar projetos.
  3. Marque Forçar Atualizações de Snapshot/Versões.
  4. Clique em OK. O Eclipse tenta baixar as dependências necessárias.

Ativando o 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:

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

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now