Projectarchetype AEM

Het AEM Project Archetype is een Geweven malplaatje dat tot een minimaal, op best-praktijken-gebaseerd Adobe Experience Manager (AEM) project als uitgangspunt voor uw website leidt.

TIP

De nieuwste AEM Project Archetype kan op GitHub worden gevonden.

Bronnen

  • Archetype Documentatie (dit document): Overzicht van de architectuur archetype en zijn verschillende modules.
    • Archetype gebruiken: nadere bijzonderheden over het gebruik van het archetype en de beschikbare modules
    • ui.frontend: Hoe te om het vooreind te gebruiken bouwt module
  • De volgende zelfstudies zijn gebaseerd op dit archetype:

Functies

Gebruik

Om een project te produceren, pas de volgende bevellijn aan uw behoeften aan:

mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=XX \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
  • Vervangen XX uiterlijk archietype versienummer.
  • Set aemVersion=cloud for AEM as a Cloud Service;
    Set aemVersion=6.5.0 for Beheerde services van Adobeof op locatie.
    De afhankelijkheid van kerncomponenten wordt alleen toegevoegd voor versies met een andere naam dan de cloud, aangezien de Core Components OTB voor AEM as a Cloud Service wordt geleverd.
  • Aanpassen appTitle="My Site" om de titel van de website en de groepen componenten te definiëren.
  • Aanpassen appId="mysite" om Maven artifactId, de component, config en de namen van de inhoudsomslag, evenals de namen van de cliëntbibliotheek te bepalen.
  • Aanpassen groupId="com.mysite" om Maven groupId en het Bron Pakket van Java te bepalen.
  • Zoek de lijst met beschikbare eigenschappen op om te zien of u meer eigenschappen wilt aanpassen.

Beschikbare eigenschappen

Naam Standaard Beschrijving
appTitle Toepassingstitel, wordt gebruikt voor de titel van de website en voor componentgroepen (bijvoorbeeld "My Site").
appId De technische naam, zal voor component, config en de namen van de inhoudsomslag, evenals de namen van de cliëntbibliotheek worden gebruikt (b.v. "mysite").
artifactId ${appId} Basis-Maven-artefactverwijzing (bijvoorbeeld "mysite").
groupId Basis-Maven-groep-id (bijvoorbeeld "com.mysite"). Deze waarde moet een geldige Java-pakketnaam.
package ${groupId} Java-bronpakket (bijvoorbeeld "com.mysite").
version 1.0-SNAPSHOT Projectversie (bijvoorbeeld 1.0-SNAPSHOT).
aemVersion cloud AEM (kan cloud for AEM as a Cloud Service; of 6.5.0, of 6.4.4 for Beheerde services van Adobe of op locatie).
sdkVersion latest Wanneer aemVersion=cloud een SDK versie kan worden opgegeven (bijvoorbeeld 2020.02.2265.20200217T222518Z-200130).
includeDispatcherConfig y Bevat een configuratie van de verzender voor cloud of voor AMS/on-premise, afhankelijk van de waarde van aemVersion (kan y of n).
frontendModule general Omvat een vooraf ingebouwd module Webpack die de cliëntbibliotheken (kan) produceert general of none voor gewone locaties; kan angular of react voor een app voor één pagina die het SPA Editor).
language en Taalcode (ISO 639-1) waarmee de inhoudsstructuur wordt gemaakt (bijvoorbeeld en, deu).
country us Landcode (ISO 3166-1) om de inhoudsstructuur te maken op basis van (bijvoorbeeld US).
singleCountry y Omvat een taal-master inhoudsstructuur (kan y, of n).
includeExamples n Bevat een Componentbibliotheek voorbeeldsite (kan y, of n).
includeErrorHandler n Bevat een aangepaste 404-responspagina die globaal is voor de gehele instantie (kan y of n).
includeCommerce n Inclusief CIF Core-componenten afhankelijkheden en genereert overeenkomstige artefacten.
commerceEndpoint Alleen vereist voor CIF. Optioneel eindpunt van de te gebruiken dienst van GraphQL van het handelssysteem (bv. https://hostname.com/grapql).
includeFormscommunications n Inclusief Forms Core-componenten afhankelijkheden, sjablonen, formuliergegevensmodellen, thema's en genereert overeenkomstige artefacten voor Forms Communications-programma's.
includeFormsenrollment n Inclusief Forms Core-componenten afhankelijkheden, sjablonen, formuliergegevensmodellen, thema's en genereert overeenkomstige artefacten voor Forms-inschrijvingsprogramma's.
sdkFormsVersion latest Wanneer aemVersion=cloud en een van includeFormsenrollment=y of includeFormscommunications=ykan een Forms SDK-versie worden opgegeven (bijvoorbeeld 2020.12.17.02).
datalayer y Integratie activeren met Gegevenslaag Adobe-client.
amp n Inschakelen AMP ondersteuning voor gegenereerde projectsjablonen.
enableDynamicMedia n Laat stichting DynamicMedia componenten in de montages van het projectbeleid toe en activeert de eigenschappen van Dynamic Media in het beleid van de component van het Beeld van de Kern.
enableSSR n Optie om SSR voor het front-end project toe te laten
precompiledScripts n Optie naar vooraf compileren de serverscripts van ui.apps en als secundair bundelartefact aan het gebouw koppelen in het ui.apps project. aemVersion moet worden ingesteld op cloud.
includeFormsheadless n Inclusief Forms Core-componenten afhankelijkheden, ui.frontend.react.forms.afen hoofdloze artefacten.

Systeemvereisten

Archetype AEM as a Cloud Service AEM 6,5 Java SE Maven
41 Continu 6.5.7.0+ 8, 11 3.3.9+

Stel uw lokale ontwikkelomgeving in voor as a Cloud Service SDK AEM of voor oudere versies van AEM.

Bekende problemen

Wanneer het lopen op Vensters en het produceren van de dispatcherconfiguratie, zou u in een opgeheven bevelherinnering of Subsysteem van Vensters voor Linux moeten lopen (zie #329).

Als u het archetype uitvoert in de interactieve modus (zonder de -B parameter), kunnen de eigenschappen met standaardwaarden niet worden veranderd, tenzij de definitieve bevestiging wordt verworpen, die dan de vragen door de eigenschappen met standaardwaarden in de vragen te omvatten herhaalt (zie
ARCHETYPE-308 voor meer informatie).

U kunt dit archetype in Eclipse niet gebruiken wanneer het beginnen van een nieuw project met File -> New -> Maven Project sinds het script voor na de generatie archetype-post-generate.groovy wordt niet uitgevoerd vanwege een Eclipse-probleem. Als tussenoplossing kunt u de bovenstaande opdrachtregel gebruiken en daarna in Eclipse File -> Import -> Existing Maven Project.

Meer informatie

Voor meer details over het gebruiken van archetype met inbegrip van zijn voordelen, opties, en hoe zijn modules werken, gelieve te zien Het Archetype-document gebruiken.

Op deze pagina