Instalación Local

Abrir en ChatGPT

Esta sección de la documentación cubrirá los pasos requeridos solo para usuarios que deseen utilizar webforJ para el desarrollo web y/o de aplicaciones con una instancia local de BBj en su máquina. Esta instalación no permitirá que los usuarios contribuyan al código del proyecto webforJ.

info

Este tutorial cubrirá la instalación en un sistema Windows; los pasos de instalación pueden variar para dispositivos Mac/Linux.

La instalación se desglosará en los siguientes pasos:

1. Descarga e instalación de BBj
2. Uso del Administrador de Plugins de BBj para crear tu aplicación
3. Lanzamiento de tu aplicación

Prerrequisitos

Antes de comenzar, asegúrate de haber revisado los prerrequisitos necesarios para configurar y usar webforJ. Esto garantiza que tienes todas las herramientas y configuraciones requeridas en su lugar antes de comenzar tu proyecto.

1. Descarga e instalación de BBj

Mientras sigas este paso, asegúrate de instalar la versión de BBj que corresponde a la misma versión de webforJ.

Este video puede ayudar con la instalación de BBj si necesitas asistencia con la configuración. La sección de instalación del sitio web de BASIS se puede encontrar en este enlace

sugerencia

Se recomienda utilizar la última versión estable de BBj y seleccionar "BBj" de la lista de opciones, sin Barista ni Addon.

2. Instalar y configurar el plugin de webforJ

Una vez que BBj ha sido instalado, se puede acceder al Administrador de Plugins para instalar herramientas necesarias para configurar webforJ. Para empezar, escribe "Plugin Manager" en el menú de inicio o Finder.

Una vez abierto el administrador de plugins, navega a la pestaña "Available Plugins" en la parte superior.

Una vez en esta sección, marca la casilla "Show versions under development"

La entrada DWCJ debería ser ahora visible en la lista de plugins disponibles para descargar. Haz clic en esta entrada en la lista para seleccionarla.

Con la entrada DWCJ seleccionada, haz clic en el botón "Install"

Una vez que el plugin ha terminado de instalarse, haz clic en la pestaña "Installed Plugins" en la parte superior.

Esta pestaña muestra los plugins instalados, que ahora deberían incluir la entrada DWCJ. Haz clic en la entrada dentro de la lista.

Con la entrada DWCJ seleccionada, haz clic en el botón "Configure"

En la ventana que se abre, haz clic en el botón "Enable Maven Remote Install" en la parte inferior izquierda de la ventana.

sugerencia

Alternativamente, navega al directorio bin dentro de tu carpeta bbx y ejecuta el siguiente comando:

./bbj -tIO DWCJ/cli.bbj - enable_remote_install

Debería aparecer un cuadro de diálogo que indique que la instalación remota ha sido habilitada. Haz clic en "OK" para cerrar este diálogo.

3. Usando el proyecto inicial

Una vez que BBj y el plugin requerido de webforJ estén instalados y configurados, puedes crear un nuevo proyecto estructurado desde la línea de comandos. Este proyecto viene con las herramientas necesarias para ejecutar tu primer programa webforJ.

Para crear y estructurar un nuevo proyecto bbj-hello-world, siga estos pasos:

1. Navegar al directorio adecuado: Abra una terminal y muévase a la carpeta donde desea crear su nuevo proyecto.
2. Ejecutar el comando archetype:generate: Use el comando Maven a continuación y personalice groupId, artifactId y version según sea necesario para su proyecto.

Bash/Zsh

mvn -B archetype:generate \
-DarchetypeGroupId=com.webforj \
-DarchetypeArtifactId=webforj-archetype-bbj-hello-world \
-DarchetypeVersion=LATEST \
-DgroupId=org.example \
-DartifactId=my-app \
-Dversion=1.0-SNAPSHOT  \
-DappName=MyApp

PowerShell

mvn -B archetype:generate `
-DarchetypeGroupId="com.webforj" `
-DarchetypeArtifactId="webforj-archetype-bbj-hello-world" `
-DarchetypeVersion="LATEST" `
-DgroupId="org.example" `
-DartifactId="my-app" `
-Dversion="1.0-SNAPSHOT" " `
-DappName="MyApp"

Command Prompt

mvn -B archetype:generate ^
-DarchetypeGroupId="com.webforj" ^
-DarchetypeArtifactId="webforj-archetype-bbj-hello-world" ^
-DarchetypeVersion="LATEST" ^
-DgroupId="org.example" ^
-DartifactId="my-app" ^
-Dversion="1.0-SNAPSHOT" " ^
-DappName="MyApp"

Argumento	Explicación
archetypeGroupId	El ID de grupo del arquetipo es com.webforj para arquetipos webforJ.
archetypeArtifactId	Especifica el nombre del arquetipo a usar.
archetypeVersion	Especifica la versión del arquetipo a usar. Esto garantiza que el proyecto generado sea compatible con una versión específica del arquetipo. Usar LATEST selecciona la versión más reciente disponible.
groupId	Representa el espacio de nombres para el proyecto generado. Típicamente estructurado como un paquete Java, como org.example, y se usa para identificar de manera única su organización o dominio del proyecto.
artifactId	Especifica el nombre del proyecto generado. Este será el nombre del artefacto resultante y la carpeta del proyecto.
version	Define la versión del proyecto generado. Una convención común es MAJOR.MINOR-SNAPSHOT, como 1.0-SNAPSHOT, donde SNAPSHOT indica que el proyecto aún está en desarrollo.
appName	Un parámetro opcional que se puede usar en el archivo POM del proyecto generado. Dependiendo del arquetipo webforJ utilizado, puede utilizarse como título predeterminado para la aplicación.

Después de ejecutar el comando, Maven generará los archivos del proyecto necesarios para ejecutar el proyecto.

4. Lanzando la aplicación

Una vez que se haya hecho esto, ejecuta un mvn install en tu directorio del proyecto. Esto ejecutará el plugin de instalación de webforJ y te permitirá acceder a tu aplicación. Para ver la aplicación, debes ir a la siguiente URL:

http://localhost:YourHostPort/webapp/YourPublishName

Reemplaza YourHostPort con el puerto de host que configuraste con Docker, y YourPublishName se reemplaza por el texto dentro de la etiqueta <publishname> del POM. Si se hizo correctamente, deberías ver tu aplicación renderizada.