Cree su primer paquete OSGi

Un paquete OSGi es un archivo Java™ que contiene código Java, recursos y un manifiesto que describe el paquete y sus dependencias. El paquete es la unidad de implementación para una aplicación. Este artículo está dirigido a los desarrolladores que deseen crear un servicio OSGi o un servlet utilizando AEM Forms 6.4 o 6.5. Para crear su primer paquete OSGi, siga los siguientes pasos:

Instalación de JDK

Instale la versión compatible de JDK. He utilizado JDK1.8. Asegúrese de que ha añadido JAVA_HOME en las variables de entorno y está apuntando a la carpeta raíz de su instalación de JDK.
Agregue el %JAVA_HOME%/bin a la ruta

fuente de datos

NOTA

No utilice JDK 15. No es compatible con AEM.

Probar la versión de JDK

Abra una nueva ventana del símbolo del sistema y escriba: java -version. Debería recuperar la versión de JDK identificada por la variable JAVA_HOME

fuente de datos

Instalar Maven

Maven es una herramienta de automatización de compilaciones que se utiliza principalmente para proyectos Java. Siga los siguientes pasos para instalar maven en su sistema local.

  • Cree una carpeta denominada maven en la unidad C
  • Descargue el archivo zip binario
  • Extraiga el contenido del archivo zip en c:\maven
  • Cree una variable de entorno denominada M2_HOME con un valor de C:\maven\apache-maven-3.6.0. En mi caso, la versión mvn es 3.6.0. En el momento de escribir este artículo, la última versión de maven es 3.6.3
  • Añada el %M2_HOME%\bin a la ruta
  • Guarde los cambios
  • Abra un nuevo símbolo del sistema y escriba mvn -version. Debería ver la versión mvn como se muestra en la captura de pantalla siguiente

fuente de datos

Settings.xml

Un archivo Maven settings.xml define valores que configuran la ejecución de Maven de varias maneras. Normalmente, se utiliza para definir una ubicación de repositorio local, servidores de repositorios remotos alternativos e información de autenticación para repositorios privados.

Vaya a C:\Users\<username>\.m2 folder
Extraiga el contenido del archivo settings.zip y colóquelo en la carpeta .m2.

Instalar Eclipse

Instale la última versión de eclipse

Crear el primer proyecto

Arquetipo es un conjunto de herramientas de creación de plantillas de proyecto Maven. Un arquetipo se define como un patrón o modelo original desde el cual se realizan todas las demás cosas del mismo tipo. El nombre se ajusta a como intentamos proporcionar un sistema que proporcione un medio coherente de generar proyectos Maven. El tipo de archivo ayudará a los autores a crear plantillas de proyecto de Maven para los usuarios y les proporcionará los medios para generar versiones parametrizadas de esas plantillas de proyecto.
Para crear su primer proyecto de maven, siga los siguientes pasos:

  • Cree una nueva carpeta denominada aemformsbundles en la unidad C
  • Abra un símbolo del sistema y vaya a c:\aemformsbundles
  • Ejecute el siguiente comando en el símbolo del sistema
  • mvn archetype:generate -DarchetypeGroupId=com.adobe.granite.archetypes -DarchetypeArtifactId=aem-project-archetype -DarchetypeVersion=19

El proyecto Maven se generará de forma interactiva y se le pedirá que proporcione valores a una serie de propiedades como:

Nombre de propiedad Importancia Value
groupId groupId identifica de forma exclusiva el proyecto en todos los proyectos com.learningaemforms.adobe
appsFolderName Nombre de la carpeta que contendrá la estructura del proyecto aprendizaje de aemforms
artifactId artifactId es el nombre del jar sin versión. Si lo creó, puede elegir el nombre que desee con letras minúsculas y sin símbolos extraños. aprendizaje de aemforms
version Si lo distribuye, puede elegir cualquier versión típica con números y puntos (1.0, 1.1, 1.0.1, …). 1.0

Acepte los valores predeterminados de las demás propiedades pulsando la tecla Intro.
Si todo va bien, debería ver un mensaje de éxito de compilación en la ventana de comandos

Crear un proyecto eclipse a partir de su proyecto de maven

Cambie el directorio de trabajo a learningaemforms.
Ejecutar mvn eclipse:eclipse desde la línea de comandos
El comando anterior lee el archivo pom y crea proyectos de Eclipse con metadatos correctos para que Eclipse comprenda los tipos de proyectos, las relaciones, la ruta de clase, etc.

Importar el proyecto en eclipse

Iniciar Eclipse

Vaya a File -> Import y seleccione Existing Maven Projects como se muestra aquí

fuente de datos

Haga clic en Siguiente

Seleccione los c:\aemformsbundles\learningaemforms haciendo clic en el botón Browse

fuente de datos

NOTA

Puede seleccionar importar los módulos adecuados según sus necesidades. Seleccione e importe solo el módulo principal si solo va a crear código Java en el proyecto.

Haga clic en Finish para iniciar el proceso de importación

El proyecto se importa en Eclipse y verá varias carpetas learningaemforms.xxxx

Expanda src/main/java en la carpeta learningaemforms.core. Esta es la carpeta en la que escribirá la mayor parte del código.

fuente de datos

Cree su proyecto

Una vez que haya escrito su servicio OSGi o servlet, deberá crear su proyecto para generar el paquete OSGi que se puede implementar mediante la consola web Felix. Consulte AEMFD Client SDK para incluir el SDK de cliente apropiado en su proyecto de Maven. Deberá incluir el SDK de cliente de FD de AEM en la sección de dependencias de pom.xml del proyecto principal, como se muestra a continuación.

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

Para crear el proyecto, siga los siguientes pasos:

  • Abra la ventana símbolo del sistema
  • Ir a c:\aemformsbundles\learningaemforms\core
  • Ejecute el comando mvn clean install -PautoInstallBundle
    El comando anterior crea e instala el paquete en el servidor de AEM que se ejecuta en http://localhost:4502. El paquete también estará disponible en el sistema de archivos en
    C:\AEMFormsBundles\learningaemforms\core\target y se puede implementar mediante la consola web de Felix

En esta página