DocumentationAEMTutoriels d’AEM Forms

Créer votre premier lot OSGi

Dernière mise à jour : 24 juillet 2026
  • S'applique à :
  • Experience Manager 6.4
  • Experience Manager 6.5

Créé pour :

  • Beginner
  • Developer

Un lot OSGi est un fichier d’archive Java™ qui contient du code Java, des ressources et un manifeste qui décrit le lot et ses dépendances. Un lot est une unité de déploiement d’application. Cet article est destiné aux développeurs et développeuses qui souhaitent créer un service OSGi ou une servlet à l’aide d’AEM Forms 6.4 ou 6.5. Pour créer votre premier lot OSGi, procédez comme suit :

Installer JDK

Installez la version prise en charge de JDK. J’ai utilisé JDK1.8. Assurez-vous que vous avez ajouté JAVA_HOME dans vos variables d’environnement et qu’il pointe vers le dossier racine de votre installation JDK.
Ajoutez %JAVA_HOME%/bin au chemin d’accès

data-source

NOTE
N’utilisez pas JDK 15. Cette version n’est pas prise en charge par AEM.

Tester votre version JDK

Ouvrez une nouvelle fenêtre d’invite de commande et saisissez : java -version. Vous devez recevoir la version JDK identifiée par la variable JAVA_HOME.

data-source

Installer Maven

Maven est un outil d’automatisation de création utilisé principalement dans les projets Java. Pour installer Maven sur votre système local, procédez comme suit.

  • Créez un dossier appelé maven dans votre lecteur C.
  • Téléchargez l’archive zip binaire.
  • Procédez à l’extraction du contenu de l’archive zip dans c:\maven.
  • Créez une variable d’environnement appelée M2_HOME avec la valeur suivante : C:\maven\apache-maven-3.6.0. Dans mon cas, la version mvn est 3.6.0. Au moment de la rédaction du présent article, la dernière version de Maven est la version 3.6.3
  • Ajoutez %M2_HOME%\bin à votre chemin.
  • Enregistrez vos modifications.
  • Ouvrez une nouvelle invite de commande et saisissez mvn -version. La version mvn doit s’afficher, comme illustré dans la copie d’écran ci-dessous.

data-source

Installer Eclipse

Installez la dernière version d’Eclipse.

Créer votre premier projet

L’archétype est une boîte à outils de création de modèles de projet Maven. Un archétype est défini comme un motif ou un modèle d’origine à partir duquel sont fabriquées toutes les autres choses du même type. Le nom correspond car nous essayons de fournir un système qui fournit un moyen cohérent de générer des projets Maven. L’archétype permet aux auteurs de créer des modèles de projet Maven pour les utilisateurs et fournit aux utilisateurs les moyens de générer des versions paramétrées de ces modèles de projet.
Pour créer votre premier projet Maven, procédez comme suit :

  • Créez un dossier appelé aemformsbundles dans votre lecteur C.
  • Ouvrez une invite de commande, puis accédez à c:\aemformsbundles.
  • Exécutez la commande suivante dans l’invite de commande :
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

Une fois la création terminée, vous devriez voir un message de réussite de la création dans la fenêtre de commande.

Créer un projet Eclipse à partir de votre projet Maven

  • Remplacez votre répertoire de travail par mysite
  • Exécutez mvn eclipse:eclipse à partir de la ligne de commande. La commande lit votre fichier pom et crée des projets Eclipse avec les bonnes métadonnées afin qu’Eclipse comprenne les types de projets, les relations, le chemin de classe, etc.

Importer le projet dans Eclipse

Lancez Eclipse.

Accédez à Fichier -> Importer et sélectionnez Projets Maven existants comme illustré ici.

data-source

Cliquez sur Suivant.

Sélectionnez c:\aemformsbundles\mysite en cliquant sur le bouton Parcourir.

data-source

NOTE
Vous pouvez choisir d’importer les modules appropriés en fonction de vos besoins. Sélectionnez et importez le module principal uniquement si vous souhaitez créer du code Java dans votre projet.

Cliquez sur Terminer pour lancer le processus d’import.

Le projet est importé dans Eclipse et vous pouvez voir plusieurs dossiers mysite.xxxx.

Développez src/main/java sous le dossier mysite.core. Il s’agit du dossier dans lequel vous écrivez la plupart de votre code.

data-source

Inclure le SDK client AEMFD

Vous devez inclure le SDK client AEMFD dans votre projet pour tirer parti des différents services fournis avec AEM Forms. Veuillez consulter SDK client AEMFD pour inclure le SDK client approprié dans votre projet Maven. Vous devez inclure le SDK client AEMFD dans la section des dépendances du pom.xml du projet principal, comme illustré ci-dessous.

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

Pour créer votre projet, veuillez procéder comme suit :

  • Ouvrez la fenêtre d’invite de commande.
  • Accédez à c:\aemformsbundles\mysite\core.
  • Exécuter la commande mvn clean install -PautoInstallBundle
    La commande ci-dessus crée et installe le lot dans le serveur AEM s’exécutant sur http://localhost:4502. Le lot est également disponible sur le système de fichiers à l’adresse
    C:\AEMFormsBundles\mysite\core\target et peut être déployé à l’aide de la console web Felix.

Étapes suivantes

Créer un service OSGi

recommendation-more-help
experience-manager-learn-help-forms