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.
- Descargue e instale la última versión de Java 11 SDK
- Compruebe que Oracle Java 11 SDK está instalado ejecutando el comando:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
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.
- Abra el terminal
- Compruebe si Homebrew ya está instalado ejecutando el comando:
brew --version
. - Si Homebrew no está instalado, instale Homebrew
Homebrew en macOS requiere Xcode o Herramientas de línea de comandos, que se pueden instalar mediante el comando:
code language-shell |
---|
|
- Compruebe que Homebrew está instalado ejecutando el comando:
brew --version
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.
-
Abra el terminal/símbolo del sistema
-
Ejecutar el comando:
$ brew install git
-
Compruebe que Git está instalado mediante el comando:
$ git --version
-
Abra el terminal/símbolo del sistema
-
Compruebe que Git está instalado mediante el comando:
$ git --version
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.
-
Abra el terminal/símbolo del sistema
-
Ejecutar el comando:
$ brew install node
-
Compruebe que Node.js está instalado mediante el comando:
$ node -v
-
Compruebe que npm está instalado mediante el comando:
$ npm -v
-
Abra el terminal/símbolo del sistema
-
Compruebe que Node.js está instalado mediante el comando:
$ node -v
-
Compruebe que npm está instalado mediante el comando:
$ npm -v
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.
-
Abra el terminal/símbolo del sistema
-
Ejecutar el comando:
$ brew install maven
-
Compruebe que Maven está instalado mediante el comando:
$ mvn -v
-
Abra el terminal/símbolo del sistema
-
Compruebe que Maven está instalado mediante el comando:
$ mvn -v
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:
- Registros de cola de los servicios de AEM as a Cloud Services
- Administrar canalizaciones de Cloud Manager desde la CLI
- Implementar en Entornos de desarrollo rápido de AEM
Instalación de la CLI de Adobe I/O
- 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
- Ejecute
- Ejecutar
npm install -g @adobe/aio-cli
para instalar el módulo npmaio
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
.
- 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.
-
Inicie sesión en console.adobe.io
-
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
-
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
-
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
-
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.
-
Abra el archivo JSON descargado y cambie el nombre de todas las claves a minúsculas. Por ejemplo,
CLIENT_ID
se convierte enclient_id
. -
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
.
- 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
.
- 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.