DokumentationAEMSjälvstudiekurser om AEMSjälvstudiekurser om AEM as a Cloud Service

Verifiera ett tillägg

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Nybörjare
  • Utvecklare

AEM UI-tillägg kan verifieras mot alla AEM as a Cloud Service-miljöer i Adobe-organisationen som tillägget tillhör.

Testning av ett tillägg görs via en URL som skapats för ändamålet och som instruerar AEM att läsa in tillägget, endast för den begäran som skickas.

https://video.tv.adobe.com/v/3412877?quality=12&learn=on

IMPORTANT
I videon ovan visas hur ett tillägg till Content Fragment Console används för att illustrera förhandsgranskning och verifiering av App Builder-tilläggsappar. Det är dock viktigt att komma ihåg att de koncept som omfattas kan tillämpas på alla AEM UI-tillägg.

AEM URL

AEM URL:en för konsolen Innehållsfragment

Om du vill skapa en URL som monterar det icke-producerade tillägget i AEM måste URL:en för det AEM användargränssnittet som tillägget matas in i hämtas. Navigera till AEM as a Cloud Service-miljön för att verifiera tillägget och öppna användargränssnittet som tillägget ska förhandsgranskas i.

Om du till exempel vill förhandsgranska ett tillägg för konsolen Innehållsfragment:

  1. Logga in på önskad AEM as a Cloud Service-miljö.

  2. Välj ikonen Innehållsfragment .

  3. Vänta tills AEM Content Fragment Console läses in i webbläsaren.

  4. Kopiera URL:en för AEM Content Fragment Console från webbläsarens adressfält. Den ska likna:

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

Den här URL:en används nedan när du skapar URL:er för utveckling och scenverifiering. Om du verifierar tillägget mot andra AEM UI:er hämtar du dessa URL:er och utför samma steg nedan.

Verifiera lokala utvecklingsbyggen

  1. Öppna en kommandorad i tilläggsprojektets rot.

  2. Kör AEM UI-tillägg som en lokal App Builder-app

    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

Observera den lokala program-URL:en som visas ovan som -> https://localhost:9080

  1. Först (och när du ser ett anslutningsfel) öppnar du https://localhost:9080 (eller någon annan URL för ditt lokala program) i webbläsaren och accepterar HTTPS-certifikatet manuellt.

  2. Lägg till följande två frågeparametrar i AEM-gränssnittets URL

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

    Lägg till de två ovanstående frågeparametrarna (devMode och ext) som first -frågeparametrar i URL:en. AEM utökningsbart användargränssnitt använder hash-vägar (#/@wknd/aem/...), vilket gör att parametrarna inte fungerar korrekt efter att # har åtgärdats.

    URL:en för förhandsgranskning ska se ut så här:

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

  3. Kopiera och klistra in URL:en för förhandsgranskning i webbläsaren.

    • Du kan behöva göra det först, och sedan regelbundet, acceptera HTTPS-certifikatet för det lokala programmets värd (https://localhost:9080).

  4. Det AEM användargränssnittet läses in med den lokala versionen av tillägget inmatad i det för verifiering.

IMPORTANT
Kom ihåg att när du använder den här metoden så påverkar tillägget under utveckling bara din upplevelse, och alla andra användare av AEM gränssnitt upplever användargränssnittet utan det injicerade tillägget.

Verifiera scenbyggen

  1. Öppna en kommandorad i tilläggsprojektets rot.

  2. Kontrollera att scenarbetsytan är aktiv (eller den Workspace som används för verifiering).

    code language-shell 
    $ aio app use -w Stage

    Sammanfoga alla ändringar i .env och .aio.

  3. Distribuera det uppdaterade tillägget i App Builder-appen. Om du inte är inloggad kör du aio login först.

    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. Lägg till följande två frågeparametrar i AEM-gränssnittets URL

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

    Lägg till de två ovanstående frågeparametrarna (devMode och ext) som first -frågeparametrarna i URL:en, eftersom utökningsbara gränssnitt AEM använder en hash-väg (#/@wknd/aem/...), vilket innebär att korrigeringen av parametrarna efter att # inte fungerar korrekt.

    URL:en för förhandsgranskning ska se ut så här:

    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. Kopiera och klistra in URL:en för förhandsgranskning i webbläsaren.

  6. AEM Content Fragment Console injicerar den version av tillägget som distribueras till scenarbetsytan i. Denna scen-URL kan delas med QA- eller företagsanvändare för verifiering.

Kom ihåg att när du använder den här metoden injiceras tillägget Mellanlagring bara på AEM Content Fragment Console när du får tillgång till den här programmeringsscenens URL.

  1. Distribuerade tillägg kan uppdateras genom att köra aio app deploy igen, och dessa ändringar återspeglas automatiskt när URL:en för förhandsgranskning används.
  2. Kör aio app undeploy om du vill ta bort ett tillägg för verifiering.

Förhandsgranska bokmärkesdiagram

För att förenkla skapandet av förhandsgransknings- och förhandsgransknings-URL:er som beskrivs ovan kan ett JavaScript-bokmärke som läser in tillägget skapas.

Bokmärkesschemat nedan förhandsvisar de lokala utvecklingsbyggen för tillägget på https://localhost:9080. Om du vill förhandsgranska scenbyggen skapar du ett bokmärkesdiagram med variabeln previewApp inställd på URL:en för den distribuerade App Builder-appen.

  1. Skapa ett bokmärke i webbläsaren.

  2. Redigera bokmärket.

  3. Ge ett bokmärke ett beskrivande namn, till exempel AEM UI Extension Preview (localhost:9080).

  4. Ställ in bokmärkets URL till följande kod:

    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. Navigera till ett utökningsbart AEM för att läsa in förhandsvisningstillägget och klicka sedan på bokmärkesdiagrammet.

TIP
Om App Builder-tillägget inte läses in när &ext=https://localhost:9080 används, öppnar du värden och porten direkt på en webbläsarflik och godkänner det självsignerade certifikatet. Prova sedan bokmärket igen.
recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69