AEM as a Cloud Service SDK aem-as-a-cloud-service-sdk
AEM as a Cloud Service SDK består av följande artefakter:
- Quickstart JAR - AEM-miljön som används för lokal utveckling.
- Java™ API Jar - Java™ Jar/Maven Dependency som visar alla Java™-API:er som kan användas för att utveckla mot AEM as a Cloud Service. Kallas tidigare Uberjar.
- Javadoc Jar - Java-dokumentet för Java™ API Jar.
- Dispatcher-verktyg - Den uppsättning verktyg som används för att utveckla mot Dispatcher lokalt. Separata artefakter för UNIX® och Windows.
Vissa kunder som tidigare har distribuerats med AEM 6.5 eller tidigare använder artefakterna nedan. Om den lokala kompileringen inte fungerar med QuickStart Jar och du misstänker att den inte fungerar när gränssnitt tas bort från AEM distribuerade as a Cloud Service kontaktar du kundsupport. De kan avgöra om du behöver åtkomst. Det kräver ändringar i backend-objektet.
- 6.5 Java™ API Jar - En extra uppsättning gränssnitt som har tagits bort sedan AEM 6.5.
- 6.5 Javadoc Jar har tagits bort - Java-dokumenten för den extra uppsättningen gränssnitt.
Building for the SDK building-for-the-sdk
AEM as a Cloud Service SDK används för att skapa och distribuera anpassad kod. Se dokumentationen för AEM Project Archetype. På en hög nivå utförs följande steg:
- Kompileringskod - Source-koden kompileras och de resulterande innehållspaketen genereras.
- Skapa artefakter - Artefakter skapas under den här processen.
- Analysera paket - Paketen analyseras med Maven analyzer-plugin, som söker efter problem i Maven-projektet, till exempel saknade beroenden.
- Distribuera artefakter - Artefakter distribueras till den lokala servern.
Cloud Manager utför samma steg när det distribueras till molnmiljöer. När du utför byggen lokalt kan du utveckla och testa dem lokalt. Utvecklare kan effektivt identifiera kod- eller strukturproblem innan de förbinder sig till källkontroll. Denna process förebygger förseningar som orsakas av att Cloud Manager driftsätts, vilket kan ta längre tid.
Åtkomst till AEM as a Cloud Service SDK accessing-the-aem-as-a-cloud-service-sdk
- Du kan kontrollera ikonen för AEM Admin Console Om Adobe Experience Manager om du vill ta reda på vilken version av AEM du använder.
- QuickStart Jar och Dispatcher Tools kan laddas ned som en zip-fil från Software Distribution Portal. Åtkomsten till SDK-listorna är begränsad till dem som har miljöer på AEM Managed Services eller AEM as a Cloud Service.
- Java™ API Jar och Javadoc Jar kan laddas ned via Maven-verktygen, antingen kommandoraden eller med den utvecklingsmiljö du föredrar.
- Maven project poms ska referera till följande API Jar-paket. Beroende av delpaketets öppningar ska också refereras.
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
<version>2019.11.3006.20191108T223635Z-191201</version>
<scope>provided</scope>
</dependency>
Uppdatera ett lokalt projekt med en ny version av SDK refreshing-a-local-project-with-a-new-skd-version
När bör du uppdatera det lokala projektet med en ny SDK?
Adobe rekommenderar att uppdaterar den efter en månadsvis underhållsversion.
Det är valfritt att uppdatera det efter en daglig underhållsrelease. Kunderna informeras om när deras produktionsinstans har uppgraderats till en ny version av AEM. För de dagliga underhållsreleaserna förväntas inte att nya SDK har ändrats avsevärt, om alls. Adobe rekommenderar dock att du ibland uppdaterar den lokala utvecklingsmiljön i AEM med den senaste versionen av SDK och sedan återskapar och testar det anpassade programmet. Den månatliga underhållsreleasen innehåller vanligtvis mer omfattande ändringar och utvecklare bör därför omedelbart uppdatera, återskapa och testa.
Så här uppdaterar du ett lokalt projekt med en ny version av SDK:
- Se till att allt användbart innehåll implementeras för källkontroll. Eller lagras i ett ändringsbart innehållspaket för senare import.
- Lokalt utvecklingstestinnehåll måste lagras separat så att det inte distribueras som en del av Cloud Manager pipeline-bygget. Orsaken är att den bara används för lokal utveckling.
- Stoppa snabbstarten som körs.
- Flytta mappen
crx-quickstarttill en annan mapp för säker lagring. - Observera den nya AEM-versionen som beskrivs i Cloud Manager (den används för att identifiera den nya QuickStart Jar-versionen som du kan ladda ned ytterligare).
- Ladda ned QuickStart Jar vars version matchar Production AEM-versionen från Software Distribution Portal.
- Skapa en helt ny mapp och placera den nya QuickStart Jar i.
- Starta den nya snabbstarten med de önskade körningslägena (antingen ändra namn på filen eller skicka i körningsläge med
-r).
Kontrollera att det inte finns någon kvar av den gamla snabbstarten i mappen. - Bygg en AEM-applikation.
- Distribuera ditt AEM-program till lokala AEM med hjälp av Package Manager.
- Installera eventuella ändringsbara innehållspaket som behövs för lokal miljötestning med hjälp av Package Manager.
- Fortsätt med utvecklingen och distribuera ändringarna efter behov.
Om det finns innehåll som ska installeras med varje ny version av AEM QuickStart ska du inkludera det i ett innehållspaket och i projektets källkontroll. Installera det sedan varje gång.
Adobe rekommenderar att du uppdaterar SDK ofta, till exempel varannan vecka. Och kassera hela det lokala läget dagligen så att du inte av misstag förlitar dig på tillståndskänsliga data i programmet.
Om du använder CryptoSupport för molntjänster, SMTP Mail-konfiguration eller CryptoSupport API skyddas krypterade egenskaper med en nyckel. Mer information finns i API-dokumentationen för CryptoSupport. Nyckeln genereras automatiskt första gången en AEM-miljö startas. Molninstallationen hanterar automatiskt återanvändning av den miljöspecifika CryptoKey, men du måste injicera kryptonyckeln i den lokala utvecklingsmiljön.
Som standard är AEM konfigurerat att lagra nyckeldata i en mapps datamapp, men för att underlätta återanvändning under utvecklingen kan AEM-processen initieras vid första starten med -Dcom.adobe.granite.crypto.file.disable=true. Den här processen genererar krypteringsdata på /etc/key.
Så här återanvänder du innehållspaket som innehåller de krypterade värdena:
- När du startar den lokala quickstart.jar ska du lägga till följande parameter:
-Dcom.adobe.granite.crypto.file.disable=true. Adobe rekommenderar att du alltid lägger till det. - Första gången du startar en instans skapar du ett paket som innehåller ett filter för roten
/etc/key. Det här paketet innehåller hemligheten som ska återanvändas i alla miljöer som du vill att de ska återanvändas för. - Exportera muterbart innehåll som innehåller hemligheter. Du kan också söka efter krypterade värden med hjälp av
/crx/deså att du kan lägga till dem i paketet som återanvänds i alla installationer. - När du skapar en ny instans (antingen för att ersätta med en ny version eller för att flera utvecklingsmiljöer ska dela inloggningsuppgifterna för testning) installerar du paketet som skapats i steg 2 och 3. På så sätt kan du återanvända innehållet utan att behöva konfigurera om det manuellt. Orsaken är att nu är kryptonyckeln synkroniserad.