Prepararse para desplegar una aplicación DOM virtual de Oracle JET

Introducción

En este tutorial se muestra cómo preparar una aplicación DOM virtual de Oracle JavaScript Extension Toolkit (Oracle JET) para el despliegue.

Puede desplegar la aplicación DOM virtual de Oracle JET, que contiene una recopilación de archivos HTML, TypeScript mediante archivos de sintaxis JSX (TSX) y hojas de estilo en cascada (CSS) en cualquier tipo de servidor web o de aplicación. El método de despliegue depende del tipo de entorno de servidor en el que se ejecute la aplicación.

Para desplegar la aplicación DOM virtual de Oracle JET, puede utilizar el mismo método que utiliza para desplegar cualquier otra interfaz de cliente en su entorno específico.

La aplicación DOM virtual que se crea con el comando del paquete de interfaz de línea de comandos de Oracle JET (npx @oracle/ojet-cli create JET-Virtual-DOM-app --template=basic --vdom) contiene un directorio de archivos de plantilla de script de enlace que puede utilizar para definir nuevos pasos para el proceso de creación. Por ejemplo, puede crear un script de enlace para archivar el directorio /web de la aplicación DOM virtual como un archivo ZIP o como un archivo WAR. Este script after_build se ejecuta después de que finaliza el proceso de creación.

Este tutorial no ilustra los pasos de despliegue que dependen de un entorno y una plataforma específicos.

Objetivos

En este tutorial, aprenderá a archivar el directorio /web de la aplicación DOM virtual como un archivo ZIP o un archivo WAR. También aprenderá a modificar la aplicación DOM virtual para automatizar el archivado como parte del proceso de creación de aplicaciones de Oracle JET.

Requisitos

Tarea 1: Creación del script de enlace after_build

La secuencia de comandos de enlace after_build se crea mediante un archivo de plantilla de secuencia de comandos de enlace proporcionado que se modifica.

  1. Vaya al directorio JET-Virtual-DOM-app/scripts/hooks y abra el archivo de plantilla de script de enlace after_build.js en un editor.

  2. Copie el fragmento de código after-build-js.txt y sustituya el contenido del archivo de plantilla por el fragmento de código copiado.

Tarea 2: Modificación del script de enlace after_build

Modifique el script de enlace para especificar el tipo de archivo de almacenamiento que desea generar para la aplicación DOM virtual. El script de enlace utiliza el mismo método de compresión para crear el archivo ZIP y el archivo WAR. Modifique la secuencia de comandos de enlace after_build para especificar la extensión del archivo de salida, que es .war por defecto.

  1. En el archivo after_build.js, edite el nombre de archivo transferido a fs.createWriteStream() para utilizar la extensión adecuada: .zip o .war.
    • Para generar un archivo WAR, asigne al archivo el nombre my-archive.war. 
      const output = fs.createWriteStream('my-archive.war');
    • Para generar un archivo ZIP, asigne al archivo el nombre my-archive.zip. 
      const output = fs.createWriteStream('my-archive.zip');
  2. Guarde el archivo after_build.js sin cambiar el nombre del archivo. Los nombres de archivo de las secuencias de comandos de enlace del directorio /scripts/hooks corresponden a varios puntos de enlace de compilación de Oracle JET.

Tarea 3: Creación de la aplicación en modo de versión

Al crear la aplicación DOM virtual en modo de versión, el comando build --release sustituye la versión de desarrollo de las bibliotecas y los scripts en el directorio /web/ por versiones minimizadas. Cuando se completa el proceso de creación, la creación ejecuta la secuencia de comandos de enlace after_build y archiva el contenido del directorio /web.

  1. Abra una ventana de terminal, cambie al directorio JET-Virtual-DOM-app e instale el paquete npm archiver.

    npm install archiver

    Esto instala el paquete npm archiver en el proyecto JET-Virtual-DOM-app. El enlace after_build.js utiliza este paquete para archivar la aplicación DOM virtual.

  2. Abra una ventana de terminal, cambie al directorio JET-Virtual-DOM-app y cree la aplicación DOM virtual en modo de versión.

    npx ojet build web --release

    El proceso de creación dispara secuencias de comandos de enlace ubicadas en el directorio /scripts/hooks y tarda unos minutos en terminar.

  3. Espere la confirmación.

    . . .
Running after_build hook.
Success: Build finished.
Files were successfully archived.

  4. Navegue hasta el directorio JET-Virtual-DOM-app y busque el archivo de almacenamiento generado por la secuencia de comandos de enlace. Por ejemplo, si ha modificado el script de enlace after_build para generar un archivo WAR denominado my-archive.war, aparecerá un archivo WAR con ese nombre en el directorio raíz de la aplicación.

    Archivo WAR en el directorio raíz de una aplicación DOM virtual de Oracle JET

Siguiente paso

Este tutorial concluye el módulo Su Primera Aplicación Oracle JET Virtual DOM en esta ruta de aprendizaje sobre la creación de aplicaciones web DOM virtuales.

Puede continuar con el siguiente tutorial de la ruta de aprendizaje, Crear contenedor principal 1 y componentes de contenedor de actividad, en el módulo Componer componentes.

También puede volver a la página principal de la ruta de aprendizaje de DOM virtual para acceder a todos los módulos sobre la creación de aplicaciones de DOM virtuales.

Más recursos de aprendizaje

Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de aprendizaje gratuito en el canal YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en un explorador de Oracle Learning.

Para obtener documentación sobre el producto, visite Oracle Help Center.