准备部署 Oracle JET 虚拟 DOM 应用程序

简介

此教程演示如何准备用于部署的 Oracle JavaScript Extension Toolkit (Oracle JET) 虚拟 DOM 应用程序。

可以将 Oracle JET 虚拟 DOM 应用程序（包含 HTML 集合、使用 JSX 语法 (TSX) 的 TypeScript 文件和级联样式表 (CSS) 文件）部署到任何类型的 Web 或应用程序服务器。部署方法取决于应用程序运行的服务器环境的类型。

要部署 Oracle JET 虚拟 DOM 应用程序，您可以使用与在特定环境中部署任何其他客户端接口相同的方法。

如果通常将应用程序部署为 ZIP 文件，则可以压缩虚拟 DOM 应用程序的 /web 目录并遵循标准部署过程。
如果通常将应用程序部署为 WAR 文件，则在生成 /web 目录的归档文件之前，您可能还需要修改虚拟 DOM 应用程序。例如，要创建 .war 文件，需要包括一个包含 web.xml 配置文件的 /WEB-INF 目录。

使用 Oracle JET 命令行界面软件包 (npx @oracle/ojet-cli create JET-Virtual-DOM-app --template=basic --vdom) 中的命令创建的虚拟 DOM 应用程序包含挂钩脚本模板文件的目录，可用于为构建过程定义新步骤。例如，可以创建挂钩脚本，将虚拟 DOM 应用程序 /web 目录归档为 ZIP 文件或 WAR 文件。此 after_build 脚本在构建过程完成后运行。

本教程没有说明依赖于特定环境和平台的部署步骤。

目标

在本教程中，您将学习如何将虚拟 DOM 应用程序的 /web 目录归档为 ZIP 文件或 WAR 文件。还将学习如何修改虚拟 DOM 应用程序，以便在 Oracle JET 应用程序构建过程中自动归档。

Prerequisites

设置为创建包括 Node.js 安装的 Oracle JET 虚拟 DOM 应用程序的开发环境
完成此学习路径中的上一个教程，向 Oracle JET 虚拟 DOM 应用程序添加单元测试
熟悉环境的部署实践

任务 1：创建 after_build 挂钩脚本

可以使用您修改的提供的挂钩脚本模板文件创建 after_build 挂钩脚本。

导航到 JET-Virtual-DOM-app/scripts/hooks 目录并在编辑器中打开 after_build.js 挂钩脚本模板文件。
复制 after-build-js.txt 代码片段并将模板文件的内容替换为复制的代码片段。

任务 2：修改 after_build 挂钩脚本

修改挂钩脚本以指定要为虚拟 DOM 应用程序生成的归档文件的类型。挂钩脚本使用相同的压缩方法来创建 ZIP 文件和 WAR 文件。您可以修改 after_build 挂钩脚本以指定输出文件的扩展名，缺省情况下为 .war。

在 after_build.js 文件中，编辑传递给 fs.createWriteStream() 的文件名，以使用相应的扩展名：.zip 或 .war。
- 要生成 WAR 文件，请将文件命名为 my-archive.war。
```
const output = fs.createWriteStream('my-archive.war');
```
- 要生成 ZIP 文件，请将文件命名为 my-archive.zip。
```
const output = fs.createWriteStream('my-archive.zip');
```
保存 after_build.js 文件而不更改文件名。/scripts/hooks 目录中挂钩脚本的文件名对应于各种 Oracle JET 构建挂钩点。

任务 3：在发布模式下构建应用程序

在发行版模式下构建虚拟 DOM 应用程序时，build --release 命令将 /web/ 目录中库和脚本的开发版本替换为最小版本。构建过程完成后，构建将执行 after_build 挂钩脚本并归档 /web 目录的内容。

打开终端窗口，转到 JET-Virtual-DOM-app 目录，然后安装 archiver npm 软件包。
```
npm install archiver
```
这将在 JET-Virtual-DOM-app 项目中安装 archiver npm 软件包。after_build.js 挂钩使用此软件包归档虚拟 DOM 应用程序。
打开终端窗口，转到 JET-Virtual-DOM-app 目录，然后以发行版模式构建虚拟 DOM 应用程序。
```
npx ojet build web --release
```
构建过程会触发位于 /scripts/hooks 目录中的挂钩脚本，并需要几分钟时间才能完成。

等待确认。

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

导航到 JET-Virtual-DOM-app 目录并找到挂钩脚本生成的归档文件。例如，如果修改了 after_build 挂钩脚本以生成名为 my-archive.war 的 WAR 文件，则应用程序根目录中将显示具有该名称的 WAR 文件。

后续步骤

本教程将结束本学习路径中有关构建虚拟 DOM Web 应用程序的模块您的第一个 Oracle JET 虚拟 DOM 应用程序。

您可以在编写组件模块的学习路径创建父容器 1 和活动容器组件中继续下一教程。

您还可以返回到虚拟 DOM 学习路径的主页，以访问有关构建虚拟 DOM 应用程序的所有模块。