Configurar ferramentas de desenvolvimento set-up-development-tools

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

Observe que ~ é usado como abreviação para o Diretório do Usuário. No Windows, é equivalente a %HOMEPATH%.

Instalar o Java

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

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

Java

Instalar 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 de 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
macOS

O Homebrew no macOS requer o Xcode ou as Ferramentas de Linha de Comando, instaláveis por meio do comando:

code language-shell
$ xcode-select --install
Windows
Instalar o Homebrew no Windows 10
Linux
Instalar o Homebrew no Linux
  1. Verifique se o Homebrew está instalado executando o comando: brew --version

Homebrew

Se você estiver usando o Homebrew, siga as instruções de Instalar usando o Homebrew nas seções abaixo. Se você estiver não usando o Homebrew, instale as ferramentas usando os links específicos do sistema operacional.

Instalar o Git

Git é o sistema de gerenciamento de controle do código-fonte 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

Baixar e instalar o Git
  1. Baixar e instalar o Git

  2. Abra o terminal/prompt de comando

  3. Verifique se o Git está instalado usando o comando: $ git --version

Git

Instalar Node.js (e npm) node-js

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

Instalar Node.js usando 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

Baixar e instalar Node.js
  1. Baixar e instalar 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

TIP
Os projetos AEM baseados em Arquétipo de projeto AEM do instalam uma versão isolada do Node.js no momento da compilação. É bom manter a versão do sistema de desenvolvimento local sincronizada (ou próxima) às versões Node.js e npm especificadas no Reator pom.xml do projeto AEM Maven.
Consulte este exemplo pom.xml do Reator de Projeto AEM para saber 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 construir projetos AEM gerados a partir do Arquétipo Maven do projeto AEM. Todos os principais IDEs (IntelliJ IDEA, Visual Studio Code, Eclipse, etc.) têm suporte para Maven integrado.

Instalar 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

Baixar e instalar o Maven
  1. Baixar Maven

  2. Instalar Maven

  3. Abra o terminal/prompt de comando

  4. Verifique se o Maven está instalado, usando o comando: $ mvn -v

Maven

Configurar o Adobe I/O CLI aio-cli

A CLI do Adobe I/O ou aio fornece acesso de linha de comando a diversos serviços da Adobe, incluindo o Cloud Manager e o Asset Compute. A CLI do Adobe I/O desempenha um papel integral no desenvolvimento do AEM as a Cloud Service, pois oferece aos desenvolvedores a capacidade de:

Instale o Adobe I/O CLI

  1. Verifique se o Node.js está instalado, pois a CLI do Adobe I/O é um módulo npm
    • Execute node --version para confirmar
  2. Executar npm install -g @adobe/aio-cli para instalar o módulo aio npm globalmente

Configurar o plug-in Adobe I/O CLI Cloud Manager aio-cloud-manager

O plug-in Adobe I/O Cloud Manager permite que a CLI 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 aio do Cloud Manager.

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 Console do Adobe I/O e as credenciais devem ser obtidas para autenticar com êxito.

  1. Faça logon em console.adobe.io

  2. Verifique se a sua organização, que inclui o produto Cloud Manager ao qual se conectar, está ativa no alternador da organização Adobe

  3. Criar um novo ou abrir um programa Adobe I/O existente

    • Os projetos do Console Adobe I/O são simplesmente agrupamentos organizacionais de integrações, como criar ou usar, e projetos existentes com base em como você deseja gerenciar suas integrações.
    • Se estiver criando um novo projeto, selecione "Projeto vazio" se solicitado (versus "Criar a partir do modelo")
    • Os programas do console do Adobe I/O são conceitos diferentes dos programas do Cloud Manager
  4. Criar uma nova integração da API do Cloud Manager

    • Selecione o tipo de autenticação obsoleto "Service Account (JWT)" (no momento, o OAuth não é compatível com a CLI).
    • Criar ou carregar chaves.
    • Selecione o perfil de produto "Developer - Cloud Service"
  5. Obter as credenciais da Conta de Serviço (JWT) necessárias para preencher o config.json da CLI do Adobe I/O

    code language-json
    //config.json
    {
       "client_id": "Client ID from Service Account (JWT) credential",
       "client_secret": "Client Secret from Service Account (JWT) credential",
       "technical_account_id": "Technical Account ID from Service Account (JWT) credential",
       "ims_org_id": "Organization ID from Service Account (JWT) credential",
       "meta_scopes": [
         "ent_cloudmgr_sdk"
       ]
    }
    
  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 --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

Comece a executar comandos para o Cloud Manager através da CLI do Adobe I/O.

Configurar o plug-in do Ambiente de desenvolvimento rápido para AEM rde

O plug-in Ambiente de Desenvolvimento Rápido AEM permite que a CLI aio interaja com os Ambientes de Desenvolvimento Rápido da AEM as a Cloud Service por meio do comando aio aem:rde.

  1. Execute aio plugins:install @adobe/aio-cli-plugin-aem-rde para instalar o plug-in de Ambientes de Desenvolvimento Rápido para AEM.

Configurar o plug-in de Asset compute CLI do Adobe I/O aio-asset-compute

O plug-in Adobe I/O Cloud Manager permite que a CLI aio gere e execute trabalhadores de 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 o IDE de desenvolvimento

O desenvolvimento do AEM consiste principalmente no desenvolvimento de Java e front-end (JavaScript, CSS etc.) e gerenciamento de XML. A seguir estão os IDEs mais populares para desenvolvimento de AEM.

IntelliJ IDEA

IntelliJ IDEA é um IDE poderoso para desenvolvimento em Java. IntelliJ IDEA vem em dois sabores, uma edição gratuita da Comunidade e uma versão comercial (paga) Ultimate. A versão gratuita da Comunidade é suficiente para o desenvolvimento do AEM, no entanto, o Ultimate expande seu conjunto de recursos.

Código do Microsoft Visual Studio

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

O Visual Studio Code é a escolha ideal para desenvolvedores front-end que criam principalmente código front-end; JavaScript, CSS e HTML. Embora o Código VS tenha suporte para Java através de extensões, ele pode não ter alguns dos recursos avançados fornecidos por outros específicos do Java.

Eclipse

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

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69