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 criação de projetos do 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 Java SDK para oferecer suporte ao desenvolvimento e ao AEM as a Cloud Service SDK.
- Baixe e instale a versão mais recente do Java 11 SDK
- Verifique se o Oracle Java 11 SDK está instalado executando o comando:
| code language-shell |
|---|
|
| code language-shell |
|---|
|
| code language-shell |
|---|
|
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 do Experience Manager.
- Abra o terminal
- Verifique se o Homebrew já está instalado executando o comando:
brew --version. - Se o Homebrew não estiver instalado, instale o Homebrew
O Homebrew no macOS requer o Xcode ou as Ferramentas de Linha de Comando, instaláveis por meio do comando:
| code language-shell |
|---|
|
- Verifique se o Homebrew está instalado executando o comando:
brew --version
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
O Git é o sistema de gerenciamento de controle do código-fonte usado pelo Adobe Cloud Manager e, portanto, é necessário para o desenvolvimento.
-
Abra o terminal/prompt de comando
-
Execute o comando:
$ brew install git -
Verifique se o Git está instalado usando o comando:
$ git --version
-
Abra o terminal/prompt de comando
-
Verifique se o Git está instalado usando o comando:
$ git --version
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 de um subprojeto ui.frontend de um projeto do AEM. O Node.js é distribuído com npm, é o gerenciador de pacotes Node.js padrão, usado para gerenciar dependências do JavaScript.
-
Abra o terminal/prompt de comando
-
Execute o comando:
$ brew install node -
Verifique se Node.js está instalado, usando o comando:
$ node -v -
Verifique se o npm está instalado, usando o comando:
$ npm -v
-
Abra o terminal/prompt de comando
-
Verifique se Node.js está instalado, usando o comando:
$ node -v -
Verifique se o npm está instalado, usando o comando:
$ npm -v
Instalar o Maven
O Apache Maven é a ferramenta de linha de comando Java de código aberto usada para criar projetos do AEM gerados a partir do Arquétipo Maven do projeto do AEM. Todos os principais IDEs (IntelliJ IDEA, Visual Studio Code, Eclipse, etc.) têm suporte para Maven integrado.
-
Abra o terminal/prompt de comando
-
Execute o comando:
$ brew install maven -
Verifique se o Maven está instalado, usando o comando:
$ mvn -v
-
Abra o terminal/prompt de comando
-
Verifique se o Maven está instalado, usando o comando:
$ mvn -v
Configurar a CLI do Adobe I/O 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 no AEM as a Cloud Service, pois fornece aos desenvolvedores a capacidade de:
- Logs finais dos serviços do AEM as a Cloud Services
- Gerenciar pipelines do Cloud Manager a partir da CLI
- Implantar em AEM Rapid Development Environments
Instalar a CLI do Adobe I/O
- Verifique se o Node.js está instalado, pois a CLI do Adobe I/O é um módulo npm
- Execute
node --versionpara confirmar
- Execute
- Executar
npm install -g @adobe/aio-clipara instalar o móduloaionpm globalmente
Configurar o plug-in do Cloud Manager da CLI do Adobe I/O 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.
- Execute
aio plugins:install @adobe/aio-cli-plugin-cloudmanagerpara 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.
-
Faça logon em console.adobe.io
-
Verifique se a sua organização, que inclui o produto Cloud Manager ao qual se conectar, está ativa no alternador da organização da Adobe
-
Criar um novo ou abrir um programa Adobe I/O existente
- Os projetos do Adobe I/O Console 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 Adobe I/O Console são conceitos diferentes dos programas do Cloud Manager
-
Criar uma nova integração da API do Cloud Manager
- Selecione o tipo de credencial "Oauth Server-to-server".
- Selecione o perfil de produto "Gerente de implantação - Cloud Service".
- Salvar API configurada
-
Obter as credenciais precisa preencher o config.json da CLI do Adobe I/O, abrindo as credenciais recém-criadas de "Servidor para servidor OAuth" e selecionando "Baixar JSON" na barra de ação superior direita.
-
Abra o arquivo JSON baixado e renomeado todas as chaves para minúsculas. Por exemplo,
CLIENT_IDtorna-seclient_id. -
Carregue o arquivo
config.jsonna CLI do Adobe I/O$ aio config:set ims.contexts.aio-cli-plugin-cloudmanager /path/to/downloaded/json --file --json
Comece a executar comandos para o Cloud Manager por meio da CLI do Adobe I/O.
Configurar o plug-in do Ambiente de desenvolvimento rápido do AEM rde
O plug-in Ambiente de desenvolvimento rápido da AEM permite que a CLI do aio interaja com os Ambientes de desenvolvimento rápido da AEM as a Cloud Service através do comando aio aem:rde.
- Execute
aio plugins:install @adobe/aio-cli-plugin-aem-rdepara instalar o plug-in do AEM Rapid Development Environments.
Configurar o plug-in do Asset Compute da 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 do Asset Compute por meio do comando aio asset-compute.
- Execute
aio plugins:install @adobe/aio-cli-plugin-asset-computepara instalar o plug-in aio do Asset Compute.
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 o desenvolvimento do AEM.
IntelliJ IDEA
IntelliJ IDEA é um IDE poderoso para desenvolvimento em Java. O IntelliJ IDEA vem em duas versões: uma edição gratuita da Comunidade e uma versão comercial (paga) do Ultimate. A versão gratuita da Comunidade é suficiente para o desenvolvimento de 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 do Adobe, o 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 de Desenvolvedor do AEM fornecido pelo Adobe, fornecendo uma GUI no IDE para criação e para sincronizar conteúdo JCR com uma instância local do AEM.
