DokumentationAEMSjälvstudiekurser om AEMSjälvstudiekurser om AEM Forms

Skapa ditt första OSGi-paket

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Nybörjare
  • Utvecklare

Ett OSGi-paket är en Java™-arkivfil som innehåller Java-kod, resurser och ett manifest som beskriver paketet och dess beroenden. Paketet är en distributionsenhet för ett program. Den här artikeln är avsedd för utvecklare som vill skapa en OSGi-tjänst eller en servett med AEM Forms 6.4 eller 6.5. Så här skapar du ditt första OSGi-paket:

Installera JDK

Installera den version av JDK som stöds. Jag har använt JDK1.8. Kontrollera att du har lagt till JAVA_HOME i dina miljövariabler och pekar på rotmappen för JDK-installationen.
Lägg till %JAVA_HOME%/bin i sökvägen

datakälla

NOTE
Använd inte JDK 15. Det stöds inte av AEM.

Testa JDK-versionen

Öppna ett nytt kommandotolkfönster och skriv: java -version. Du bör återställa den version av JDK som identifieras av variabeln JAVA_HOME

datakälla

Installera Maven

Maven är ett automatiserat byggverktyg som främst används för Java-projekt. Följ de här stegen för att installera maven på din lokala dator.

  • Skapa en mapp med namnet maven i C-enheten
  • Hämta det binära zip-arkivet
  • Extrahera innehållet i zip-arkivet till c:\maven
  • Skapa en miljövariabel med namnet M2_HOME och värdet C:\maven\apache-maven-3.6.0. I mitt fall är versionen mvn 3.6.0. När den här artikeln skrivs är den senaste versionen av maven 3.6.3
  • Lägg till %M2_HOME%\bin i din sökväg
  • Spara ändringarna
  • Öppna en ny kommandotolk och skriv in mvn -version. Du bör se mvn-versionen som visas på skärmbilden nedan

datakälla

Installera Eclipse

Installera den senaste versionen av eclipse

Skapa ditt första projekt

Arketype är en Maven-projektmallverktygslåda. En arkityp definieras som ett ursprungligt mönster eller en modell från vilken alla andra saker av samma typ görs. Namnet passar ihop med att vi försöker skapa ett system som ger ett konsekvent sätt att generera Maven-projekt. Arketype hjälper författare att skapa Maven-projektmallar för användare och ger användarna möjlighet att generera parametriserade versioner av dessa projektmallar.
Så här skapar du ditt första maven-projekt:

  • Skapa en ny mapp med namnet aemformsbundles i C-enheten
  • Öppna en kommandotolk och navigera till c:\aemformsbundles
  • Kör följande kommando i kommandotolken
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=36 -D appTitle="My Site" -D appId="mysite" -D groupId="com.mysite" -D aemVersion=6.5.13

När du är klar visas ett meddelande om att bygget lyckades i kommandofönstret

Skapa förmörkande projekt från ditt maven-projekt

  • Ändra arbetskatalogen till mysite
  • Kör mvn eclipse:eclipse från kommandoraden. Kommandot läser din pom-fil och skapar Eclipse-projekt med korrekta metadata så att Eclipse förstår projekttyper, relationer, klassökväg osv.

Importera projektet till förmörkning

Starta Eclipse

Gå till Arkiv -> Importera och välj Befintliga Maven-projekt så som visas här

datakälla

Klicka på Nästa

Markera c:\aemformsbundles\mysite genom att klicka på knappen Bläddra

datakälla

NOTE
Du kan välja att importera lämpliga moduler beroende på dina behov. Välj och importera endast kärnmodulen om du bara ska skapa Java-kod i ditt projekt.

Klicka på Slutför för att starta importprocessen

Projektet importeras till Eclipse och du ser ett antal mysite.xxxx mappar

Expandera src/main/java under mappen mysite.core. Det här är den mapp där du skriver större delen av koden.

datakälla

Inkludera AEMFD-klient-SDK

Du måste inkludera AEMFD-klientens SDK i ditt projekt för att kunna utnyttja olika tjänster som medföljer AEM Forms. Se AEMFD Client SDK för att inkludera rätt klient-SDK i ditt Maven-projekt. Du måste inkludera AEM FD-klient-SDK i beroendeavsnittet för pom.xml i kärnprojektet enligt nedan.

<dependency>
    <groupId>com.adobe.aemfd</groupId>
    <artifactId>aemfd-client-sdk</artifactId>
    <version>6.0.122</version>
</dependency>

Så här skapar du ditt projekt:

  • Öppna kommandotolkfönstret
  • Navigera till c:\aemformsbundles\mysite\core
  • Kör kommandot mvn clean install -PautoInstallBundle
    Kommandot ovan skapar och installerar paketet på den AEM servern som körs på http://localhost:4502. Paketet finns också i filsystemet på
    C:\AEMFormsBundles\mysite\core\target och kan distribueras med webbkonsolen Felix

Nästa steg

Skapa OSGi-tjänst

recommendation-more-help
8de24117-1378-413c-a581-01e660b7163e