Configuración de herramientas de desarrollo

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 apoyan el desarrollo y la construcción de AEM Proyectos.

Tenga en cuenta que ~ se utiliza como método abreviado para el Directorio del usuario. En Windows, este es el equivalente de %HOMEPATH%.

Instalación de Java

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

  1. Descargar e instalar la última versión del SDK para Java 11
  2. Compruebe que el SDK de Java 11 esté instalado ejecutando el comando :
    • Windows: java -version
    • macOS / Linux: java --version

Java

Instalar homebrew

El uso de Homebrew es opcional, pero recomendado.

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
  4. Verifique que Homebrew esté instalado ejecutando el comando : brew --version

Homebrew

Si está usando Homebrew, siga las instrucciones de Instalar usando Homebrew en las secciones siguientes. Si está no usando Homebrew, instale las herramientas utilizando los vínculos específicos del sistema operativo.

Instalar Git

🔗 Proporciona el sistema de administración del control de código fuente utilizado por Adobe Cloud Manager y, por lo tanto, es necesario para el desarrollo.

  • Instalación de Git con Homebrew
    1. Abra el símbolo del sistema/terminal
    2. Ejecute el comando: brew install git
    3. Verifique que Git esté instalado, utilizando el comando : git --version
  • O bien, descargue e instale Git (macOS, Linux o Windows)
    1. Descargar e instalar Git
    2. Abra el símbolo del sistema/terminal
    3. Verifique que Git esté instalado, utilizando el comando : git --version

Git

Instalación de Node.js (y npm)

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

  • Instalación de Node.js mediante Homebrew
    1. Abra el símbolo del sistema/terminal
    2. Ejecute el comando: brew install node
    3. Verifique que Node.js esté instalado, utilizando el comando : node -v
    4. Verifique que npm esté instalado, usando el comando: npm -v
  • O bien, descargue e instale Node.js (macOS, Linux o Windows)
    1. Descargar e instalar Node.js
    2. Abra el símbolo del sistema/terminal
    3. Verifique que Node.js esté instalado, utilizando el comando : node -v
    4. Verifique que npm esté instalado, usando el comando: npm -v

Node.js y npm

SUGERENCIA

AEM Proyectos AEM basados en tipo de archivo del proyecto instalan una versión aislada de Node.js en el momento de la compilación. Es bueno mantener la versión del sistema de desarrollo local sincronizada (o cercana) con las versiones Node.js y npm especificadas en el reactor pom.xml de su proyecto AEM Maven.

Consulte este ejemplo AEM Project Reactor pom.xml para saber dónde ubicar las versiones de compilación de Node.js y npm.

Instalar Maven

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

  • Instalar Maven mediante Homebrew
    1. Abra el símbolo del sistema/terminal
    2. Ejecute el comando: brew install maven
    3. Verifique que Maven esté instalado, utilizando el comando : mvn -v
  • O bien, descargue e instale Maven (macOS, Linux o Windows)
    1. Descargar Maven
    2. Instalar Maven
    3. Abra el símbolo del sistema/terminal
    4. Verifique que Maven esté instalado, utilizando el comando : mvn -v

Maven

Configuración de CLI de Adobe I/O

La CLI de Adobe I/O, o aio, proporciona acceso a la línea de comandos a una variedad de servicios de Adobe, incluidos Cloud Manager y Asset compute. La CLI de Adobe I/O desempeña un papel integral en el desarrollo en AEM como Cloud Service, ya que proporciona a los desarrolladores la capacidad de:

  • Registros de cola de AEM as a Cloud Services Services
  • Administrar canalizaciones de Cloud Manager desde la CLI

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. Ejecute npm install -g @adobe/aio-cli para instalar el módulo npm aio globalmente

Configuración del complemento de Adobe I/O CLI Cloud Manager

El complemento de Adobe I/O Cloud Manager permite que la CLI de aio interactúe con Adobe Cloud Manager a través del comando aio cloudmanager.

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

Configuración del complemento de Asset compute de CLI de Adobe I/O

El complemento de Adobe I/O Cloud Manager permite que la CLI de aio genere y ejecute Assets computes a través del comando aio asset-compute.

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

Configuración de 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 se va a conectar esté activa en el conmutador de organización de Adobe
  3. Cree un programa de Adobe I/O nuevo o abra uno existente
    • Los programas de la Consola de Adobe I/O son simplemente agrupaciones organizativas de integraciones, crear o utilizar y programas existentes basados en cómo desee administrar las integraciones
    • Si se crea un nuevo proyecto, seleccione "Proyecto vacío" si se le solicita (en lugar de "Crear a partir de plantilla")
    • Los programas de la Consola de Adobe I/O son conceptos diferentes de los programas de Cloud Manager
  4. Cree una nueva integración de API de Cloud Manager con el perfil "Desarrollador - Cloud Service"
  5. Obtenga las credenciales de la cuenta de servicio (JWT) para rellenar el config.json de la CLI de Adobe I/O
  6. Cargue el archivo config.json en la CLI de Adobe I/O
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager PATH_TO_CONFIG_JSON_FILE --file --json
  7. Cargue el archivo private.key en la CLI de Adobe I/O
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key PATH_TO_PRIVATE_KEY_FILE --file

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

Configuración del IDE de desarrollo

AEM desarrollo 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 IDEAes un poderoso IDE para el desarrollo de Java. IntelliJ IDEA viene con dos sabores, una edición comunitaria gratuita y una versión comercial (de pago) Ultimate. La versión comunitaria gratuita es suficiente para AEM desarrollo, sin embargo, Ultimate amplía su conjunto de capacidades.

Código de Microsoft Visual Studio

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 una herramienta de Adobe, repo.

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

Eclipse

Eclipse IDEs es un IDEs popular para el desarrollo de Java y es compatible con el complemento AEM Developer Toolsplug que proporciona Adobe, proporcionando una GUI en IDE para la creación y sincronización del contenido JCR con una instancia de AEM local.

En esta página