Ferramentas de desenvolvedor do AEM para Eclipse aem-developer-tools-for-eclipse

Motivo de imagem circular para ferramentas de desenvolvedor do AEM para Eclipse.

Visão geral overview

"Ferramentas para desenvolvedores AEM" é um plug-in do Eclipse baseado no plug-in do Eclipse para Apache Sling lançado com a Licença do Apache 2.

Ele oferece vários recursos que facilitam o desenvolvimento do AEM:

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

Requisitos requirements

Antes de usar as ferramentas de desenvolvedor do AEM, faça o seguinte:

  • 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 GB de memória heap, editando o arquivo de configuração eclipse.ini conforme descrito nas Perguntas frequentes sobre o Eclipse.

NOTE
No macOS, clique com o botão direito do mouse em Eclipse.app e selecione Mostrar Conteúdo do Pacote para encontrar seu eclipse.ini.

Como instalar as ferramentas de desenvolvedor do AEM para Eclipse how-to-install-the-aem-developer-tools-for-eclipse

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

  1. Navegue no site Ferramentas para Desenvolvedores do AEM em https://eclipse.adobe.com/aem/dev-tools/.

  2. Copie o Link de Instalação.

    Como alternativa, você pode baixar um arquivo em vez de usar o link de instalação. Isso permite a instalação offline, mas você perde as notificações de atualização automática.

  3. No Eclipse, abra o menu Ajuda.

  4. Clique em Instalar novo software.

  5. Clique em Adicionar….

  6. Em Nome, digite Ferramentas para Desenvolvedores de AEM.

  7. Em Local, copie a URL de instalação.

  8. Clique em Ok.

  9. Verifique os plug-ins do AEM e do Sling.

  10. Clique em Avançar.

  11. Clique em Avançar.

  12. Aceite os contratos lincese e clique em Concluir.

  13. Clique em Sim para reiniciar o Eclipse.

Como Importar Projetos Existentes how-to-import-existing-projects

A perspectiva do AEM the-aem-perspective

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

chlimage_1-2

Exemplo de projeto de vários módulos sample-multi-module-project

As "Ferramentas de desenvolvedor de AEM" incluem um projeto de amostra e de vários módulos que ajuda você a se familiarizar rapidamente com uma configuração de projeto no Eclipse. Ele também serve como um guia de práticas recomendadas para vários recursos do AEM. Saiba mais sobre o Arquétipo de Projeto.

Para criar o projeto de amostra, conclua as seguintes etapas:

  1. No menu Arquivo > Novo > Projeto, navegue até a seção AEM e selecione Projeto de vários módulos de amostra do AEM.

    chlimage_1-69

  2. Clique em Avançar.

    note note
    NOTE
    Esta etapa pode demorar porque o m2eclipse deve 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 Avançar.

    chlimage_1-71

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

    chlimage_1-72

  5. Agora, configure um servidor AEM ao qual o Eclipse possa se conectar.

    Para usar o recurso de depuração, verifique se você iniciou o AEM no modo de depuração, que pode ser obtido adicionando o seguinte à linha de comando:

    code language-none
        -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 note
    NOTE
    Em uma nova instalação (mais especificamente: quando as dependências do 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 troubleshooting

Resolvendo Definição de Projeto Inválida resolving-invalid-project-definition

Para resolver dependências inválidas e a definição do projeto, proceda da seguinte maneira:

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

Ativação do autopreenchimento da biblioteca de tags em arquivos JSP enabling-tag-library-autocompletion-in-jsp-files

O autopreenchimento da biblioteca de tags funciona imediatamente, já que as dependências apropriadas 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á 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 sua distribuição de AEM.

Mais informações more-information

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

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2