Installer des artefacts tiers - non disponibles dans le référentiel Maven public

Le lot AEM WCM Core Components est ajouté en tant que dépendance dans le fichier pom.xml du projet WKND. Ici, la portée provided est utilisée tandis que le lot AEM WCM Core Components est fourni par l’environnement d’exécution AEM. Si le lot n’est pas fourni par l’environnement d’exécution AEM, utilisez alors la portée compile, qui est la portée par défaut.

Le package WKND Shared est ajouté en tant que dépendance dans le fichier pom.xml du projet WKND.

Le lot ou le package est fourni par une équipe interne ou un fournisseur tiers et n’est pas disponible dans le référentiel Maven public.

Le fichier jar Java™ n’est pas un lot OSGi et peut être disponible ou non dans le référentiel Maven public.

Vous avez besoin d’une fonctionnalité qui n’est pas encore publiée dans la dernière version du package tiers disponible dans le référentiel Maven public. Vous avez décidé d’installer la version locale RELEASE ou SNAPSHOT.

Une configuration d’environnement de développement d’AEM local ou d’environnement de développement rapide (RDE).

Le projet AEM WKND pour ajouter le lot ou jar ou package tiers et vérifier les modifications.

Configurez l’environnement de développement local ou l’environnement RDE AEM 6.X ou AEM as a Cloud Service (AEMCS).

Clonez et déployez le projet AEM WKND.

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

Vérifiez que le rendu des pages du site WKND est correct.

Téléchargez et extrayez le fichier my-example-bundle.zip.

Dans le module all du projet WKND AEM, créez la structure de répertoires all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install. Le répertoire /all/src/main/content existe, il suffit de créer les répertoires jcr_root/apps/wknd-vendor-packages/container/install.

Copiez le fichier my-example-bundle-1.0-SNAPSHOT.jar du répertoire target extrait dans le répertoire all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install ci-dessus.

Dans le module core du projet WKND AEM, créez le SayHello.java servlet Sling @ 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());
        }
}

Dans le fichier pom.xml racine du projet WKND AEM, ajoutez le lot my-example-bundle en tant que dépendance.

...
<!-- 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>
...

Ici :

• La portée system indique que la dépendance ne doit pas être recherchée dans le référentiel Maven public.
• systemPath est le chemin d’accès au fichier my-example-bundle dans le module all du projet WKND AEM.
• ${maven.multiModuleProjectDirectory} est une propriété Maven qui pointe vers le répertoire racine du projet multi-module.

Dans le fichier core/pom.xml du module core du projet WKND AEM, ajoutez le lot my-example-bundle en tant que dépendance.

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

Créez et déployez le projet WKND AEM à l’aide de la commande suivante :

$ mvn clean install -PautoInstallPackage

Vérifiez que le servlet SayHello fonctionne comme prévu en accédant à l’URL http://localhost:4502/bin/sayhello dans le navigateur.

Validez les modifications ci-dessus dans le référentiel du projet WKND AEM. Vérifiez ensuite les modifications dans l’environnement RDE ou AEM en exécutant le pipeline Cloud Manager.

Copiez le lot OSGi dans le répertoire jcr_root/apps/<PROJECT-NAME>-vendor-packages/container/install du module all. Cette étape est nécessaire pour mettre en package et déployer le lot vers l’instance AEM.

Mettez à jour les fichiers pom.xml du module racine et principal pour ajouter le lot OSGi en tant que dépendance avec la portée system et systemPath pointant vers le fichier de lot. Cette étape est nécessaire pour compiler le projet.

Téléchargez et extrayez le fichier my-example-jar.zip.

Dans le module all du projet WKND AEM, créez la structure de répertoires all/resource/jar.

Copiez le fichier my-example-jar-1.0-SNAPSHOT.jar du répertoire target extrait dans le répertoire all/resource/jar ci-dessus.

Dans le module core du projet WKND AEM, créez le SayHello.java servlet Sling @ 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());
    }
}

Dans le fichier pom.xml racine du projet WKND AEM, ajoutez my-example-jar en tant que dépendance.

...
<!-- 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>
...

Ici :

• La portée system indique que la dépendance ne doit pas être recherchée dans le référentiel Maven public.
• systemPath est le chemin d’accès au fichier my-example-jar dans le module all du projet WKND AEM.
• ${maven.multiModuleProjectDirectory} est une propriété Maven qui pointe vers le répertoire racine du projet multi-module.

Dans le fichier core/pom.xml du module core du projet WKND AEM, effectuez deux modifications :

• Ajoutez le fichier my-example-jar en tant que dépendance.

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

• Mettez à jour la configuration bnd-maven-plugin pour inclure le fichier my-example-jar dans le lot OSGi (aem-guides-wknd.core) en cours de création.

  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> ...

Créez et déployez le projet WKND AEM à l’aide de la commande suivante :

$ mvn clean install -PautoInstallPackage

Vérifiez que le servlet SayHello fonctionne comme prévu en accédant à l’URL http://localhost:4502/bin/sayhello dans le navigateur.

Validez les modifications ci-dessus dans le référentiel du projet WKND AEM. Vérifiez ensuite les modifications dans l’environnement RDE ou AEM en exécutant le pipeline Cloud Manager.

Copiez le fichier jar Java dans le répertoire resource/jar du module all.

Mettez à jour les fichiers pom.xml du module racine et principal pour ajouter le fichier jar Java en tant que dépendance avec la portée system et systemPath pointant vers le fichier jar.

Commentez ou supprimez la dépendance de version ACS AEM Commons du fichier POM. Pour identifier la dépendance, reportez-vous à la section Ajouter ACS AEM Commons à votre projet Maven AEM.

Clonez la branche master du référentiel ACS AEM Commons sur votre ordinateur local.

Créez la version ACS AEM Commons SNAPSHOT à l’aide de la commande suivante :

$mvn clean install

Le package créé localement est situé sur @ all/target. Il existe deux fichiers .zip : l’un se terminant par -cloud est destiné à AEM as a Cloud Service et l’autre à AEM 6.X.

Dans le module all du projet WKND AEM, créez la structure de répertoires all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install. Le répertoire /all/src/main/content existe, il suffit de créer les répertoires jcr_root/apps/wknd-vendor-packages/container/install.

Copiez le fichier de package (.zip) créé localement dans le répertoire /all/src/main/content/jcr_root/apps/mysite-vendor-packages/container/install.

Créez et déployez le projet WKND AEM à l’aide de la commande suivante :

$ mvn clean install -PautoInstallPackage

Vérifiez le package ACS AEM Commons installé :

• Gestionnaire de packages @ http://localhost:4502/crx/packmgr/index.jsp

  

• La console OSGi @ http://localhost:4502/system/console/bundles

  

Validez les modifications ci-dessus dans le référentiel du projet WKND AEM. Vérifiez ensuite les modifications dans l’environnement RDE ou AEM en exécutant le pipeline Cloud Manager.