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

Experience Manager Ferramentas do desenvolvedor para o logotipo do Eclipse

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:

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

Quando tiver atendido aos requisitos acima, você poderá instalar o plug-in da seguinte maneira:

  1. Abra o Site de Ferramentas do Desenvolvedor do AEM.

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

  3. No Eclipse, abra o menu Ajuda.

  4. Clique em Instalar novo software.

  5. Clique em Adicionar….

  6. No campo Nome, digite AEM Developer Tools.

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

  8. Clique em Adicionar.

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

  10. Clique em Avançar.

  11. Na janela Detalhes da Instalação, clique novamente em Avançar.

  12. Aceite os contratos de licença e clique em Concluir.

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

  1. Na barra de menus do Eclipse, selecione Janela > Perspectiva > Abrir Perspectiva > Outras.
  2. Selecione AEM no diálogo e clique em Abrir.

A perspectiva do AEM no Eclipse

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:

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

    Projeto de vários módulos de amostra do AEM

  2. Clique em Avançar.

    note note
    NOTE
    Esta etapa pode demorar porque o m2eclipse deve verificar os catálogos de arquétipo.
  3. Escolha com.adobe.granite.archetypes : sample-project-archetype : <highest-number> no menu e clique em Avançar.

    Selecionar versão do arquétipo

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

    Definir propriedades do arquétipo

  5. Clique em Avançar.

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

    Conectar-se ao servidor AEM

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

  1. 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 criado
    • PROJECT.core para pacotes Java™ (eles se tornam interessantes quando você deseja adicionar um código Java™)
    • PROJECT.it.launcher e PROJECT.it.tests para testes de integração
  2. Substitua o conteúdo do projeto PROJECT.ui.apps pelas pastas apps e etc do pacote:

    1. No painel Explorador de projetos, abra PROJECT.ui.apps > src > main > content > jcr_root > apps.
    2. Clique com o botão direito do mouse na pasta apps e escolha Mostrar em > System Explorer.
    3. Exclua as pastas apps e etc que você deve ver e coloque aqui as pastas apps e etc do seu pacote de conteúdo.
    4. No Eclipse, clique com o botão direito do mouse no projeto PROJECT.ui.apps e escolha Atualizar.
  3. Em seguida, faça o mesmo para PROJECT.ui.content e substitua sua pasta de conteúdo pela de seus pacotes:

    1. No painel Explorador de projetos, abra PROJECT.ui.content > src > main > content > jcr_root > content.
    2. Clique com o botão direito do mouse na pasta de conteúdo mais profundo e escolha Mostrar em > System Explorer.
    3. Exclua a pasta de conteúdo que você deve ver e coloque aqui a pasta de conteúdo do seu pacote de conteúdo.
    4. No Eclipse, clique com o botão direito do mouse no projeto PROJECT.ui.content e escolha Atualizar.
  4. 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 arquivo META-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>
    
  5. 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.

    1. No Eclipse, abra PROJECT.ui.apps/src/main/content/META-INF/filter.xml.

    2. 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>
        
    3. Em seguida, abra PROJECT.ui.content/src/main/content/META-INF/filter.xml.

    4. 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>
        
  6. Certifique-se de salvar todas as alterações. Agora você pode sincronizar esse novo conteúdo para sua instância do AEM.

  7. No painel Servidores, verifique se a conexão foi iniciada e, se não, inicie-a.

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

  1. Selecione todos os projetos criados.
  2. Clique com o botão direito do mouse em.
  3. No menu de contexto, selecione Maven > Atualizar projetos.
  4. Verificar Forçar Atualizações de Instantâneos/Versões.
  5. 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 documentação oficial Eclipse a seguir pode ajudar a configurar seu ambiente:

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab