Artefacten van derden installeren - niet beschikbaar in de openbare Maven-opslagplaats

AEM de Componenten van de Kern WCMbundel wordt toegevoegd als gebiedsdeel in het WKND- projectpom.xml dossier. Hier wordt het bereik provided gebruikt als de AEM WCM Core Components-bundel wordt geleverd door de AEM runtime. Als de bundel niet door AEM runtime wordt verstrekt, zou u het compile werkingsgebied gebruiken en het is het standaardwerkingsgebied.

Gedeelde WKNDpakket wordt toegevoegd als gebiedsdeel in het WKND- projectpom.xml dossier.

De bundel of het pakket wordt verstrekt door een intern team of een derdeverkoper en is niet beschikbaar in de openbare GeMaven bewaarplaats.

Het Java™ jar dossier is geen bundel OSGi en kan of niet beschikbaar in de openbare GeMaven bewaarplaats zijn.

U hebt een functie nodig die nog niet wordt vrijgegeven in de meest recente versie van het pakket van derden dat beschikbaar is in de openbare Maven-opslagruimte. U hebt ervoor gekozen de lokaal gebouwde versie van RELEASE of SNAPSHOT te installeren.

De lokale AEM ontwikkelomgevingof Snelle Milieu van de Ontwikkeling (RDE)opstelling.

Het AEM project WKNDom de derdebundel of de pot of het pakket toe te voegen en de veranderingen te verifiëren.

Stel de lokale ontwikkelomgeving of RDE-omgeving van AEM 6.X of AEM as a Cloud Service (AEMCS) in.

Klonen en implementeren van het AEM WKND-project.

$ git clone git@github.com:adobe/aem-guides-wknd.git
$ cd aem-guides-wknd
$ mvn clean install -PautoInstallPackage

Controleer of de WKND-sitepagina's correct worden weergegeven.

Download en haal het {🔗 dossier 0} my-example-bundle.zip.

Maak in de module all van AEM WKND-project de mappenstructuur van all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install . De map /all/src/main/content bestaat, u hoeft alleen de mappen jcr_root/apps/wknd-vendor-packages/container/install te maken.

Kopieer het my-example-bundle-1.0-SNAPSHOT.jar -bestand uit de uitgepakte target -map naar de bovenstaande all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install -map.

Maak in de module core van AEM WKND-project de SayHello.java Sling servlet @ core/src/main/java/com/adobe/aem/guides/wknd/core/servlet .

package com.adobe.aem.guides.wknd.core.servlet;

import java.io.IOException;

import javax.servlet.Servlet;
import javax.servlet.ServletException;

import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.api.SlingHttpServletResponse;
import org.apache.sling.api.servlets.HttpConstants;
import org.apache.sling.api.servlets.ServletResolverConstants;
import org.apache.sling.api.servlets.SlingSafeMethodsServlet;
import org.osgi.service.component.annotations.Component;
import org.osgi.service.component.annotations.Reference;
import com.example.services.HelloWorldService;

@Component(service = Servlet.class, property = {
    ServletResolverConstants.SLING_SERVLET_PATHS + "=/bin/sayhello",
    ServletResolverConstants.SLING_SERVLET_METHODS + "=" + HttpConstants.METHOD_GET
})
public class SayHello extends SlingSafeMethodsServlet {

        private static final long serialVersionUID = 1L;

        // Injecting the HelloWorldService from the `my-example-bundle` bundle
        @Reference
        private HelloWorldService helloWorldService;

        @Override
        protected void doGet(SlingHttpServletRequest request, SlingHttpServletResponse response) throws ServletException, IOException {
            // Invoking the HelloWorldService's `sayHello` method
            response.getWriter().write("My-Example-Bundle service says: " + helloWorldService.sayHello());
        }
}

Voeg in het hoofdbestand pom.xml van het AEM WKND-project de my-example-bundle toe als een afhankelijkheid.

...
<!-- My Example Bundle -->
<dependency>
    <groupId>com.example</groupId>
    <artifactId>my-example-bundle</artifactId>
    <version>1.0-SNAPSHOT</version>
    <scope>system</scope>
    <systemPath>${maven.multiModuleProjectDirectory}/all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install/my-example-bundle-1.0-SNAPSHOT.jar</systemPath>
</dependency>
...

Hier:

• Het bereik system geeft aan dat de afhankelijkheid niet moet worden opgezocht in de openbare Maven-opslagruimte.
• systemPath is het pad naar het my-example-bundle -bestand in de module all van het AEM WKND-project.
• ${maven.multiModuleProjectDirectory} is een Maven bezit dat aan de wortelfolder van het multi-moduleproject richt.

Voeg in het bestand core/pom.xml van de module core van AEM WKND-project de my-example-bundle als een afhankelijkheid toe.

...
<!-- My Example Bundle -->
<dependency>
    <groupId>com.example</groupId>
    <artifactId>my-example-bundle</artifactId>
</dependency>
...

Bouw en stel het AEM WKND- project op gebruikend het volgende bevel:

$ mvn clean install -PautoInstallPackage

Controleer of de SayHello servlet naar behoren werkt door de URL http://localhost:4502/bin/sayhello in de browser te openen.

Leg bovenstaande wijzigingen vast in de opslagplaats van het AEM WKND-project. Dan verifieer de veranderingen in RDE of AEM milieu door de pijpleiding van Cloud Manager in werking te stellen.

Kopieer de OSGi-bundel naar de map jcr_root/apps/<PROJECT-NAME>-vendor-packages/container/install van de module all . Deze stap is noodzakelijk om de bundel in een pakket te plaatsen en in te voeren aan de AEM instantie.

Werk de pom.xml -bestanden van de basis- en kernmodule bij om de OSGi-bundel toe te voegen als een afhankelijkheid met de system scope en systemPath die naar het bundelbestand wijzen. Deze stap is noodzakelijk om het project te compileren.

Download en haal het {🔗 dossier 0} my-example-jar.zip.

Maak in de module all van AEM WKND-project de mappenstructuur van all/resource/jar .

Kopieer het my-example-jar-1.0-SNAPSHOT.jar -bestand uit de uitgepakte target -map naar de bovenstaande all/resource/jar -map.

Maak in de module core van AEM WKND-project de SayHello.java Sling servlet @ core/src/main/java/com/adobe/aem/guides/wknd/core/servlet .

package com.adobe.aem.guides.wknd.core.servlet;

import java.io.IOException;

import javax.servlet.Servlet;
import javax.servlet.ServletException;

import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.api.SlingHttpServletResponse;
import org.apache.sling.api.servlets.HttpConstants;
import org.apache.sling.api.servlets.ServletResolverConstants;
import org.apache.sling.api.servlets.SlingSafeMethodsServlet;
import org.osgi.service.component.annotations.Component;

import com.my.example.MyHelloWorldService;

@Component(service = Servlet.class, property = {
        ServletResolverConstants.SLING_SERVLET_PATHS + "=/bin/sayhello",
        ServletResolverConstants.SLING_SERVLET_METHODS + "=" + HttpConstants.METHOD_GET
})
public class SayHello extends SlingSafeMethodsServlet {

    private static final long serialVersionUID = 1L;

    @Override
    protected void doGet(SlingHttpServletRequest request, SlingHttpServletResponse response)
            throws ServletException, IOException {

        // Creating an instance of MyHelloWorldService
        MyHelloWorldService myHelloWorldService = new MyHelloWorldService();

        // Invoking the MyHelloWorldService's `sayHello` method
        response.getWriter().write("My-Example-JAR service says: " + myHelloWorldService.sayHello());
    }
}

Voeg in het hoofdbestand pom.xml van het AEM WKND-project de my-example-jar toe als een afhankelijkheid.

...
<!-- My Example JAR -->
<dependency>
    <groupId>com.my.example</groupId>
    <artifactId>my-example-jar</artifactId>
    <version>1.0-SNAPSHOT</version>
    <scope>system</scope>
    <systemPath>${maven.multiModuleProjectDirectory}/all/resource/jar/my-example-jar-1.0-SNAPSHOT.jar</systemPath>
</dependency>
...

Hier:

• Het bereik system geeft aan dat de afhankelijkheid niet moet worden opgezocht in de openbare Maven-opslagruimte.
• systemPath is het pad naar het my-example-jar -bestand in de module all van het AEM WKND-project.
• ${maven.multiModuleProjectDirectory} is een Maven bezit dat aan de wortelfolder van het multi-moduleproject richt.

Breng twee wijzigingen aan in het bestand core/pom.xml van de module core van AEM WKND-project:

• Voeg de my-example-jar toe als afhankelijkheid.

  code language-xml
  ... <!-- My Example JAR --> <dependency> <groupId>com.my.example</groupId> <artifactId>my-example-jar</artifactId> </dependency> ...

• Werk bnd-maven-plugin -configuratie bij om de my-example-jar op te nemen in de OSGi-bundel (aem-guides-wknd.core) die wordt gebouwd.

  code language-xml

  ... <plugin> <groupId>biz.aQute.bnd</groupId> <artifactId>bnd-maven-plugin</artifactId> <executions> <execution> <id>bnd-process</id> <goals> <goal>bnd-process</goal> </goals> <configuration> <bnd><![CDATA[ Import-Package: javax.annotation;version=0.0.0,* <!-- Include the 3rd party jar as inline resource--> -includeresource: \ lib/my-example-jar.jar=my-example-jar-1.0-SNAPSHOT.jar;lib:=true ]]></bnd> </configuration> </execution> </executions> </plugin> ...

Bouw en stel het AEM WKND- project op gebruikend het volgende bevel:

$ mvn clean install -PautoInstallPackage

Controleer of de SayHello servlet naar behoren werkt door de URL http://localhost:4502/bin/sayhello in de browser te openen.

Leg bovenstaande wijzigingen vast in de opslagplaats van het AEM WKND-project. Dan verifieer de veranderingen in RDE of AEM milieu door de pijpleiding van Cloud Manager in werking te stellen.

Kopieer de Java-jar naar de map resource/jar van de module all .

Werk de pom.xml -bestanden van de basis- en kernmodule bij om de Java-jar toe te voegen als een afhankelijkheid met de system scope en systemPath die naar het jar-bestand wijzen.

Noteer of verwijder de ACS AEM de versiegebiedsdelen van Commons uit het POM- dossier. Verwijs ACS AEM Commons aan uw AEM Gemaakt projecttoe om het gebiedsdeel te identificeren.

Kloon de master tak van de ACS AEM de bewaarplaats van Commonsaan uw lokale machine.

Bouw de versie ACS AEM Commons SNAPSHOT gebruikend het volgende bevel:

$mvn clean install

Het lokaal gebouwde pakket bevindt zich @ all/target , er zijn twee .zip-bestanden, het ene dat eindigt met -cloud is bedoeld voor AEM as a Cloud Service en het andere voor AEM 6.X.

Maak in de module all van AEM WKND-project de mappenstructuur van all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install . De map /all/src/main/content bestaat, u hoeft alleen de mappen jcr_root/apps/wknd-vendor-packages/container/install te maken.

Kopieer het lokaal gebouwde pakketbestand (.zip) naar de map /all/src/main/content/jcr_root/apps/mysite-vendor-packages/container/install .

Bouw en stel het AEM WKND- project op gebruikend het volgende bevel:

$ mvn clean install -PautoInstallPackage

Verifieer het geïnstalleerde ACS AEM Commons pakket:

• CRX Package Manager @ http://localhost:4502/crx/packmgr/index.jsp

  

• De OSGi-console @ http://localhost:4502/system/console/bundles

  

Leg bovenstaande wijzigingen vast in de opslagplaats van het AEM WKND-project. Dan verifieer de veranderingen in RDE of AEM milieu door de pijpleiding van Cloud Manager in werking te stellen.