Använda kärnkomponenter

Senast uppdaterad: 5 maj 2025

Skapat för:

  • Utvecklare
  • Administratör
  • Användare

För att komma igång med Core Components i ditt eget projekt finns det fyra steg, som beskrivs individuellt i avsnitten nedan:

TIPS
För mer omfattande instruktioner om hur du kommer igång från grunden med projektkonfigurationen, kärnkomponenter, redigerbara mallar, klientbibliotek och komponentutveckling kan följande självstudiekurs i flera delar vara av intresse:
Komma igång med AEM Sites - WKND-självstudiekurs
TIPS
Om du använder AEM Project Archetype inkluderas kärnkomponenterna automatiskt i ditt projekt baserat på rekommendationer om bästa praxis för Adobe.

Hämta och installera

En av de drivande idéerna bakom kärnkomponenterna är flexibilitet. Genom att lansera nya versioner av de centrala komponenterna oftare kan Adobe bli mer flexibelt när det gäller att leverera nya funktioner. Utvecklarna kan i sin tur vara flexibla när det gäller vilka komponenter de väljer att integrera i sina projekt och hur ofta de vill uppdatera dem. Detta resulterar i en separat versionsprocess för både AEM och kärnkomponenterna.

Därför avgör installationsstegen om du kör AEM som en molntjänst eller en lokal tjänst.

AEM as a Cloud Service

Det finns inget steg ett! AEM as a Cloud Service har automatiskt den senaste versionen av Core Components. Precis som AEMaaCS erbjuder de senaste funktionerna i AEM håller AEMaaCS automatiskt dig uppdaterad med den senaste versionen av Core Components.

Tänk på några saker när du använder kärnkomponenterna i AEMaaCS:

  • Kärnkomponenterna ingår i /libs.
  • Projektets pipeline genererar varningar i loggen om den innehåller kärnkomponenterna igen som en del av /apps och ignorerar den version som är inbäddad som en del av ditt projekt.
    • I en kommande version, inklusive Core Components igen, kommer pipeline-bygget att misslyckas.
  • Om ditt projekt tidigare innehöll kärnkomponenterna i /apps kan du behöva justera ditt projekt.
  • Även om kärnkomponenterna nu finns i /libs rekommenderar vi inte att du skapar någon övertäckning med samma sökväg i /apps. Proxykomponentmönstretbör användas i stället om någon aspekt av komponenterna behöver anpassas.
  • För att komponenten Innehållsförteckning ska kunna återge sitt innehåll måste ett filter konfigureras i OSGi.

AEM 6.5 och tidigare

Kärnkomponenterna är inte en del av snabbstarten när de startas i produktionsläge (utan exempelinnehåll). Därför är det första steget att hämta det senaste släppta innehållspaketet från GitHub och installera det i dina AEM miljöer.

Det finns flera sätt att automatisera detta, men det enklaste sättet att snabbt installera ett innehållspaket på en instans är att använda pakethanteraren. Se Installera paket. När du dessutom kör en publiceringsinstans måste du replikera paketet till utgivaren. Se Replikera paket.

Skapa proxykomponenter

Av orsaker som förklaras i avsnittet Proxykomponentmönster får inte kärnkomponenter refereras direkt från innehållet. För att undvika det tillhör de alla en dold komponentgrupp ( .core-wcm eller .core-wcm-form), vilket förhindrar att de visas direkt i redigeraren.

Istället måste webbplatsspecifika komponenter skapas, som definierar det komponentnamn och den grupp som ska visas för sidförfattare, och referera var och en till en Core Component som supertyp. Dessa platsspecifika komponenter kallas ibland för"proxykomponenter" eftersom de inte behöver innehålla något och i huvudsak används för att definiera vilken version av en komponent som ska användas för webbplatsen. När du anpassar kärnkomponenterna spelar de här proxykomponenterna dock en viktig roll för markering och logikanpassning.

För varje Core Component som ska användas för en plats måste du:

  1. Skapa en motsvarande proxykomponent i platsens komponentmapp.

    Exempel
    Under /apps/my-site/components skapar du en titelnod av typen cq:Component

  2. Peka på motsvarande Core Component-version med supertypen.

    Exempel
    Lägg till följande egenskap:
    sling:resourceSuperType="core/wcm/components/title/v1/title"

  3. Definiera komponentens grupp, titel och eventuellt beskrivning. Dessa värden är projektspecifika och styr hur komponenten exponeras för författare.

    Exempel
    Lägg till följande egenskaper:

    componentGroup="My Site"
jcr:title="Title"
jcr:description="Section Heading"

Titta till exempel på titelkomponenten för WKND-webbplatsen, som är ett bra exempel på en proxykomponent som är byggd på det sättet.