Verificar una extensión

AEM Las extensiones de interfaz de usuario se pueden comprobar en cualquier entorno de AEM as a Cloud Service de la organización de Adobe a la que pertenece la extensión.

AEM La prueba de una extensión se realiza a través de una dirección URL especialmente diseñada que indica a los que carguen la extensión, solo para esa solicitud.

IMPORTANT
El vídeo anterior muestra el uso de una extensión de la consola Fragmento de contenido para ilustrar la previsualización y verificación de la aplicación de la extensión de App Builder. AEM Sin embargo, es importante tener en cuenta que los conceptos cubiertos pueden aplicarse a todas las extensiones de la interfaz de usuario de la.

AEM URL de interfaz de usuario

AEM

URL de la consola de fragmentos de contenido de {align="center"}

AEM AEM Para crear una dirección URL que monte la extensión que no es de producción en la interfaz de usuario de, debe obtenerse la dirección URL de la interfaz de usuario de la interfaz de usuario en la que se inserta la extensión. Vaya al entorno de AEM as a Cloud Service para comprobar la extensión y abra la interfaz de usuario en la que se va a previsualizar la extensión.

Por ejemplo, para previsualizar una extensión para la consola Fragmento de contenido:

  1. Inicie sesión en el entorno de AEM as a Cloud Service deseado.

  2. Seleccione el icono Fragmentos de contenido.

  3. AEM Espere a que se cargue la consola Fragmento de contenido de en el explorador.

  4. AEM Copie la URL de la consola Fragmento de contenido de la barra de direcciones del explorador, debe tener un aspecto similar al siguiente:

    code language-none
    https://experience.adobe.com/?repo=author-p1234-e5678.adobeaemcloud.com#/@wknd/aem/cf/admin
    

A continuación, se utiliza esta URL al crear las URL para el desarrollo y la verificación por fases. AEM Si verifica la extensión con otras IU de, consiga esas URL y aplique los mismos pasos a continuación.

Verificar compilaciones de desarrollo local

  1. Abra una línea de comandos en la raíz del proyecto de extensión.

  2. AEM Ejecute la extensión de la IU de la aplicación como una aplicación local de App Builder

    code language-shell
    $ aio app run
    ...
    No change to package.json was detected. No package manager install will be executed.
    
    To view your local application:
      -> https://localhost:9080
    To view your deployed application in the Experience Cloud shell:
      -> https://experience.adobe.com/?devMode=true#/custom-apps/?localDevUrl=https://localhost:9080
    

Tome nota de la URL de la aplicación local, que se muestra arriba como -> https://localhost:9080

  1. Inicialmente (y siempre que vea un error de conexión) abra https://localhost:9080 (o la URL de su aplicación local) en su explorador web y acepte manualmente el certificado HTTPS.

  2. AEM Agregue los dos parámetros de consulta siguientes a la dirección URL de la interfaz de usuario 🔗

    • &devMode=true
    • &ext=<LOCAL APPLICATION URL>, normalmente &ext=https://localhost:9080.

    Agregue los dos parámetros de consulta anteriores (devMode y ext) como los primeros parámetros de consulta de la dirección URL. AEM La interfaz de usuario extensible que se está utilizando utiliza rutas hash (#/@wknd/aem/...), por lo que la corrección posterior de los parámetros después de # no funciona de manera incorrecta.

    La URL de vista previa debe tener este aspecto:

    code language-none
    https://experience.adobe.com/?devMode=true&ext=https://localhost:9080&repo=author-p1234-e5678.adobeaemcloud.com#/@wknd/aem/cf/admin
    
  3. Copie y pegue la dirección URL de vista previa en el explorador.

  4. AEM La interfaz de usuario de se carga con la versión local de la extensión insertada en ella para la verificación.

IMPORTANT
AEM Recuerde, al utilizar este método, la extensión en desarrollo solo afecta a su experiencia de y todos los demás usuarios de la interfaz de usuario de la interfaz de usuario de la experiencia de la interfaz de usuario de sin la extensión insertada.

Verificar compilaciones de fase

  1. Abra una línea de comandos en la raíz del proyecto de extensión.

  2. Asegúrese de que el espacio de trabajo de fase esté activo (o el Workspace que se utilice para la verificación).

    code language-shell
    $ aio app use -w Stage
    

    Combine cualquier cambio realizado en .env y .aio.

  3. Implemente la aplicación de App Builder de extensión actualizada. Si no inició sesión, ejecute aio login primero.

    code language-shell
    $ aio app deploy
    ...
    Your deployed actions:
    web actions:
      -> https://98765-123aquarat.adobeio-static.net/api/v1/web/aem-cf-console-admin-1/generic
    To view your deployed application:
      -> https://98765-123aquarat.adobeio-static.net/index.html
    To view your deployed application in the Experience Cloud shell:
      -> https://experience.adobe.com/?devMode=true#/custom-apps/?localDevUrl=https://98765-123aquarat.adobeio-static.net/index.html
    New Extension Point(s) in Workspace 'Production': 'aem/cf-console-admin/1'
    Successful deployment 🏄
    
  4. AEM Agregue los dos parámetros de consulta siguientes a la dirección URL de la interfaz de usuario 🔗

    • &devMode=true
    • &ext=<DEPLOYED APPLICATION URL>

    AEM Agregue los dos parámetros de consulta anteriores (devMode y ext) como los primeros parámetros de consulta en la dirección URL, ya que las IU de extensibles utilizan una ruta hash (#/@wknd/aem/...), por lo que la corrección posterior incorrecta de los parámetros después de # no funciona.

    La URL de vista previa debe tener este aspecto:

    code language-none
    https://experience.adobe.com/?devMode=true&ext=https://98765-123aquarat.adobeio-static.net/index.html&repo=author-p1234-e5678.adobeaemcloud.com#/@wknd/aem/cf/admin
    
  5. Copie y pegue la dirección URL de vista previa en el explorador.

  6. AEM La consola Fragmento de contenido de la aplicación inserta la versión de la extensión implementada en el espacio de trabajo de fase en. Esta URL de fase se puede compartir con los usuarios de control de calidad o empresariales para su verificación.

AEM Recuerde, al utilizar este método, la extensión Ensayada solo se inserta en la consola Fragmento de contenido de la consola cuando se accede a con la URL de ensayo artesanal.

  1. Las extensiones implementadas se pueden actualizar ejecutando aio app deploy de nuevo, y estos cambios se reflejarán automáticamente al utilizar la dirección URL de vista previa.
  2. Para quitar una extensión con fines de verificación, ejecute aio app undeploy.

Previsualizar bookmarklet

Para facilitar la creación de las direcciones URL de vista previa y de vista previa descritas anteriormente, se puede crear un bookmarklet de JavaScript que cargue la extensión.

El bookmarklet siguiente muestra una vista previa de las compilaciones de desarrollo local de la extensión en https://localhost:9080. Para obtener una vista previa de compilaciones de ensayo, cree un bookmarklet con la variable previewApp establecida en la dirección URL de la aplicación de App Builder implementada.

  1. Cree un marcador en el explorador.

  2. Edite el marcador.

  3. Asigne un nombre significativo a un marcador, como AEM UI Extension Preview (localhost:9080).

  4. Establezca la dirección URL del marcador en el siguiente código:

    code language-javascript
    javascript: (() => {
        /* Change this to the URL of the local App Builder app if not using https://localhost:9080 */
        const previewApp = 'https://localhost:9080';
    
        const repo = new URL(window.location.href).searchParams.get('repo');
    
        if (window.location.href.match(/https:\/\/experience\.adobe\.com\/.*\/aem\/cf\/(editor|admin)\/.*/i)) {
            window.location = `https://experience.adobe.com/?devMode=true&ext=${previewApp}&repo=${repo}${window.location.hash}`;
        }
    })();
    
  5. AEM Vaya a una interfaz de usuario de ampliable en la que cargar la extensión de vista previa y, a continuación, haga clic en el bookmarklet.

TIP
Si la extensión de App Builder no se carga, al usar, &ext=https://localhost:9080, abra ese host y ese puerto directamente en una pestaña del explorador y acepte el certificado firmado automáticamente. A continuación, vuelva a intentar el bookmarklet.
recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69