Ferramentas de desenvolvedor do AEM para Eclipse aem-developer-tools-for-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.iniconforme descrito nas Perguntas frequentes sobre o Eclipse.
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:
-
Navegue no site Ferramentas para Desenvolvedores do AEM em
https://eclipse.adobe.com/aem/dev-tools/. -
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.
-
No Eclipse, abra o menu Ajuda.
-
Clique em Instalar novo software.
-
Clique em Adicionar….
-
Em Nome, digite Ferramentas para Desenvolvedores de AEM.
-
Em Local, copie a URL de instalação.
-
Clique em Ok.
-
Verifique os plug-ins do AEM e do Sling.
-
Clique em Avançar.
-
Clique em Avançar.
-
Aceite os contratos lincese e clique em Concluir.
-
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.
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:
-
No menu Arquivo > Novo > Projeto, navegue até a seção AEM e selecione Projeto de vários módulos de amostra do AEM.
-
Clique em Avançar.
note note NOTE Esta etapa pode demorar porque o m2eclipse deve verificar os catálogos de arquétipo. 
-
Escolha com.adobe.granite.archetypes : sample-project-archetype : (número mais alto) no menu e clique em Avançar.
-
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.
-
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
-
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:
- Selecione todos os projetos criados.
- Clique com o botão direito do mouse em. No menu Maven, selecione Atualizar Projetos.
- Verificar Forçar Atualizações de Instantâneos/Versões.
- 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 Ferramenta Apache Sling IDE para Eclipse Guia do Usuário, esta documentação orienta você pelos conceitos gerais, integração de servidor e recursos de implantação compatíveis com as Ferramentas de Desenvolvimento AEM.
- A seção Solução de problemas.
- A lista de problemas conhecidos.
A documentação oficial Eclipse a seguir pode ajudar a configurar seu ambiente: