Configuración de desarrollo local

AEM Obtenga información sobre cómo configurar un entorno de desarrollo local para editar el contenido de una aplicación de React mediante el Editor universal de aplicaciones (UIDs) de la aplicación de.

Requisitos previos

Se requiere lo siguiente para seguir este tutorial:

  • Aptitudes básicas de HTML y JavaScript.

  • Las siguientes herramientas deben instalarse localmente:

  • Descargue e instale lo siguiente:

    • SDK de AEM as a Cloud Service AEM: contiene el Jar de inicio rápido utilizado para ejecutar a Author y a 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. AEM El editor universal 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 de

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

  • 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. AEM AEM El CORS facilita las propiedades no web para realizar llamadas del lado del cliente basadas en el explorador a las API de GraphQL AEM de la plataforma de datos de la plataforma de datos de y el controlador de autenticación de token se utiliza para autenticar cada solicitud a la.

    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.

    code language-bash
    $ 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.

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

    code language-bash
    $ 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. AEM El SDK de la aplicación React proporciona el contenido mediante las API de GraphQL (/graphql/execute.json/my-project/all-teams), que se pueden 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.

    code language-bash
    $ 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:

    code language-bash
    # 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.

    code language-bash
    $ 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

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

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

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

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

    • AEM Proxy HTTP SSL local del SDK de la en el puerto 8443.
    • Proxy HTTP SSL local del servicio Editor universal en el puerto 8001.
    code language-bash
    # 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.

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

    code language-bash
    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.

    code language-javascript
    ...
    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.

    code language-bash
    $ 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 de 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