Een extensie verifiëren

Laatst bijgewerkt: 24 maart 2025

Gemaakt voor:

  • Beginner
  • Ontwikkelaar

AEM UI-extensies kunnen worden gecontroleerd op elke AEM as a Cloud Service-omgeving in de Adobe Org waartoe de extensie behoort.

Het testen van een extensie gebeurt via een speciaal gemaakte URL die AEM de instructie geeft de extensie alleen voor die aanvraag te laden.

video poster
IMPORTANT
In de bovenstaande video ziet u het gebruik van een extensie van Content Fragment Console om de voorvertoning en verificatie van de App Builder-extensie-app te illustreren. Nochtans, is het belangrijk om op te merken dat de behandelde concepten op alle uitbreidingen van de gebruikersinterface van AEM kunnen worden toegepast.

URL AEM-interface

URL van de Console van het Fragment van AEM Inhoud

Als u een URL wilt maken die de extensie non-production in AEM koppelt, moet de URL van de AEM-interface waarin de extensie wordt geïnjecteerd, worden verkregen. Navigeer naar de AEM as a Cloud Service-omgeving om de extensie te controleren en open de gebruikersinterface waarin de extensie moet worden voorvertoond.

Als u bijvoorbeeld een extensie wilt voorvertonen voor de Content Fragment-console:

  1. Meld u aan bij de gewenste AEM as a Cloud Service-versie.

  2. Selecteer het pictogram van de Fragmenten van de Inhoud.

  3. Wacht tot de AEM Content Fragment Console in de browser is geladen.

  4. Kopieer de URL van de AEM Content Fragment Console van de adresbalk van de browser en het lijkt erop:

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

Deze URL wordt hieronder gebruikt bij het maken van de URL's voor ontwikkeling en werkgebiedverificatie. Als u de extensie verifieert aan de hand van andere gebruikersinterface van AEM, vraagt u deze URL's op en past u onderstaande dezelfde stappen toe.

Builds voor lokale ontwikkeling controleren

  1. Open een opdrachtregel naar de hoofdmap van het extensieproject.

  2. De AEM UI-extensie uitvoeren als een lokale App Builder-app

    $ 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

Noteer de URL van de lokale toepassing, die hierboven wordt weergegeven als -> https://localhost:9080

  1. Aanvankelijk (en wanneer u een Fout van de Verbinding ziet) open https://localhost:9080 (of wat uw lokale toepassings URL) in uw Webbrowser is, en keurt manueel het HTTPS certificaatgoed.

  2. Voeg de volgende twee vraagparams aan toe AEM UI URL

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

    Voeg de twee bovengenoemde vraagparameters (devMode en ext) als eerste vraagparameters in URL toe. AEM die verlengbare UI gebruikshash routes (#/@wknd/aem/...), zo verkeerd post-bevestigend de parameters nadat # niet werkt.

    De voorbeeld-URL moet er als volgt uitzien:

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

  3. Kopieer en plak de URL van de voorvertoning in uw browser.

    • U kunt moeten aanvankelijk, en dan periodiek, het certificaat HTTPSvoor de gastheer van de lokale toepassing (https://localhost:9080) goedkeuren.

  4. De gebruikersinterface van AEM wordt geladen met de lokale versie van de extensie die in de interface is geïnjecteerd voor verificatie.

IMPORTANT
Houd er rekening mee dat bij het gebruik van deze benadering de extensie die wordt ontwikkeld alleen van invloed is op uw ervaring. Alle andere gebruikers van de gebruikersinterface van AEM ervaren de gebruikersinterface zonder de geïnjecteerde extensie.

Werkgebiedbuilds verifiëren

  1. Open een opdrachtregel naar de hoofdmap van het extensieproject.

  2. Controleer of de werkruimte van het werkgebied actief is (of welke Workspace ook wordt gebruikt voor verificatie).

    $ aio app use -w Stage

    Voeg eventuele wijzigingen in .env en .aio samen.

  3. Implementeer de bijgewerkte extensie App Builder-app. Als u zich niet hebt aangemeld, voert u aio login eerst uit.

    $ 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. Voeg de volgende twee vraagparams aan toe AEM UI URL

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

    Voeg de twee bovengenoemde vraagparameters (devMode en ext) als eerste vraagparameters in URL toe, aangezien verlengbare AEM UIs een knoeiboelroute (#/@wknd/aem/...) gebruikt, zo verkeerd post-bevestigend de parameters nadat # niet werkt.

    De voorbeeld-URL moet er als volgt uitzien:

    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. Kopieer en plak de URL van de voorvertoning in uw browser.

  6. Met de AEM Content Fragment Console wordt de versie van de extensie geïnjecteerd naar de werkruimte van het werkgebied. Deze werkgebied-URL kan ter verificatie worden gedeeld met een kwaliteitscontrole of zakelijke gebruikers.

Wanneer u deze methode gebruikt, wordt de extensie Staged alleen geïnjecteerd in AEM Content Fragment Console wanneer u toegang hebt tot de URL van het werkgebied.

  1. Geïmporteerde extensies kunnen worden bijgewerkt door aio app deploy opnieuw uit te voeren. Deze wijzigingen worden automatisch doorgevoerd wanneer u de URL van de voorvertoning gebruikt.
  2. Voer aio app undeploy uit om een extensie voor verificatie te verwijderen.