Configurar las herramientas de desarrollo set-up-development-tools

El desarrollo de Adobe Experience Manager (AEM) requiere que se instale y configure un conjunto mínimo de herramientas de desarrollo en el equipo de desarrollo. Estas herramientas admiten el desarrollo y la creación de proyectos de AEM.

Tenga en cuenta que ~ se usa como abreviatura del directorio del usuario. En Windows, es el equivalente de %HOMEPATH%.

Instalar Java

Experience Manager es una aplicación Java y, por lo tanto, requiere Java SDK para admitir el desarrollo y AEM as a Cloud Service SDK.

  1. Descargue e instale la última versión de Java 11 SDK
  2. Compruebe que Oracle Java 11 SDK está instalado ejecutando el comando:
macOS
code language-shell
$ java --version
Windows
code language-shell
$ java -version
Linux
code language-shell
$ java --version

Java

Instalar Homebrew

El uso de Homebrew es opcional, pero se recomienda.

Homebrew es un gestor de paquetes de código abierto para macOS, Windows y Linux. Todas las herramientas de soporte se pueden instalar por separado, Homebrew proporciona una manera conveniente de instalar y actualizar una variedad de herramientas de desarrollo necesarias para el desarrollo de Experience Manager.

  1. Abra el terminal
  2. Compruebe si Homebrew ya está instalado ejecutando el comando: brew --version.
  3. Si Homebrew no está instalado, instale Homebrew
macOS

Homebrew en macOS requiere Xcode o Herramientas de línea de comandos, que se pueden instalar mediante el comando:

code language-shell
$ xcode-select --install
Windows
Instalar Homebrew en Windows 10
Linux
Instalar Homebrew en Linux
  1. Compruebe que Homebrew está instalado ejecutando el comando: brew --version

Caramelo

Si está usando Homebrew, siga las instrucciones de Instalar usando Homebrew en las secciones a continuación. Si no usa Homebrew, instale las herramientas con los vínculos específicos del sistema operativo.

Instalar Git

Git es el sistema de administración de control de código fuente usado por Adobe Cloud Manager, y por lo tanto es necesario para el desarrollo.

Instalar Git mediante Homebrew
  1. Abra el terminal/símbolo del sistema

  2. Ejecutar el comando: $ brew install git

  3. Compruebe que Git está instalado mediante el comando: $ git --version

Descargar e instalar Git
  1. Descargar e instalar Git

  2. Abra el terminal/símbolo del sistema

  3. Compruebe que Git está instalado mediante el comando: $ git --version

Git

Instalación de Node.js (y npm) node-js

Node.js es un entorno de tiempo de ejecución de JavaScript que se usa para trabajar con los recursos front-end del subproyecto ui.frontend de un proyecto AEM. Node.js se distribuye con npm, que es el administrador de paquetes predeterminado de Node.js, y se usa para administrar las dependencias de JavaScript.

Instalar Node.js mediante Homebrew
  1. Abra el terminal/símbolo del sistema

  2. Ejecutar el comando: $ brew install node

  3. Compruebe que Node.js está instalado mediante el comando: $ node -v

  4. Compruebe que npm está instalado mediante el comando: $ npm -v

Descargar e instalar Node.js
  1. Descargar e instalar Node.js

  2. Abra el terminal/símbolo del sistema

  3. Compruebe que Node.js está instalado mediante el comando: $ node -v

  4. Compruebe que npm está instalado mediante el comando: $ npm -v

Node.js y npm

TIP
Los proyectos AEM basados en AEM Project Archetype instalan una versión aislada de Node.js en el momento de la compilación. Es recomendable mantener la versión del sistema de desarrollo local sincronizada (o cercana) con las versiones de Node.js y npm especificadas en el pom.xml de Reactor de su proyecto de AEM Maven.
Consulte este ejemplo AEM Project Reactor pom.xml para saber dónde encontrar las versiones de compilación de Node.js y npm.

Instalar Maven

Apache Maven es la herramienta de línea de comandos de código abierto de Java que se utiliza para crear proyectos de AEM generados a partir del tipo de archivo Maven del proyecto de AEM. Todos los IDE principales (IntelliJ IDEA, Visual Studio Code, Eclipse, etc.) tienen compatibilidad con Maven integrada.

Instalar Maven mediante Homebrew
  1. Abra el terminal/símbolo del sistema

  2. Ejecutar el comando: $ brew install maven

  3. Compruebe que Maven está instalado mediante el comando: $ mvn -v

Descargar e instalar Maven
  1. Descargar Maven

  2. Instalar Maven

  3. Abra el terminal/símbolo del sistema

  4. Compruebe que Maven está instalado mediante el comando: $ mvn -v

Maven

Configurar la CLI de Adobe I/O aio-cli

La CLI de Adobe I/O, o aio, proporciona acceso desde la línea de comandos a diversos servicios de Adobe, entre ellos Cloud Manager y Asset Compute. La CLI de Adobe I/O desempeña un papel integral en el desarrollo de AEM as a Cloud Service, ya que proporciona a los desarrolladores la capacidad de:

Instalación de la CLI de Adobe I/O

  1. Asegúrese de que Node.js está instalado, ya que la CLI de Adobe I/O es un módulo npm
    • Ejecute node --version para confirmar
  2. Ejecutar npm install -g @adobe/aio-cli para instalar el módulo npm aio globalmente

Configurar el complemento Cloud Manager de CLI de Adobe I/O aio-cloud-manager

El complemento Adobe I/O Cloud Manager permite que la CLI de aio interactúe con Adobe Cloud Manager mediante el comando aio cloudmanager.

  1. Ejecute aio plugins:install @adobe/aio-cli-plugin-cloudmanager para instalar el complemento aio Cloud Manager.

Configurar la autenticación CLI de Adobe I/O

Para que la CLI de Adobe I/O se comunique con Cloud Manager, se debe crear una integración de Cloud Manager en la consola de Adobe I/O, y se deben obtener las credenciales para autenticarse correctamente.

  1. Inicie sesión en console.adobe.io

  2. Asegúrese de que su organización que incluye el producto de Cloud Manager al que conectarse esté activa en el conmutador de organización de Adobe

  3. Crear un nuevo programa de Adobe I/O o abrir uno existente

    • Los proyectos de la consola de Adobe I/O son simplemente agrupaciones organizativas de integraciones, cree o utilice y proyectos existentes basados en cómo desea administrar las integraciones.
    • Si crea un nuevo proyecto, seleccione "Proyecto vacío" si se le solicita (en lugar de "Crear a partir de la plantilla")
    • Los programas de la consola de Adobe I/O son conceptos diferentes de los programas de Cloud Manager
  4. Creación de una nueva integración de API de Cloud Manager

    • Seleccione el tipo de credencial "Oauth Server-to-server".
    • Seleccione el perfil de producto Administrador de implementación - Cloud Service.
    • Guardar API configurada
  5. Obtenga las credenciales que necesita para rellenar config.json de la CLI de Adobe I/O. Para ello, abra las credenciales "OAuth Server-to-server" recién creadas y seleccione "Descargar JSON" en la barra de acciones superior derecha.

  6. Abra el archivo JSON descargado y cambie el nombre de todas las claves a minúsculas. Por ejemplo, CLIENT_ID se convierte en client_id.

  7. Cargue el archivo config.json en la CLI de Adobe I/O

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

Inicie ejecutando comandos para Cloud Manager a través de la CLI de Adobe I/O.

Configurar el complemento Entorno de desarrollo rápido de AEM rde

El complemento Entorno de desarrollo rápido de AEM permite que la CLI de aio interactúe con los entornos de desarrollo rápido de AEM as a Cloud Service mediante el comando aio aem:rde.

  1. Ejecute aio plugins:install @adobe/aio-cli-plugin-aem-rde para instalar el complemento Entornos de desarrollo rápido de AEM.

Configurar el complemento Asset Compute de CLI de Adobe I/O aio-asset-compute

El complemento Adobe I/O Cloud Manager permite que la CLI de aio genere y ejecute trabajadores de Asset Compute mediante el comando aio asset-compute.

  1. Ejecute aio plugins:install @adobe/aio-cli-plugin-asset-compute para instalar el complemento aio Asset Compute.

Configurar el IDE de desarrollo

El desarrollo de AEM consiste principalmente en desarrollo de Java y front-end (JavaScript, CSS, etc.) y administración de XML. Los siguientes son los IDE más populares para el desarrollo de AEM.

IntelliJ IDEA

IntelliJ IDEA es un IDE potente para el desarrollo de Java. IntelliJ IDEA viene en dos sabores, una edición comunitaria gratuita y una versión comercial (de pago) de Ultimate. La versión gratuita de la comunidad es suficiente para el desarrollo de AEM, pero Ultimate amplía su conjunto de capacidades.

Microsoft Visual Studio Code

Visual Studio Code (VS Code) es una herramienta gratuita de código abierto para desarrolladores de front-end. El código de Visual Studio se puede configurar para integrar la sincronización de contenido con AEM con la ayuda de la herramienta Adobe repo.

Visual Studio Code es la opción ideal para los desarrolladores de front-end que crean principalmente código front-end; JavaScript, CSS y HTML. Aunque el código VS tiene compatibilidad con Java a través de extensiones, es posible que carezca de algunas de las funciones avanzadas que ofrecen más específicas de Java.

Eclipse

Eclipse IDE es un IDE popular para el desarrollo de Java y admite el complemento AEM Developer Tools proporcionado por Adobe, que proporciona una GUI en el IDE para la creación y sincronización de contenido JCR con una instancia local de AEM.

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