Configurar ferramentas de desenvolvimento

O desenvolvimento do Adobe Experience Manager (AEM) requer que um conjunto mínimo de ferramentas de desenvolvimento seja instalado e configurado na máquina do desenvolvedor. Estas ferramentas apoiam o desenvolvimento e a criação de projetos AEM.

Observe que ~ é usado como abreviado para o Diretório do usuário. No Windows, isso é equivalente a %HOMEPATH%.

Instalar Java

O Experience Manager é um aplicativo Java e, portanto, requer o SDK do Java para suportar o desenvolvimento e o SDK as a Cloud Service AEM.

  1. Baixe e instale a versão mais recente do SDK do Java 11
  2. Verifique se o SDK do Java 11 está instalado executando o comando:
    • Windows: java -version
    • macOS / Linux: java --version

Java

Instalar o Homebrew

O uso do Homebrew é opcional, mas recomendado.

O Homebrew é um gerenciador de pacotes de código aberto para macOS, Windows e Linux. Todas as ferramentas de suporte podem ser instaladas separadamente, o Homebrew fornece uma maneira conveniente de instalar e atualizar uma variedade de ferramentas de desenvolvimento necessárias para o desenvolvimento do Experience Manager.

  1. Abra o terminal
  2. Verifique se o Homebrew já está instalado executando o comando: brew --version.
  3. Se o Homebrew não estiver instalado, instale o Homebrew
  4. Verifique se o Homebrew está instalado executando o comando: brew --version

Homebrew

Se estiver a utilizar Homebrew, siga as Instalar usando o Homebrew instruções nas seções abaixo. Se você not usando o Homebrew, instale as ferramentas usando os links específicos do SO.

Instalar Git

Git é o sistema de gestão do controlo de origem utilizado por Adobe Cloud Managere, por conseguinte, é necessário para o desenvolvimento.

  • Instalar o Git usando o Homebrew
    1. Abra o terminal/prompt de comando
    2. Execute o comando: brew install git
    3. Verifique se o Git está instalado, usando o comando: git --version
  • Ou baixe e instale o Git (macOS, Linux ou Windows)
    1. Baixe e instale o Git
    2. Abra o terminal/prompt de comando
    3. Verifique se o Git está instalado, usando o comando: git --version

Git

Instalar o Node.js (e npm)

Node.js é um ambiente de tempo de execução JavaScript usado para trabalhar com os ativos de front-end de um projeto de AEM ui.frontend subprojeto. O Node.js é distribuído com npm, é o gerenciador de pacotes Node.js padrão, usado para gerenciar dependências do JavaScript.

  • Instalar o Node.js usando o Homebrew
    1. Abra o terminal/prompt de comando
    2. Execute o comando: brew install node
    3. Verifique se Node.js está instalado, usando o comando: node -v
    4. Verifique se o npm está instalado, usando o comando: npm -v
  • Ou baixe e instale o Node.js (macOS, Linux ou Windows)
    1. Baixe e instale o Node.js
    2. Abra o terminal/prompt de comando
    3. Verifique se Node.js está instalado, usando o comando: node -v
    4. Verifique se o npm está instalado, usando o comando: npm -v

Node.js e npm

DICA

Arquétipo de projeto AEMCom base em AEM Projetos instala uma versão isolada do Node.js no momento da criação. É bom manter a versão do sistema de desenvolvimento local sincronizada (ou próxima) das versões Node.js e npm especificadas no Reator pom.xml do projeto Maven AEM.

Veja este exemplo AEM Pom.xml do Reator do Projeto para onde localizar as versões da build Node.js e npm.

Instalar o Maven

O Apache Maven é a ferramenta de linha de comando Java de código aberto usada para criar Projetos AEM gerados pelo Arquétipo Maven do Projeto AEM. Todos os IDEs principais (IntelliJ IDEA, Código do Visual Studio, Eclipse, etc.) têm suporte integrado para Maven.

  • Instale o Maven usando o Homebrew
    1. Abra o terminal/prompt de comando
    2. Execute o comando: brew install maven
    3. Verifique se o Maven está instalado, usando o comando: mvn -v
  • Ou, baixar e instalar o Maven (macOS, Linux ou Windows)
    1. Baixar o Maven
    2. Instalar o Maven
    3. Abra o terminal/prompt de comando
    4. Verifique se o Maven está instalado, usando o comando: mvn -v

Maven

Configurar a CLI do Adobe I/O

O Adobe I/O CLIou aio, fornece acesso de linha de comando a uma variedade de serviços da Adobe, incluindo Cloud Manager e asset compute. A CLI do Adobe I/O desempenha um papel integral no desenvolvimento em AEM as a Cloud Service, pois oferece aos desenvolvedores a capacidade de:

  • Logs de email do AEM as a Cloud Services services
  • Gerenciar pipelines do Cloud Manager da CLI

Instale a CLI do Adobe I/O

  1. Garantir Node.js está instalado já que o Adobe I/O CLI é um módulo npm
    • Executar node --version para confirmar
  2. Executar npm install -g @adobe/aio-cli para instalar o aio módulo npm globalmente

Configurar o plugin Adobe I/O CLI Cloud Manager

O plugin Adobe I/O Cloud Manager permite que a CLI do aio interaja com o Adobe Cloud Manager por meio da aio cloudmanager comando.

  1. Executar aio plugins:install @adobe/aio-cli-plugin-cloudmanager para instalar o plug-in do aio Cloud Manager.

Configurar o plugin Adobe I/O CLI Asset compute

O plugin do Adobe I/O Cloud Manager permite que a CLI do aio gere e execute trabalhadores do Asset compute por meio da aio asset-compute comando.

  1. Executar aio plugins:install @adobe/aio-cli-plugin-asset-compute para instalar o plug-in do Asset compute aio.

Configurar a autenticação da CLI do Adobe I/O

Para que a CLI do Adobe I/O se comunique com o Cloud Manager, uma A integração do Cloud Manager deve ser criada no Console do Adobe I/OAs credenciais e devem ser obtidas para a autenticação bem-sucedida.

  1. Faça logon em console.adobe.io
  2. Certifique-se de que a organização que inclui o produto Cloud Manager ao qual se conectar esteja ativa no seletor de organização do Adobe
  3. Crie um novo ou abra um Programa Adobe I/O
    • Os programas do Console do Adobe I/O são simplesmente agrupamentos organizacionais de integrações, criar ou usar e programas existentes com base em como você deseja gerenciar suas integrações
    • Se criar um novo projeto, selecione "Projeto vazio", se solicitado (vs. "Criar de Modelo")
    • Os programas do console do Adobe I/O são conceitos diferentes dos programas do Cloud Manager
  4. Crie uma nova integração da API do Cloud Manager com o perfil "Desenvolvedor - Cloud Service"
  5. Obter as credenciais da conta de serviço (JWT) precisam preencher a CLI do Adobe I/O config.json
  6. Carregue o config.json para a CLI do Adobe I/O
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager PATH_TO_CONFIG_JSON_FILE --file --json
  7. Carregue o private.key para a CLI do Adobe I/O
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key PATH_TO_PRIVATE_KEY_FILE --file

Iniciar execução de comandos para o Cloud Manager por meio da CLI do Adobe I/O.

Configurar o IDE de desenvolvimento

AEM desenvolvimento consiste principalmente no desenvolvimento de Java e Front-end (JavaScript, CSS etc) e no gerenciamento de XML. Veja a seguir os IDEs mais populares para desenvolvimento de AEM.

IntelliJ IDEA

IntelliJ IDEA O é um IDE poderoso para o desenvolvimento do Java. O IntelliJ IDEA tem dois sabores, uma edição comunitária gratuita e uma versão Ultimate comercial (paga). A versão comunitária gratuita é suficiente para AEM desenvolvimento, mas o Ultimate expande seu conjunto de recursos.

Código Microsoft Visual Studio

Código do Visual Studio (Código VS) é uma ferramenta gratuita e de código aberto para desenvolvedores front-end. O Visual Studio Code pode ser configurado para integrar sincronização de conteúdo com AEM com a ajuda de uma ferramenta Adobe, repo.

O Visual Studio Code é a escolha ideal para desenvolvedores front-end que criam código front-end principalmente; JavaScript, CSS e HTML. Embora o código VS tenha suporte para Java por meio do extensõesNo entanto, pode ser que não tenha alguns dos recursos avançados fornecidos por recursos mais específicos do Java.

Eclipse

Eclipse IDE O é um IDEs popular para desenvolvimento de Java e oferece suporte ao Ferramentas do desenvolvedor do AEM fornecido pelo Adobe, fornecendo uma GUI do IDE para criação e para sincronizar o conteúdo do JCR com uma instância de AEM local.

Nesta página