Ferramentas de desenvolvedor do AEM para Eclipse aem-developer-tools-for-eclipse
Experience Manager
Visão geral overview
As Ferramentas para desenvolvedores do Experience Manager para Eclipse são um plug-in Eclipse baseado no plug-in 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 a quente 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, é necessário:
- Baixe e instale o Eclipse IDE para desenvolvedores Enterprise Java™.
- 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.
eclipse.ini
.Como instalar as ferramentas de desenvolvedor do AEM para Eclipse how-to-install-the-aem-developer-tools-for-eclipse
Quando tiver atendido aos requisitos acima, você poderá instalar o plug-in da seguinte maneira:
-
Copie o Link de Instalação.
Como alternativa, você pode baixar um arquivo em vez de usar o link de instalação. Este método permite a instalação offline, mas você não recebe notificações de atualização automática perdida dessa maneira.
-
No Eclipse, abra o menu Ajuda.
-
Clique em Instalar novo software.
-
Clique em Adicionar….
-
No campo Nome, digite
AEM Developer Tools
. -
No campo Local, copie a URL de instalação.
-
Clique em Adicionar.
-
Verifique os plug-ins do AEM e do Sling.
-
Clique em Avançar.
-
Na janela Detalhes da Instalação, clique novamente em Avançar.
-
Aceite os contratos de licença e clique em Concluir.
-
Clique em RestartNow para reiniciar o Eclipse.
A perspectiva do AEM the-aem-perspective
No Eclipse, uma Perspectiva determina as ações e visualizações disponíveis em uma janela e permite a interação orientada a tarefas com recursos no Eclipse. Para obter mais detalhes sobre Perspectiva, consulte a documentação do Eclipse.
As Ferramentas de Desenvolvimento do Experience Manager para Eclipse fornecem uma Perspectiva AEM que oferece controle total sobre seus projetos e instâncias do AEM. Para abrir a perspectiva do AEM:
- Na barra de menus do Eclipse, selecione Janela > Perspectiva > Abrir Perspectiva > Outras.
- Selecione AEM no diálogo e clique em Abrir.
Exemplo de projeto de vários módulos sample-multi-module-project
Experience Manager As Ferramentas do desenvolvedor 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. 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.
Siga estas etapas para criar o projeto de amostra:
-
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 : <highest-number>
no menu e clique em Avançar. -
Forneça os seguintes campos para o projeto de amostra:
- Nome
- Id Do Grupo
- Id do artefato
- appId - Talvez seja necessário expandir as opções Avançado para definir esse valor.
- appTitle - Talvez seja necessário expandir as opções Avançado para definir esse valor.
- Pacote - Talvez seja necessário expandir as opções Avançado para definir este valor.
-
Clique em Avançar.
-
Em seguida, você configura um servidor AEM ao qual o Eclipse se conecta.
Para usar o recurso do depurador, você precisa ter iniciado o AEM no modo de depuração, o que pode ser obtido ao adicionar o seguinte à linha de comando:
code language-text -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.
Como Importar Projetos Existentes how-to-import-existing-projects
Você pode usar o recurso Novo Projeto para criar a estrutura correta para você:
-
Siga as instruções para criar um Projeto de vários módulos de amostra e você terá os seguintes projetos criados para você, que permitem uma separação saudável das preocupações:
PROJECT.ui.apps
para conteúdo de/apps
e/etc
PROJECT.ui.content
para/content
criadoPROJECT.core
para pacotes Java™ (eles se tornam interessantes quando você deseja adicionar um código Java™)PROJECT.it.launcher
ePROJECT.it.tests
para testes de integração
-
Substitua o conteúdo do projeto
PROJECT.ui.apps
pelas pastasapps
eetc
do pacote:- No painel Explorador de projetos, abra
PROJECT.ui.apps
>src
>main
>content
>jcr_root
>apps
. - Clique com o botão direito do mouse na pasta
apps
e escolha Mostrar em > System Explorer. - Exclua as pastas
apps
eetc
que você deve ver e coloque aqui as pastasapps
eetc
do seu pacote de conteúdo. - No Eclipse, clique com o botão direito do mouse no projeto
PROJECT.ui.apps
e escolha Atualizar.
- No painel Explorador de projetos, abra
-
Em seguida, faça o mesmo para
PROJECT.ui.content
e substitua sua pasta de conteúdo pela de seus pacotes:- No painel Explorador de projetos, abra
PROJECT.ui.content
>src
>main
>content
>jcr_root
>content
. - Clique com o botão direito do mouse na pasta de conteúdo mais profundo e escolha Mostrar em > System Explorer.
- Exclua a pasta de conteúdo que você deve ver e coloque aqui a pasta de conteúdo do seu pacote de conteúdo.
- No Eclipse, clique com o botão direito do mouse no projeto
PROJECT.ui.content
e escolha Atualizar.
- No painel Explorador de projetos, abra
-
Agora você precisa atualizar os
filter.xml
arquivos desses dois projetos para corresponder ao conteúdo do seu pacote de conteúdo. Para isso, abra o arquivoMETA-INF/vault/filter.xml
do seu pacote de conteúdo em um editor de texto/código separado.- Este é um exemplo de como o arquivo
filter.xml
pode ser:
code language-xml <?xml version="1.0" encoding="UTF-8"?> <workspaceFilter version="1.0"> <filter root="/apps/foo"/> <filter root="/apps/foundation/components/bar"/> <filter root="/etc/designs/foo"/> <filter root="/content/foo"/> <filter root="/content/dam/foo"/> <filter root="/content/usergenerated/content/foo"/> </workspaceFilter>
- Este é um exemplo de como o arquivo
-
Quanto ao conteúdo do seu pacote que foi dividido em dois projetos, você também deve dividir essas regras de filtro em dois e atualizar adequadamente os arquivos
filter.xml
dos dois projetos.-
No Eclipse, abra
PROJECT.ui.apps/src/main/content/META-INF/filter.xml
. -
Substitua o conteúdo do elemento
<workspaceFilter>
pelas regras do seu pacote que começam com/apps
e/etc
-
Por exemplo:
code language-xml <?xml version="1.0" encoding="UTF-8"?> <workspaceFilter version="1.0"> <filter root="/apps/foo"/> <filter root="/apps/foundation/components/bar"/> <filter root="/etc/designs/foo"/> </workspaceFilter>
-
-
Em seguida, abra
PROJECT.ui.content/src/main/content/META-INF/filter.xml
. -
Substitua as regras pelas do seu pacote que começam com
/content
.-
Por exemplo:
code language-xml <?xml version="1.0" encoding="UTF-8"?> <workspaceFilter version="1.0"> <filter root="/content/foo"/> <filter root="/content/dam/foo"/> <filter root="/content/usergenerated/content/foo"/> </workspaceFilter>
-
-
-
Certifique-se de salvar todas as alterações. Agora você pode sincronizar esse novo conteúdo para sua instância do AEM.
-
No painel Servidores, verifique se a conexão foi iniciada e, se não, inicie-a.
-
Clique no ícone Limpar e Publish.
Depois de concluído, o pacote deve estar em execução na instância e, ao salvar, qualquer alteração é sincronizada automaticamente com a instância.
Se quiser recriar um pacote de seu projeto, clique com o botão direito do mouse em PROJECT.ui.apps
ou PROJECT.ui.content
e escolha Executar como > Instalação do Maven.
Agora você tem uma pasta de destino criada com seu pacote (chamada, por exemplo, PROJECT.ui.apps-0.0.1-SNAPSHOT.zip
).
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 de contexto, selecione Maven > Atualizar projetos.
- Verificar Forçar Atualizações de Instantâneos/Versões.
- Clique em OK.
O Eclipse baixa as dependências necessárias. Isso pode demorar um pouco.
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: