Preparati a distribuire un'applicazione Oracle JET Virtual DOM

Introduzione

Questa esercitazione descrive come preparare un'applicazione DOM virtuale Oracle JavaScript Extension Toolkit (Oracle JET) per la distribuzione.

È possibile distribuire l'applicazione DOM virtuale di Oracle JET, che contiene una raccolta di file HTML, TypeScript utilizzando la sintassi JSX (TSX) e i file CSS (Cascading Style Sheets) in qualsiasi tipo di server Web o applicazione. Il metodo di distribuzione dipende dal tipo di ambiente server in cui viene eseguita l'applicazione.

Per distribuire l'applicazione DOM virtuale di Oracle JET, è possibile utilizzare lo stesso metodo utilizzato per distribuire qualsiasi altra interfaccia client nell'ambiente specifico.

L'applicazione DOM virtuale creata con il comando del package dell'interfaccia della riga di comando di Oracle JET (npx @oracle/ojet-cli create JET-Virtual-DOM-app --template=basic --vdom) contiene una directory di file modello di script di hook che è possibile utilizzare per definire nuovi passi per il processo di build. Ad esempio, è possibile creare uno script di hook per archiviare la directory /web dell'applicazione DOM virtuale come file ZIP o come file WAR. Questo script after_build viene eseguito al termine del processo di creazione.

Questa esercitazione non illustra i passi di distribuzione che dipendono da un ambiente e da una piattaforma specifici.

Obiettivi

In questo tutorial, imparerai come archiviare la directory /web dell'app DOM virtuale come file ZIP o file WAR. Viene inoltre illustrato come modificare l'applicazione DOM virtuale per automatizzare l'archiviazione nell'ambito del processo di creazione dell'applicazione Oracle JET.

Prerequisiti

Task 1: Creazione dello script di hook after_build

Per creare lo script di hook after_build, utilizzare un file di modello di script di hook fornito.

  1. Passare alla directory JET-Virtual-DOM-app/scripts/hooks e aprire il file del modello di script di hook after_build.js in un editor.

  2. Copiare lo snippet di codice after-build-js.txt e sostituire il contenuto del file modello con lo snippet di codice copiato.

Task 2: Modifica dello script di hook di after_build

Modificare lo script di hook per specificare il tipo di file di archivio che si desidera generare per l'applicazione DOM virtuale. Lo script hook utilizza lo stesso metodo di compressione per creare il file ZIP e il file WAR. Lo script dell'hook after_build viene modificato per specificare l'estensione del file di output, ovvero .war per impostazione predefinita.

  1. Nel file after_build.js modificare il nome del file passato a fs.createWriteStream() per utilizzare l'estensione appropriata: .zip o .war.
    • Per generare un file WAR, denominare il file my-archive.war. 
      const output = fs.createWriteStream('my-archive.war');
    • Per generare un file ZIP, denominare il file my-archive.zip. 
      const output = fs.createWriteStream('my-archive.zip');
  2. Salvare il file after_build.js senza modificare il nome del file. I nomi file degli script di hook nella directory /scripts/hooks corrispondono a vari punti di hook della build di Oracle JET.

Task 3: Creare l'applicazione in modalità di rilascio

Quando si crea l'applicazione DOM virtuale in modalità release, il comando build --release sostituisce la versione di sviluppo delle librerie e degli script nella directory /web/ con versioni minificate. Al termine del processo di creazione, la build esegue quindi lo script di hook after_build e archivia il contenuto della directory /web.

  1. Aprire una finestra di terminale, passare alla directory JET-Virtual-DOM-app e installare il pacchetto npm archiver.

    npm install archiver

    In questo modo viene installato il pacchetto npm archiver nel progetto JET-Virtual-DOM-app. L'hook after_build.js utilizza questo pacchetto per archiviare l'applicazione DOM virtuale.

  2. Aprire una finestra di terminale, passare alla directory JET-Virtual-DOM-app e creare l'applicazione DOM virtuale in modalità di rilascio.

    npx ojet build web --release

    Il processo di creazione attiva gli script di hook presenti nella directory /scripts/hooks e richiede alcuni minuti per essere completato.

  3. Attendere la conferma.

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

  4. Andare alla directory JET-Virtual-DOM-app e individuare il file di archivio generato dallo script di hook. Ad esempio, se si modifica lo script di hook after_build per generare un file WAR denominato my-archive.war, nella directory root dell'applicazione verrà visualizzato un file WAR con tale nome.

    File WAR nella directory radice di un'applicazione DOM virtuale di Oracle JET

Passo successivo

Questa esercitazione conclude il modulo Your First Oracle JET Virtual DOM App in questo percorso di apprendimento sulla creazione di applicazioni Web DOM virtuali.

È possibile passare all'esercitazione successiva nel percorso di apprendimento Crea container padre 1 e componenti contenitore attività nel modulo Componi componenti.

Puoi anche tornare alla pagina principale del percorso di apprendimento DOM virtuale per accedere a tutti i moduli sulla creazione di app DOM virtuali.

Altre risorse di apprendimento

Esplora altri laboratori su docs.oracle.com/learn o accedi a più contenuti di formazione gratuiti sul canale YouTube di Oracle Learning. Inoltre, visitare education.oracle.com/learning-explorer per diventare Oracle Learning Explorer.

Per la documentazione del prodotto, visitare Oracle Help Center.