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:
- Nodo.js
- Git
- Un IDE o editor de código, como Visual Studio Code
-
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.
Aplicación React
Para configurar la aplicación WKND Teams React, siga los pasos a continuación:
-
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
-
Vaya al directorio
basic-tutorial
y ábralo en el editor de código.code language-bash $ cd aem-guides-wknd-graphql/basic-tutorial $ code .
-
Instale las dependencias e inicie la aplicación React.
code language-bash $ npm install $ npm start
-
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.
Servicio de editor universal
Para configurar el servicio de editor universal local, siga los pasos a continuación:
-
Descargue la versión más reciente del servicio de editor universal del Portal de distribución de software.
-
Extraiga el archivo zip descargado y copie el archivo
universal-editor-service.cjs
en un nuevo directorio llamadouniversal-editor-service
.code language-bash $ unzip universal-editor-service-vproduction-<version>.zip $ mkdir universal-editor-service $ cp universal-editor-service.cjs universal-editor-service
-
Cree el archivo
.env
en el directoriouniversal-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
-
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:
-
Instale el paquete
local-ssl-proxy
globalmente.code language-bash $ npm install -g local-ssl-proxy
-
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
- AEM Proxy HTTP SSL local del SDK de la en el puerto
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:
-
Detenga el React presionando
Ctrl + C
en el terminal. -
Actualice el archivo
package.json
para incluir la variable de entornoHTTPS=true
en el scriptstart
.code language-json "scripts": { "start": "HTTPS=true react-scripts start", ... }
-
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 ...
-
Actualice el archivo
../src/proxy/setupProxy.auth.basic.js
para usar la configuración SSL relajada mediante la opciónsecure: 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}` }) ); };
-
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:
- Aplicación WKND Teams React en https://localhost:3000
- AEM SDK de en https://localhost:8443
- 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:
-
Abra Universal Editor https://experience.adobe.com/#/aem/editor en su explorador. Si se le solicita, inicie sesión con su Adobe ID.
-
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
. -
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.
Siguiente paso
Aprenda a instrumentar la aplicación React para editar el contenido.