DocumentaciónAEMTutoriales de AEMTutoriales de AEM as a Cloud Service

Configuración del SDK de AEM local set-up-local-aem-sdk

Last update: Thu Jan 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Beginner
  • Developer

Adobe Experience Manager (AEM) se puede ejecutar localmente mediante el Jar de inicio rápido del SDK de AEM as a Cloud Service. Esto permite a los desarrolladores implementar y probar el código, la configuración y el contenido personalizados antes de comprometerlo con el control de código fuente e implementarlo en el entorno de AEM as a Cloud Service.

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

Instale Java™

Experience Manager es una aplicación Java™ y, por lo tanto, requiere el SDK de Java™ de Oracle para admitir las herramientas de desarrollo.

  1. Descargue e instale el SDK 11 de Java™ más reciente
  2. Compruebe que el SDK de Oracle Java™ 11 está instalado ejecutando el comando:
macOS
code language-shell 
$ java --version
Windows
code language-shell 
$ java -version
Linux®
code language-shell 
$ java --version

Java

AEM Descarga del SDK as a Cloud Service de

AEM El SDK as a Cloud Service AEM AEM, o SDK de, contiene el Jar de inicio rápido que se utiliza para ejecutar Autor y Publicación de manera local para desarrollo, así como la versión compatible de las herramientas de Dispatcher.

  1. Iniciar sesión en https://experience.adobe.com/#/downloads con su Adobe ID
    • Tenga en cuenta que la organización de Adobe debe AEM Debe aprovisionarse para que los as a Cloud Service AEM descarguen el SDK as a Cloud Service de la.
  2. Vaya a AEM as a Cloud Service pestaña
  3. Ordenar por Fecha de publicación in Descendente pedido
  4. Haga clic en la última AEM SDK de fila de resultados
  5. Revise y acepte el EULA y pulse el botón Descargar botón

AEM Extraiga el Jar de inicio rápido del zip del SDK de la

  1. Descomprima el archivo descargado aem-sdk-XXX.zip archivo

AEM Configurar el servicio local de autor de set-up-local-aem-author-service

AEM El servicio de creación de contenido local de la comunidad de proporciona a los desarrolladores una experiencia local que los especialistas en marketing digital/los autores de contenido compartirán para crear y administrar contenido. AEM El servicio de creación de está diseñado como entorno de creación y previsualización, lo que permite que la mayoría de las validaciones del desarrollo de funciones se puedan realizar en él, lo que lo convierte en un elemento vital del proceso de desarrollo local.

  1. Cree la carpeta ~/aem-sdk/author

  2. Copie el JAR de inicio rápido archivo a ~/aem-sdk/author y renómbralo a aem-author-p4502.jar

  3. AEM Inicie el servicio local de creación de ejecutando lo siguiente desde la línea de comandos:

    • java -jar aem-author-p4502.jar
      • Proporcione la contraseña de administrador como admin. Cualquier contraseña de administrador es aceptable, pero se recomienda utilizar la predeterminada para el desarrollo local con el fin de reducir la necesidad de volver a configurar.

    Usted no puede AEM inicie el Jar de inicio rápido de Cloud Service de la haciendo doble clic en.

  4. AEM Acceda al servicio local de creación de en http://localhost:4502 en un explorador Web

macOS
code language-shell 
$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar
Windows
code language-shell 
$ mkdir -p c:\Users\<My User>\aem-sdk\author
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\author\aem-author-p4502.jar
$ cd c:\Users\<My User>\aem-sdk\author
$ java -jar aem-author-p4502.jar
Linux®
code language-shell 
$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar

AEM Configuración del servicio local de publicación de

AEM AEM AEM El servicio local de publicación en el sitio proporciona a los desarrolladores la experiencia local que tendrán los usuarios finales de la publicación en el sitio, como la exploración del sitio Web alojado en el sitio Web en el que se va a realizar la publicación en el sitio Web de la publicación en el sitio Web de la publicación en el que se va a realizar la publicación. AEM AEM Un servicio de publicación local de es importante porque se integra con los SDK de la aplicación de Herramientas de Dispatcher y permite a los desarrolladores probar y ajustar la experiencia final del usuario final.

  1. Cree la carpeta ~/aem-sdk/publish

  2. Copie el JAR de inicio rápido archivo a ~/aem-sdk/publish y renómbralo a aem-publish-p4503.jar

  3. AEM Inicie el servicio local de publicación de ejecutando lo siguiente desde la línea de comandos:

    • java -jar aem-publish-p4503.jar
      • Proporcione la contraseña de administrador como admin. Cualquier contraseña de administrador es aceptable, pero se recomienda utilizar la predeterminada para el desarrollo local con el fin de reducir la necesidad de volver a configurar.

    Usted no puede AEM inicie el Jar de inicio rápido de Cloud Service de la haciendo doble clic en.

  4. AEM Acceda al servicio local de publicación de en http://localhost:4503 en un explorador Web

macOS
code language-shell 
$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar
Windows
code language-shell 
$ mkdir -p c:\Users\<My User>\aem-sdk\publish
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\publish\aem-publish-p4503.jar
$ cd c:\Users\<My User>\aem-sdk\publish
$ java -jar aem-publish-p4503.jar
Linux®
code language-shell 
$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar

AEM Configuración de servicios locales de en modo de prelanzamiento

AEM El tiempo de ejecución de la local se puede iniciar en modo de prelanzamiento AEM lo que permite a los desarrolladores compilar comparando con las funciones de la próxima versión del as a Cloud Service. La versión preliminar se habilita pasando el -r prerelease AEM en el primer inicio del tiempo de ejecución local de la. AEM AEM Esto se puede utilizar tanto con los servicios locales de creación como con los de publicación de la.

macOS
code language-shell 
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease
Windows
code language-shell 
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease
Linux®
code language-shell 
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease

Simular distribución de contenido content-distribution

En un entorno de Cloud Service real, el contenido se distribuye desde el servicio de creación al de publicación mediante Sling Content Distribution y la Canalización de Adobe. El Canalización de Adobe es un microservicio aislado que solo está disponible en el entorno de la nube.

Durante el desarrollo, puede ser deseable simular la distribución de contenido mediante el servicio local de creación y publicación. Esto se puede lograr habilitando los agentes de replicación heredados.

NOTE
Los agentes de replicación solo están disponibles para su uso en el JAR de inicio rápido local y proporcionan solo una simulación de distribución de contenido.

  1. Inicie sesión en Autor y vaya a http://localhost:4502/etc/replication/agents.author.html.

  2. Clic Agente predeterminado (publicar) para abrir el agente de replicación predeterminado.

  3. Clic Editar para abrir la configuración del agente.

  4. En el Configuración pestaña, actualice los campos siguientes:

    • Habilitado - comprobar verdadero
    • ID de usuario agente - Deje este campo vacío

    Configuración del agente de replicación: configuración

  5. En el Transporte pestaña, actualice los campos siguientes:

    • URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
    • Usuario - admin
    • Contraseña - admin

    Configuración del agente de replicación: transporte

  6. Clic Ok para guardar la configuración y habilitar la variable Predeterminado Agente de replicación.

  7. Ahora puede realizar cambios en el contenido en el servicio de creación y publicarlos en el servicio de publicación.

Publicar página

Modos de inicio rápido del Jar

El nombre del Jar de inicio rápido, aem-<tier>_<environment>-p<port number>.jar especifica cómo se iniciará. AEM Una vez que se ha iniciado la creación o publicación en un nivel específico, no se puede cambiar al nivel alternativo. Para ello, la variable crx-Quickstart La carpeta generada durante la primera ejecución debe eliminarse y Quickstart Jar debe ejecutarse de nuevo. AEM El entorno y los puertos se pueden cambiar, pero requieren la detención/inicio de la instancia de la instancia de la local.

Cambiar entornos, dev, stage y prodAEM , puede resultar útil para los desarrolladores para garantizar que las configuraciones específicas del entorno se definen y resuelven correctamente mediante la función de definición y resolución de la aplicación de la configuración de la aplicación de la manera más adecuada. Se recomienda que el desarrollo local se realice principalmente contra el valor predeterminado dev modo de ejecución de entorno.

Las permutaciones disponibles son las siguientes:

Nombre de archivo Jar de inicio rápido
Descripción del modo
aem-author-p4502.jar
Como autor en el modo de ejecución Dev en el puerto 4502
aem-author_dev-p4502.jar
Como autor en el modo de ejecución Dev en el puerto 4502 (igual que aem-author-p4502.jar)
aem-author_stage-p4502.jar
Como autor en el modo de ejecución de ensayo en el puerto 4502
aem-author_prod-p4502.jar
Como autor en el modo de ejecución de producción en el puerto 4502
aem-publish-p4503.jar
Como publicar en modo de ejecución de desarrollo en el puerto 4503
aem-publish_dev-p4503.jar
Al publicar en modo de ejecución de desarrollo en el puerto 4503 (igual que aem-publish-p4503.jar)
aem-publish_stage-p4503.jar
Como publicar en modo de ejecución de ensayo en el puerto 4503
aem-publish_prod-p4503.jar
Como publicar en el modo de ejecución de producción en el puerto 4503

Tenga en cuenta que el número de puerto puede ser cualquier puerto disponible en la máquina de desarrollo local, aunque por convención:

  • Puerto 4502 se utiliza para AEM servicio de autor local
  • Puerto 4503 se utiliza para AEM servicio de publicación local

AEM Para cambiarlos, es posible que sea necesario realizar ajustes en las configuraciones del SDK de la

AEM Detención de un tiempo de ejecución de local

AEM AEM AEM Para detener un tiempo de ejecución de la local, ya sea Author o Publish Service, abra la ventana de línea de comandos que se utilizó para iniciar el tiempo de ejecución de la y pulse Ctrl-C. AEM Espere a que se cierre el sistema de. Cuando se completa el proceso de apagado, el símbolo del sistema está disponible.

AEM Tareas de configuración de tiempo de ejecución locales opcionales

Cuándo actualizar el Jar de inicio rápido

AEM AEM Actualice el SDK de la al menos una vez al mes, o poco después, el último jueves de cada mes, que es la cadencia de lanzamiento de las "versiones de funcionalidades" as a Cloud Service de la.

WARNING
AEM La actualización del Jar de inicio rápido a una nueva versión requiere reemplazar todo el entorno de desarrollo local, lo que provoca la pérdida de todo el código, la configuración y el contenido de los repositorios de la base de datos de la aplicación de inicio rápido (QUICKstart JAR) local. AEM AEM Asegúrese de que cualquier código, configuración o contenido que no se deba destruir se conserva de forma segura con Git o se exporta desde la instancia de la local como paquetes de la aplicación.

AEM Evitar la pérdida de contenido al actualizar el SDK de la

AEM AEM AEM Actualizar el SDK de la es crear de manera efectiva un tiempo de ejecución de la completamente nuevo, incluido un repositorio nuevo, lo que significa que se pierden todos los cambios realizados en un repositorio de un SDK de la API anterior. AEM Las siguientes son estrategias viables para ayudar en la persistencia del contenido entre actualizaciones de SDK de la, y se pueden utilizar de forma discreta o conjunta:

  1. Cree un paquete de contenido dedicado a contener contenido de "muestra" para ayudar en el desarrollo y mantenerlo en Git. AEM AEM Cualquier contenido que deba persistir a través de actualizaciones del SDK de la se mantendrá en este paquete y se volverá a implementar después de actualizar el SDK de la.
  2. Uso oak-upgrade con el includepaths AEM AEM , para copiar contenido del repositorio anterior del SDK de la en el nuevo repositorio del SDK de la aplicación.
  3. AEM AEM AEM Haga una copia de seguridad de cualquier contenido mediante el Administrador de paquetes de contenido y los paquetes de contenido de la versión anterior del SDK de la de datos y vuelva a instalarlos en el nuevo SDK de la versión de.

AEM Recuerde, el uso de los enfoques anteriores para mantener el código entre las actualizaciones del SDK de la indica un antipatrón de desarrollo. AEM El código no desechable debe originarse en el IDE de desarrollo y fluir hacia el SDK de la aplicación a través de implementaciones de SDK de la aplicación.

Solución de problemas

Al hacer doble clic en el archivo Jar de inicio rápido, se produce un error troubleshooting-double-click

AEM Al hacer doble clic en el Jar de inicio rápido para el inicio, se muestra un modal de error que impide que el inicio se realice de forma local a la vez que se hace de forma local.

Solución de problemas: haga doble clic en el archivo Quickstart Jar

AEM Esto se debe a que el Jar de inicio rápido as a Cloud Service AEM no admite hacer doble clic en el Jar de inicio rápido para iniciar la aplicación de forma local En su lugar, debe ejecutar el archivo Jar desde esa línea de comandos.

AEM Para iniciar el servicio de autor de, cd en el directorio que contiene el Jar de inicio rápido y ejecute el comando:

macOS
code language-shell 
$ java -jar aem-author-p4502.jar
Windows
code language-shell 
$ java -jar aem-author-p4502.jar
Linux®
code language-shell 
$ java -jar aem-author-p4502.jar

AEM o, para iniciar el servicio de publicación de la, cd en el directorio que contiene el Jar de inicio rápido y ejecute el comando:

macOS
code language-shell 
$ java -jar aem-publish-p4503.jar
Windows
code language-shell 
$ java -jar aem-publish-p4503.jar
Linux®
code language-shell 
$ java -jar aem-publish-p4503.jar

El inicio del Jar de inicio rápido desde la línea de comandos se anula inmediatamente troubleshooting-java-8

AEM Al iniciar el Jar de inicio rápido desde la línea de comandos, el proceso se interrumpe inmediatamente y el servicio no se inicia, con el siguiente error:

➜  ~/aem-sdk/author: java -jar aem-author-p4502.jar
Loading quickstart properties: default
Loading quickstart properties: instance
java.lang.Exception: Quickstart requires a Java Specification 11 VM, but your VM (Java HotSpot(TM) 64-Bit Server VM / Oracle Corporation) reports java.specification.version=1.8
  at com.adobe.granite.quickstart.base.impl.Main.checkEnvironment(Main.java:1046)
  at com.adobe.granite.quickstart.base.impl.Main.<init>(Main.java:646)
  at com.adobe.granite.quickstart.base.impl.Main.main(Main.java:981)
Quickstart: aborting

AEM Esto se debe a que el as a Cloud Service de la requiere Java™ SDK 11 y está ejecutando una versión diferente, muy probablemente Java™ 8. Para resolver este problema, descargue e instale Oracle Java™ SDK 11.

Una vez instalado el SDK de Oracle Java™ 11, compruebe que es la versión activa ejecutando el comando desde la línea de comandos:

macOS
code language-shell 
$ java --version
Windows
code language-shell 
$ java -version
Linux®
code language-shell 
$ java --version

Recursos adicionales

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