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

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

​ Gedeelde WKND ​ pakket wordt toegevoegd als gebiedsdeel in het ​ WKND- project ​ pom.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 ontwikkelomgeving van AEM ​ of ​ Snelle Milieu van de Ontwikkeling (RDE) ​ opstelling.

Het ​ project van AEM WKND ​ om de derdebundel of jar of pakket toe te voegen en de veranderingen te verifiëren.

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

Het AEM WKND-project klonen en implementeren.

$ 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 de mappenstructuur van all in de module all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install van het AEM WKND-project. 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 het 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 de pom.xml toe als afhankelijkheid in het hoofdbestand my-example-bundle van het AEM WKND-project.

...
<!-- 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 van de module core/pom.xml van de 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 project van AEM WKND gebruikend het volgende bevel op:

$ 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 het milieu RDE of van AEM door de pijpleiding van Cloud Manager in werking te stellen.

Kopieer de OSGi-bundel naar de map all van de module jcr_root/apps/<PROJECT-NAME>-vendor-packages/container/install . Deze stap is nodig om de bundel in een pakket te plaatsen en in te zetten op 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 de mappenstructuur van all in de module all/resource/jar van het AEM WKND-project.

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 het 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 de pom.xml toe als afhankelijkheid in het hoofdbestand my-example-jar van het AEM WKND-project.

...
<!-- 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 van de module core/pom.xml van AEM WKND:

• 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 project van AEM WKND gebruikend het volgende bevel op:

$ 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 het milieu RDE of van AEM door de pijpleiding van Cloud Manager in werking te stellen.

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

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.

Maak een opmerking over of verwijder de ACS AEM Commons-afhankelijkheid van het POM-bestand. Verwijs ​ ACS AEM Commons aan uw AEM Gemaakt project ​ toevoegen om het gebiedsdeel te identificeren.

Kloon de master tak van de ​ ACS AEM Commons bewaarplaats ​ aan uw lokale machine.

Bouw de ACS AEM Commons SNAPSHOT versie 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 de mappenstructuur van all in de module all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install van het AEM WKND-project. 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 project van AEM WKND gebruikend het volgende bevel op:

$ 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 het milieu RDE of van AEM door de pijpleiding van Cloud Manager in werking te stellen.