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, este é o equivalente a %HOMEPATH%.

Instalar Java

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

  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.

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 usando o Homebrew, siga as instruções Instalar usando o Homebrew nas seções abaixo. Se você estiver not usando o Homebrew, instale as ferramentas usando os links específicos do SO.

Instalar Git

🔗 Obtém o sistema de gerenciamento do controle de origem usado pelo Adobe Cloud Manager e, portanto, é 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, baixar e instalar 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. jsis é um ambiente de tempo de execução JavaScript usado para trabalhar com os ativos de front-end de um projeto AEM ui. frontendsub. O Node.js é distribuído com npm, é o gerenciador de pacotes Node.js defato, 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

AEM Projetos AEM baseados no Arquétipo de Projeto instalam 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.

Consulte este exemplo AEM Project Reator pom.xml para onde localizar as versões de compilação 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 principais IDEs (IntelliJ IDEA, Visual Studio Code, 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 Adobe I/O CLI

O Adobe I/O CLI, ou aio, fornece acesso de linha de comando a uma variedade de serviços do Adobe, incluindo Cloud Manager e Asset compute. A CLI do Adobe I/O desempenha um papel integral no desenvolvimento no AEM como 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. Verifique se Node.js está instalado, pois o Adobe I/O CLI é um módulo npm
    • Execute node --version para confirmar
  2. Execute npm install -g @adobe/aio-cli para instalar o módulo aio npm globalmente

Configurar o plugin do Adobe I/O CLI Cloud Manager

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

  1. Execute 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 plug-in do Adobe I/O Cloud Manager permite que a CLI do aio gere e execute os trabalhadores do Asset compute por meio do comando aio asset-compute.

  1. Execute 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 integração do Cloud Manager deve ser criada no Adobe I/O Console, e as credenciais 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. Criar um novo ou abrir um programa de Adobe I/O existente
    • 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 config.json da CLI do Adobe I/O
  6. Carregue o arquivo config.json na CLI do Adobe I/O
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager PATH_TO_CONFIG_JSON_FILE --file --json
  7. Carregue o arquivo private.key na CLI do Adobe I/O
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key PATH_TO_PRIVATE_KEY_FILE --file

Inicie executando 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

O IntelliJ IDEA é 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, no entanto, o Ultimate expande seu conjunto de recursos.

Código do Microsoft Visual Studio

O Visual Studio Code (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 de extensões, talvez não tenha alguns dos recursos avançados fornecidos por recursos mais específicos do Java.

Eclipse

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

Nesta página