Instalación Local

Abrir en ChatGPT

Esta sección de la documentación cubrirá los pasos requeridos únicamente para los usuarios que deseen usar webforJ para el desarrollo web y/o de aplicaciones con una instancia local de BBj en su máquina. Esta instalación no permitirá a los usuarios contribuir al código base de la fundación webforJ.

info

Esta guía cubrirá la instalación en un sistema Windows; los pasos de instalación pueden variar para dispositivos Mac/Linux.

La instalación se dividirá 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

Requisitos previos

Antes de comenzar, asegúrate de haber revisado los requisitos previos necesarios para configurar y usar webforJ. Esto asegura que tengas todas las herramientas y configuraciones requeridas 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 corresponda a la misma versión de webforJ.

Este video puede ayudarte 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 usar la última versión estable de BBj y seleccionar "BBj" de la lista de opciones, sin Barista o Addon.

2. Instalar y configurar el plugin de webforJ

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

Una vez en esta sección, selecciona la casilla "Mostrar versiones en desarrollo"

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

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

Una vez que el plugin haya terminado de instalarse, haz clic en la pestaña "Plugins instalados" 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 "Configurar"

En la ventana que se abre, haz clic en el botón "Habilitar Instalación Remota de Maven" 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

Un diálogo debería mostrar que la instalación remota ha sido habilitada. Haz clic en "OK" para cerrar este diálogo.

3. Usar 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, sigue estos pasos:

1. Navegar al directorio adecuado: Abre una terminal y muévete a la carpeta donde deseas crear tu nuevo proyecto.
2. Ejecutar el comando archetype:generate: Utiliza el comando Maven a continuación y personaliza el groupId, artifactId y versión según sea necesario para tu 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 del grupo del arquetipo es com.webforj para los arquetipos de webforJ.
archetypeArtifactId	Especifica el nombre del arquetipo a usar.
archetypeVersion	Especifica la versión del arquetipo a utilizar. Esto asegura 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 de Java, como org.example, y se utiliza 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 MAYOR.MENOR-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, se puede utilizar 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. Lanzar la aplicación

Una vez que esto se haya hecho, ejecuta un mvn install en tu directorio de 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 host que configuraste con Docker, y YourPublishName es reemplazado por el texto dentro de la etiqueta <publishname> del POM. Si se hace correctamente, deberías ver tu aplicación renderizada.