Skapa ditt första OSGi-paket
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
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
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ärdetC:\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
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
Klicka på Nästa
Markera c:\aemformsbundles\mysite genom att klicka på knappen Bläddra
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.
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