Basiscomponenten ontwikkelen developing-core-components
Wanneer moet u de kerncomponenten gebruiken? when-to-use-the-core-components
Aangezien de Componenten van de Kern allen-nieuw zijn, en veelvoudige voordelen aanbieden, wordt het geadviseerd voor nieuwe AEM projecten om hen te gebruiken. Voor bestaande projecten zou een migratie deel moeten uitmaken van een grotere projectinspanning, bijvoorbeeld een herbranding of het totale refactoring.
Daarom doet de Adobe de volgende aanbevelingen:
- Nieuwe Projecten
De nieuwe projecten zouden altijd moeten proberen om de Componenten van de Kern te gebruiken. Als de Componenten van de Kern niet direct kunnen worden gebruikt of uitgebreidom aan projectvereisten te voldoen, dan creeer een douanecomponent na de componentenarchitectuur die in kerncomponenten wordt vermeld. Behalve waar anders niet mogelijk, vermijd het gebruiken van de stichtingscomponenten. - Bestaande Projecten
De aanbeveling houdt gebruikend de stichtingscomponenten, tenzij een plaats of componentenrefactoring wordt gepland.
Aangezien zij zeer wijd door de meeste bestaande projecten worden gebruikt, zullen de stichtingscomponenten blijven worden gesteund. - Nieuwe Componenten van de Douane
Beoordeel als een bestaande Component van de Kernkan worden aangepast.
Als niet, aanbeveling een nieuwe douanecomponent na de Richtlijnen van de Componentmoet bouwen. - Bestaande Componenten van de Douane
Als uw componenten zoals verwacht werken, dan houd hen zoals zij zijn.
Als dat niet het geval is, raadpleegt u "Nieuwe aangepaste componenten" hierboven.
Hoe te met de Componenten van de Kern Succes how-to-succeed
De kerncomponenten zijn krachtig, flexibel en gebruiksvriendelijk. na een paar zeer belangrijke richtlijnenzal ervoor zorgen dat uw project met de Componenten van de Kern een succes is.
Migreren naar de kerncomponenten
Elk nieuw project moet worden geïmplementeerd met Core Components. Nochtans zullen de bestaande projecten gewoonlijk uitgebreide implementaties van de Componenten van de Stichting hebben.
Migreren van stichtingscomponenten from-foundation
Een grotere inspanning op een bestaand project (bijvoorbeeld rebranding of het algemene refactoring) biedt vaak een kans om aan de Componenten van de Kern te migreren. Om deze migratie te vergemakkelijken, heeft Adobe een aantal migratiehulpmiddelen verstrekt om de goedkeuring van de Core Components en de recentste AEM technologie aan te moedigen.
de Hulpmiddelen van de Modernisering van de AEMstaan voor de gemakkelijke omzetting van toe:
- Statische sjablonen converteren naar bewerkbare sjablonen
- Ontwerpconfiguraties omzetten naar beleid
- Elementaire componenten omzetten naar kerncomponenten
- De klassieke interface converteren naar een interface met aanraakbediening
Voor verdere informatie over het gebruik van deze hulpmiddelen, zie hun documentatie.
Migratie via Verplaatsen naar AEM as a Cloud Service via-aemaacs
Omdat AEM as a Cloud Service automatisch de nieuwste versie van de Core Components ontvangt, moet u elke afhankelijkheid van de Core Components in uw project pom.xml
-bestand verwijderen wanneer u van een installatie op locatie AEM de toepassing overschakelt.
Uw proxycomponenten werken nog steeds zoals voorheen, omdat proxy's verwijzen naar het vereiste supertype en het supertekstpad heeft de versie erin. Op deze manier, eenvoudig het verwijderen van de gebiedsdelen laat de Componenten van de Kern toe om in AEMaaCS te werken enkel zoals zij op-gebouw deden.
Net als bij elk ander AEMaaCS-project moet u ook een afhankelijkheid toevoegen aan de AEM SDK-jar. Dit is niet specifiek voor de Core Components, maar is vereist.
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
</dependency>
Zie het document AEM de Structuur van het Projectvoor meer informatie over projecten AEMaaCS.
Ondersteuning van kerncomponenten core-component-support
De Componenten van de kern zijn een integraal deel van AEM en gesteund zoals is, onder de zelfde voorwaarden alsof zij als deel van Quickstart werden geleverd.
Net als andere AEM productfuncties is de algemene regel: Componenten worden eerst aangekondigd te worden vervangen en de oudste verwijderd voor de volgende AEM. Dit geeft klanten minstens één versiecyclus om naar de nieuwe versie van de component te bewegen, alvorens zijn steun te laten vallen.
In de versie van elke component worden duidelijk de AEM versies vermeld die worden ondersteund. Wanneer de steun voor een versie van AEM beëindigt, dan ook de steun van de Componenten van de Kern voor die versie van AEM.
Voor details over de steun van componentenaanpassingen, zie de Aanpassende pagina van de Componenten van de Kern.
Technische mogelijkheden technical-capabilities
De volgende lijst geeft een overzicht van de verschillen tussen kerncomponenten en stichtingscomponenten.
Voor details over hun auteursmogelijkheden en opties om hen pre-configureerbaar te maken, verwijzen naar de auteurspagina over hen.
Componentlijst component-list
De volgende lijst maakt een lijst van de beschikbare Componenten van de Kern, die met hun API verbinden, en wijst op welke stichtingscomponenten zij vervangen.
/libs/foundation/components/page /libs/wcm/foundation/components/page
/libs/foundation/components/text /libs/foundation/components/table /libs/wcm/foundation/components/text
/libs/foundation/components/image /libs/foundation/components/adaptiveimage /libs/foundation/components/logo /libs/foundation/components/mobileimage /libs/foundation/components/mobilelogo /libs/wcm/foundation/components/image
/libs/foundation/components/list /libs/foundation/components/mobilelist /libs/wcm/foundation/components/list
/libs/foundation/components/form/start /libs/foundation/components/form/end
/libs/foundation/components/form/text /libs/foundation/components/form/password
/libs/foundation/components/form/checkbox /libs/foundation/components/form/radio /libs/foundation/components/form/dropdown
/libs/foundation/components/topnav /libs/foundation/components/mobiletopnav
/libs/foundation/components/search
-
/libs/foundation/components/carousel
/libs/cq/experience-fragments/editor/components/experiencefragment
Upgrade van kerncomponenten upgrade-of-core-components
Een voordeel van versioned componenten is dat het toestaat om de migratie aan een nieuwe AEM versie van de migratie aan nieuwe componentenversies te scheiden. Als er nieuwe componentversies beschikbaar zijn, is het bovendien mogelijk om elke component afzonderlijk naar de nieuwe versie te migreren.
Migraties naar een nieuwe AEM hebben geen invloed op de werking van de Core Components, op voorwaarde dat de versies ervan ook ondersteuning bieden voor de nieuwe AEM die wordt gemigreerd naar. De aanpassingen die aan de Componenten van de Kern worden aangebracht zouden niet of moeten worden beïnvloed, zolang zij geen APIs gebruiken die zijn afgekeurd ofverwijderd.
De migraties aan nieuwe versies van de Componenten van de Kern zullen niet beïnvloeden hoe de component ook werkt, maar de nieuwe eigenschappen zouden aan paginaauteurs kunnen worden geïntroduceerd, die één of andere configuratie door een malplaatjeredacteur zouden kunnen vereisen, voor het geval dat het standaardgedrag niet wordt gewenst. De aanpassingen nochtans zouden moeten worden aangepast, voor meer details zie Aanpassend de pagina van de Componenten van de Kern.