DocumentaciónAEMTutoriales de AEMTutoriales de AEM as a Cloud Service

Configuración de desarrollo local

Última actualización: 5 de mayo de 2025
  • Se aplica a:
  • Experience Manager as a Cloud Service
  • Temas:
  • Herramientas del desarrollador
  • Headless

Creado para:

  • Intermedio
  • Desarrollador

Aprenda a configurar un entorno de desarrollo local para editar el contenido de una aplicación de React con el Editor universal de AEM.

Requisitos previos

Se requiere lo siguiente para seguir este tutorial:

  • Aptitudes básicas de HTML y JavaScript.

  • Las siguientes herramientas deben instalarse localmente:

    • Nodo.js
    • Git
    • Un IDE o editor de código, como Visual Studio Code
  • Descargue e instale lo siguiente:

    • AEM as a Cloud Service SDK: contiene el Jar de inicio rápido utilizado para ejecutar AEM Author y Publish localmente con fines de desarrollo.
    • Servicio de editor universal: una copia local del servicio de editor universal, tiene un subconjunto de características y se puede descargar desde el portal de distribución de software.
    • local-ssl-proxy: Un proxy HTTP SSL local simple que usa un certificado autofirmado para el desarrollo local. El editor universal de AEM requiere la URL HTTPS de la aplicación React para cargarla en el editor.

Configuración local

Siga los pasos a continuación para configurar el entorno de desarrollo local:

AEM SDK

Para proporcionar el contenido para la aplicación WKND Teams React, instale los siguientes paquetes en el SDK local de AEM.

  • Equipos WKND - Paquete de contenido: Contiene los modelos de fragmentos de contenido, fragmentos de contenido y consultas de GraphQL persistentes.

  • Equipos WKND - Paquete de configuración: Contiene las configuraciones de Intercambio de recursos de origen cruzado (CORS) y Controlador de autenticación de token. El CORS facilita las propiedades web que no son de AEM para realizar llamadas del lado del cliente basadas en explorador a las API de GraphQL de AEM y el controlador de autenticación de token se utiliza para autenticar cada solicitud a AEM.

    Equipos WKND - Paquetes

Aplicación React

Para configurar la aplicación WKND Teams React, siga los pasos a continuación:

  1. Clona la aplicación WKND Teams React de la rama de solución basic-tutorial.

    $ git clone -b solution/basic-tutorial git@github.com:adobe/aem-guides-wknd-graphql.git
    
  2. Vaya al directorio basic-tutorial y ábralo en el editor de código.

    $ cd aem-guides-wknd-graphql/basic-tutorial
    $ code .
    
  3. Instale las dependencias e inicie la aplicación React.

    $ npm install
    $ npm start
    
  4. Abra la aplicación WKND Teams React en el explorador en http://localhost:3000. Muestra una lista de los integrantes del equipo y sus detalles. El contenido de la aplicación React lo proporciona AEM SDK local mediante las API de GraphQL (/graphql/execute.json/my-project/all-teams), que puede comprobar mediante la ficha de red del explorador.

    Equipos WKND - Aplicación React

Servicio de editor universal

Para configurar el servicio de editor universal local, siga los pasos a continuación:

  1. Descargue la versión más reciente del servicio de editor universal del Portal de distribución de software.

    Distribución de software - Servicio de editor universal

  2. Extraiga el archivo zip descargado y copie el archivo universal-editor-service.cjs en un nuevo directorio llamado universal-editor-service.

    $ unzip universal-editor-service-vproduction-<version>.zip
    $ mkdir universal-editor-service
    $ cp universal-editor-service.cjs universal-editor-service
    
  3. Cree el archivo .env en el directorio universal-editor-service y agregue las siguientes variables de entorno:

    # The port on which the Universal Editor service runs
    EXPRESS_PORT=8000
    # Disable SSL verification
    NODE_TLS_REJECT_UNAUTHORIZED=0
    
  4. Inicie el servicio local de Universal Editor.

    $ cd universal-editor-service
    $ node universal-editor-service.cjs
    

El comando anterior inicia el servicio Editor universal en el puerto 8000 y debería ver el siguiente resultado:

Either no private key or certificate was set. Starting as HTTP server
Universal Editor Service listening on port 8000 as HTTP Server

Proxy HTTP SSL local

El editor universal de AEM requiere que la aplicación React se suministre a través de HTTPS. Vamos a configurar un proxy HTTP SSL local que utilice un certificado firmado automáticamente para el desarrollo local.

Siga los pasos a continuación para configurar el proxy HTTP SSL local y servir el servicio SDK de AEM y el editor universal a través de HTTPS:

  1. Instale el paquete local-ssl-proxy globalmente.

    $ npm install -g local-ssl-proxy
    
  2. Inicie dos instancias del proxy HTTP SSL local para los siguientes servicios:

    • Proxy HTTP SSL local de AEM SDK en el puerto 8443.
    • Proxy HTTP SSL local del servicio Editor universal en el puerto 8001.
    # AEM SDK local SSL HTTP proxy on port 8443
    $ local-ssl-proxy --source 8443 --target 4502
    
    # Universal Editor service local SSL HTTP proxy on port 8001
    $ local-ssl-proxy --source 8001 --target 8000
    

Actualizar la aplicación React para que utilice HTTPS

Para habilitar HTTPS para la aplicación WKND Teams React, siga los pasos a continuación:

  1. Detenga el React presionando Ctrl + C en el terminal.

  2. Actualice el archivo package.json para incluir la variable de entorno HTTPS=true en el script start.

    "scripts": {
        "start": "HTTPS=true react-scripts start",
        ...
    }
    
  3. Actualice REACT_APP_HOST_URI en el archivo .env.development para utilizar el protocolo HTTPS y el puerto proxy HTTP SSL local de AEM SDK.

    REACT_APP_HOST_URI=https://localhost:8443
    ...
    
  4. Actualice el archivo ../src/proxy/setupProxy.auth.basic.js para usar la configuración SSL relajada mediante la opción secure: false.

    ...
    module.exports = function(app) {
    app.use(
        ['/content', '/graphql'],
        createProxyMiddleware({
        target: REACT_APP_HOST_URI,
        changeOrigin: true,
        secure: false, // Ignore SSL certificate errors
        // pass in credentials when developing against an Author environment
        auth: `${REACT_APP_BASIC_AUTH_USER}:${REACT_APP_BASIC_AUTH_PASS}`
        })
    );
    };
    
  5. Inicie la aplicación React.

    $ npm start
    

Verificar la configuración

Después de configurar el entorno de desarrollo local siguiendo los pasos anteriores, vamos a verificar la configuración.

Verificación local

Asegúrese de que los siguientes servicios se ejecutan localmente en HTTPS; es posible que tenga que aceptar la advertencia de seguridad en el explorador para el certificado autofirmado:

  1. Aplicación WKND Teams React en https://localhost:3000
  2. AEM SDK en https://localhost:8443
  3. Servicio de editor universal en https://localhost:8001

Carga de la aplicación WKND Teams React en el editor universal

Carguemos la aplicación WKND Teams React en el editor universal para verificar la configuración:

  1. Abra Universal Editor https://experience.adobe.com/#/aem/editor en su explorador. Si se le solicita, inicie sesión con su Adobe ID.

  2. Introduzca la URL de la aplicación WKND Teams React en el campo de entrada URL del sitio del editor universal y haga clic en Open.

    Editor universal - URL del sitio

  3. La aplicación WKND Teams React se carga en el editor universal pero aún no puede editar el contenido. Debe instrumentar la aplicación React para habilitar la edición de contenido con el editor universal.

    Editor universal: aplicación WKND Teams React

Siguiente paso

Aprenda a instrumentar la aplicación React para editar el contenido.

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