Een lokale AEM ontwikkelomgeving instellen

Handleiding voor het opzetten van een lokale ontwikkeling voor Adobe Experience Manager, AEM. Omvat belangrijke onderwerpen van lokale installatie, Apache Maven, geïntegreerde ontwikkelomgevingen en het zuiveren/het oplossen van problemen. De ontwikkeling met winde van de Verduistering, CRXDE Lite, de Code van Visual Studio, en IntelliJ wordt besproken.

Overzicht

Het opzetten van een lokale ontwikkelomgeving is de eerste stap bij het ontwikkelen voor Adobe Experience Manager of AEM. Neem de tijd om een ontwikkelomgeving voor kwaliteit in te stellen om uw productiviteit te verhogen en betere code te schrijven, sneller. We kunnen een AEM lokale ontwikkelingsomgeving in vier gebieden verdelen:

Lokale AEM installeren

Wanneer we naar een lokale AEM verwijzen, hebben we het over een kopie van Adobe Experience Manager die op de persoonlijke machine van een ontwikkelaar draait. allen AEM ontwikkeling zou moeten beginnen door code tegen een lokale AEM instantie te schrijven en in werking te stellen.

Als u nieuw aan AEM bent, zijn er twee basis in werking gestelde wijzen kan worden geïnstalleerd: Auteur en Publish. De Auteur runmodeis het milieu dat de digitale marketers gebruiken om inhoud tot stand te brengen en te beheren. Wanneer het ontwikkelen van het grootste deel van de tijd, stelt u code aan een instantie van de Auteur op. Zo kunt u pagina's maken en componenten toevoegen en configureren. AEM Sites is een WYSIWYG-ontwerpversie van CMS en daarom kunnen de meeste CSS en JavaScript worden getest op basis van een ontwerpinstantie.

Het is ook kritieke testcode tegen een lokale Publish instantie. De Publish instantie is het AEM milieu dat de bezoekers aan uw website met in wisselwerking staan. Terwijl Publish instantie de zelfde technologiestapel zoals de 3} instantie van de Auteur {is, zijn er één of ander belangrijk onderscheid met configuraties en toestemmingen. De code moet tegen een lokale Publish instantie worden getest alvorens aan milieu's op hoger niveau wordt bevorderd.

Stappen

~/aem-sdk
    /author
    /publish

~/aem-sdk
    /author
        + aem-author-p4502.jar
        + license.properties
    /publish
        + aem-publish-p4503.jar
        + license.properties

Dubbelklik het {dossier 0} aem-publish-p4503.jar om de ​ Publish​ instantie te installeren. Dit begint de instantie van Publish, lopend op haven 4503 op de lokale computer.

Opdrachtregel gebruiken

U kunt ook dubbelklikken op het JAR-bestand door AEM te starten vanaf de opdrachtregel of een script te maken (.bat of .sh ), afhankelijk van de lokale systeemsmaak. Hieronder ziet u een voorbeeld van de voorbeeldopdracht:

$ java -Xmx2048M -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=30303 -jar aem-author-p4502.jar -gui -r"author,localdev"

Hier, zijn -X opties JVM en -D zijn extra kadereigenschappen, voor meer informatie, zie het Opstellen en het Onderhouden van een AEM instantieen Verdere opties beschikbaar van het dossier van QuickStart.

Apache Maven installeren

Apache Maven is een hulpmiddel om de bouwstijl te beheren en procedure voor op Java-Gebaseerde projecten op te stellen. AEM is een op Java gebaseerd platform en Maven is de standaardmanier om code voor een AEM project te beheren. Wanneer wij AEM Gemaakt Project of enkel uw AEM Project zeggen, verwijzen wij naar een Geweven project dat alle douane code voor uw plaats omvat.

Alle AEM Projecten zouden van de recentste versie van AEM Project Archetype moeten worden gebouwd: https://github.com/adobe/aem-project-archetype. AEM Project Archetype verstrekt een laarzentrekker van een AEM project met wat steekproefcode en inhoud. AEM Project Archetype omvat ook AEM WCM Core Components dat wordt gevormd om op uw project te worden gebruikt.

Stappen

$ mvn --version
Apache Maven 3.3.9
Maven home: /Library/apache-maven-3.3.9
Java version: 1.8.0_111, vendor: Oracle Corporation
Java home: /Library/Java/JavaVirtualMachines/jdk1.8.0_111.jdk/Contents/Home/jre
Default locale: en_US, platform encoding: UTF-8

Een geïntegreerde ontwikkelomgeving instellen

Een geïntegreerde ontwikkelomgeving of IDE is een toepassing waarin een teksteditor, syntaxisondersteuning en build-tools worden gecombineerd. Afhankelijk van het type van ontwikkeling u doet, zou één winde boven een andere kunnen verkiezen. Ongeacht winde, is het belangrijk om druk code aan een lokale AEM instantie periodiek te kunnen {om het te testen. Het is belangrijk om af en toe ​ ​** configuraties van een lokale AEM instantie in uw AEM project te trekken om aan een bron-controle beheerssysteem zoals Git voort te zetten.

Hieronder staan een paar populairdere IDEs die met AEM ontwikkeling met overeenkomstige video's worden gebruikt die de integratie met een lokale AEM instantie tonen.

$ mvn clean install -PautoInstallSinglePackage -Pclassic

Wanneer u een IDE gebruikt, moet u classic controleren op het tabblad Geweven profiel.

IntelliJ Geweven Profiel

Eclipse IDE

Eclipse winde is één van populairdere IDEs voor ontwikkeling Java™, in het grootste deel omdat het open bron en vrij is! Adobe verstrekt een stop, AEM Developer Tools, voor Eclipse om gemakkelijkere ontwikkeling met een aardige GUI toe te staan om code met een lokale AEM instantie te synchroniseren. De Eclipse IDE wordt aanbevolen voor ontwikkelaars die niet voor een groot deel AEM vanwege de GUI-ondersteuning door AEM Developer Tools .

Installatie en installatie

IntelliJ IDEA

IntelliJ IDEA is krachtige winde voor professionele ontwikkeling Java™. IntelliJ IDEA komt in twee aroma's, a vrije Community uitgave en een commerciële (betaalde) Ultimate versie. De vrije Community versie van IntellIJ IDEA is voldoende voor meer AEM ontwikkeling, nochtans Ultimate breidt zijn vermogensreeksuit.

Installation and Setup

Visual Studio Code

Code van Visual Studio is snel een favoriet hulpmiddel voor front-end ontwikkelaars met de verbeterde steun van JavaScript, Intellisense, en browser het zuiveren steun geworden. Visual Studio Code is opensource, gratis, met veel krachtige extensies. Visual Studio Code kan opstelling worden om met AEM met behulp van een hulpmiddel van de Adobe, repote integreren. Er zijn ook verschillende door de gemeenschap ondersteunde extensies die kunnen worden geïnstalleerd om met AEM te integreren.

Visual Studio Code is een goede keuze voor front-end ontwikkelaars die vooral CSS/LESS en JavaScript-code schrijven om AEM clientbibliotheken te maken. Dit hulpmiddel kan niet de beste keus voor nieuwe AEM ontwikkelaars zijn aangezien de knoopdefinities (dialogen, componenten) in ruwe XML moeten worden uitgegeven. Er zijn verschillende Java™-extensies beschikbaar voor Visual Studio Code , maar als de voorkeur uitgaat naar het ontwikkelen van Java™ Eclipse IDE of IntelliJ .

Belangrijke koppelingen

CRXDE Lite

CRXDE Liteis een op browser-gebaseerde mening van de AEM bewaarplaats. CRXDE Lite is ingesloten in AEM en biedt een ontwikkelaar de mogelijkheid om standaardontwikkelingstaken uit te voeren, zoals het bewerken van bestanden, het definiëren van componenten, dialoogvensters en sjablonen. CRXDE Lite is niet bedoeld om een volledig ontwikkelomgeving te zijn maar is efficiënt als het zuiveren hulpmiddel. CRXDE Lite is nuttig wanneer het uitbreiden van of eenvoudig begrip van productcode buiten uw codebasis. CRXDE Lite biedt een krachtige weergave van de opslagplaats en een manier om machtigingen effectief te testen en te beheren.

CRXDE Lite zou met andere IDEs moeten worden gebruikt om code te testen en te zuiveren maar nooit als primair ontwikkelingshulpmiddel. Er is beperkte syntaxisondersteuning, geen automatische functionaliteit en beperkte integratie met bronbeheersystemen.

Problemen oplossen

Hulp! Mijn code werkt niet! Net als bij alle ontwikkelingen zijn er tijden (waarschijnlijk veel) waarin uw code niet naar behoren werkt. AEM is een krachtig platform, maar met grote kracht… komt er grote complexiteit. Hieronder vindt u een aantal uitgangspunten op hoog niveau voor het oplossen van problemen en het opsporen van problemen (maar ver van een volledige lijst met dingen die fout kunnen gaan):

Codeimplementatie verifiëren

Een goede eerste stap, wanneer het ontmoeten van een kwestie moet verifiëren dat de code met succes aan AEM is opgesteld en geïnstalleerd.

Logbestanden controleren

AEM is een praatjesplatform en registreert nuttige informatie in error.log. error.log kan worden gevonden waar AEM is geïnstalleerd: < aem-installation-folder>/crx-quickstart/logs/error.log.

Een handige techniek voor het bijhouden van problemen is het toevoegen van loginstructies in uw Java™-code:

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
...

public class MyClass {
    private final Logger log = LoggerFactory.getLogger(getClass());

    ...

    String myVariable = "My Variable";

    log.debug("Debug statement of myVariable {}", myVariable);

    log.info("Info statement of myVariable {}", myVariable);
}

Door gebrek error.log wordt gevormd om INFO verklaringen te registreren. Als u het logboekniveau wilt veranderen, kunt u dit doen door Log Support te gaan: http://localhost:4502/system/console/slinglog. U kunt ook vinden dat error.log te praatje is. Met de Log Support kunt u loginstructies configureren voor alleen een opgegeven Java™-pakket. Dit is een beste praktijk voor projecten, om de kwesties van de douanecode van OTB AEM platformkwesties gemakkelijk van elkaar te scheiden.

Bundel bevindt zich in de status Geïnstalleerd bundle-active

Alle bundels (met uitzondering van fragmenten) moeten de status Active hebben. Als u de codebundel in een Installed staat ziet, dan is er een kwestie die moet worden opgelost. Meestal is dit een afhankelijkheidskwestie:

In de bovenstaande schermafbeelding is WKND Core bundle een Installed -status. Dit komt omdat de bundel een andere versie van com.adobe.cq.wcm.core.components.models verwacht dan beschikbaar is op de AEM instantie.

Een nuttig hulpmiddel dat kan worden gebruikt is Dependency Finder: http://localhost:4502/system/console/depfinder. Voeg de naam van het Java™-pakket toe om te controleren welke versie beschikbaar is op het AEM:

Voortdurend met het bovenstaande voorbeeld, kunnen wij zien dat de versie die op de AEM instantie wordt geïnstalleerd 12.2 vs 12.6 is dat de bundel verwachtte. Daarna kunt u achterwaarts werken en zien of de Maven -afhankelijkheden van AEM overeenkomen met de Maven -afhankelijkheden in het AEM-project. In, is het bovenstaande voorbeeld Core Components v2.2.0 geïnstalleerd op de AEM instantie maar de codebundel werd gebouwd met een gebiedsdeel op v2.2.2, vandaar de reden voor de gebiedsdeelkwestie.

Registratie van verkoopmodellen verifiëren osgi-component-sling-models

AEM componenten moeten door een Sling Model worden gesteund om om het even welke bedrijfslogica in te kapselen en ervoor te zorgen dat het HTML teruggevende manuscript schoon blijft. Als het ervaren van kwesties waar het het Verdelen Model niet kan worden gevonden, kan het nuttig zijn om Sling Models van de console te controleren: http://localhost:4502/system/console/status-slingmodels. Dit vertelt u als uw het Verkopen Model is geregistreerd en welk middeltype (de componentenweg) het aan verbonden is.

Toont de registratie van een Sling Model BylineImpl die aan een componentenmiddeltype van wknd/components/content/byline gebonden is.

Problemen met CSS of JavaScript

Voor de meeste problemen met CSS en JavaScript is het gebruik van de ontwikkelingstools van de browser de meest effectieve manier om problemen op te lossen. Als u het probleem wilt beperken bij het ontwikkelen tegen een AEM instantie van de auteur, is het handig om de pagina "zoals gepubliceerd" weer te geven.

Open het menu Page Properties en klik op View as Published . Dit opent de pagina zonder de AEMRedacteur en met een vraagparameter die aan wordt geplaatst wcmmode=disabled. Dit maakt effectief de AEM auteursUI onbruikbaar en maakt het oplossen van problemen/het zuiveren front-end kwesties veel gemakkelijker.

Een ander vaak ondervonden probleem bij het ontwikkelen van front-end code is oud of verouderd CSS/JS wordt geladen. Als eerste stap moet u ervoor zorgen dat de browsergeschiedenis is gewist en zo nodig een incognitobrowser of een nieuwe sessie starten.

Fouten opsporen in clientbibliotheken

Met de verschillende methodes van categorieën en bedden om veelvoudige cliëntbibliotheken te omvatten kan het lastig zijn om problemen op te lossen. AEM stelt verschillende hulpmiddelen beschikbaar om hierbij te helpen. Een van de belangrijkste gereedschappen is Rebuild Client Libraries , waarmee AEM alle LESS-bestanden opnieuw moet compileren en de CSS moet genereren.