DocumentaçãoAEMTutoriais do AEMTutorials do AEM as a Cloud Service

Configurar ferramentas de desenvolvimento set-up-development-tools

Last update: Tue Apr 02 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Beginner
  • Developer

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 as a Cloud Service AEM.

  1. Baixe e instale o SDK Java 11 da versão mais recente
  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 de 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

Homebrew no macOS exige Xcode ou Ferramentas de Linha de Comando, instalável 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 Instalar usando o Homebrew instruções 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 de origem usado pelo Adobe Cloud Managere, 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 JavaScript usado para trabalhar com os ativos de front-end de um projeto AEM ui.frontend subprojeto. O Node.js é distribuído com o 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 o Node.js está instalado usando o comando: $ node -v

  4. Verifique se o npm está instalado usando o comando: $ npm -v

Baixe e instale o Node.js

  1. Baixe e instale o Node.js

  2. Abra o terminal/prompt de comando

  3. Verifique se o 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
Arquétipo de projeto AEMProjetos AEM baseados em 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) às versões Node.js e npm especificadas no Reator pom.xml do projeto AEM Maven.
Veja este exemplo Pom.xml do Reator de Projeto AEM para onde localizar as versões de build do 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 IDEs principais (IntelliJ IDEA, Código do Visual Studio, 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 o 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 variável CLI do Adobe I/Oou aio, fornece acesso de linha de comando a vários serviços da Adobe, incluindo Cloud Manager e Asset compute. A CLI do Adobe I/O desempenha um papel integral no desenvolvimento do AEM as a Cloud Service, pois fornece aos desenvolvedores a capacidade de:

Instale o Adobe I/O CLI

  1. Assegurar O Node.js está instalado como 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 plug-in do Adobe I/O CLI Cloud Manager aio-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 da aio cloudmanager comando.

  1. Executar aio plugins:install @adobe/aio-cli-plugin-cloudmanager para instalar o Plug-in do aio 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, um A integração do Cloud Manager deve ser criada no Console do Adobe I/OAs credenciais do e do devem ser obtidas para a autenticação bem-sucedida.

  1. Efetue logon no console.adobe.io

  2. Certifique-se de que a organização que inclui o produto Cloud Manager para conexão está ativa no alternador da organização Adobe

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

    • 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 as CLIs do Adobe I/O config.json

    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 config.json arquivo na CLI do Adobe I/O

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager ./path/to/config.json --file --json

  7. Carregue o private.key arquivo na CLI do Adobe I/O

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key ./path/to/private.key --file

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

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

O plug-in AEM Rapid Development Environment permite que o aio CLI interaja com o AEM as a Cloud Service Ambientes de desenvolvimento rápido por meio da aio aem:rde comando.

  1. Executar aio plugins:install @adobe/aio-cli-plugin-aem-rde para instalar o Plug- in para ambientes de desenvolvimento rápido do AEMName.

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

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

  1. Executar aio plugins:install @adobe/aio-cli-plugin-asset-compute para instalar o plug-in de 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 O é 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.

https://video.tv.adobe.com/v/39744?quality=12&learn=on&captions=por_br

Código do Microsoft Visual Studio

Código do Visual Studio O (VS Code) é uma ferramenta gratuita e de código aberto para desenvolvedores de 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 via extensões, pode faltar alguns dos recursos avançados fornecidos pelo mais específico do Java.

https://video.tv.adobe.com/v/25907?quality=12&learn=on

Eclipse

Eclipse IDE O é um IDEs popular para desenvolvimento em Java e oferece suporte ao Ferramentas para desenvolvedores do AEM plug-in fornecido pelo Adobe, fornecendo uma interface gráfica interna do IDE para criação e para sincronizar o conteúdo JCR com uma instância local do AEM.

https://video.tv.adobe.com/v/25906?quality=12&learn=on

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