Java 环境变量

此部分描述加载 UFT One Java 插件支持的 Java 应用程序时需要设置的环境变量。例如，某些环境变量需要设置为 Java 插件支持类文件夹的路径名。

1. 根据您使用的 Java 环境执行以下步骤:

   • Oracle JDK、OpenJDK 或 Zulu OpenJDK

     将 _JAVA_OPTIONS 环境变量指定如下:

     -Xrunjvmhook -Xbootclasspath/a:"<UFT One 安装文件夹>\bin\java_shared\classes\jasmine.jar

   • IBM Java

     将 IBM_JAVA_OPTIONS 环境变量指定如下:

     -Xbootclasspath/a:"<UFT One 安装文件夹>\bin\java_shared\classes\jasmine.jar

   • IBM Semeru (OpenJ9)

     执行以下某项操作:

     • 将 IBM_JAVA_OPTIONS 环境变量指定如下:

       -Xshareclasses:enableBCI -Xbootclasspath/a:"<UFT One 安装文件夹>\bin\java_shared\classes\jasmine.jar

     • 新建一个名为 OPENJ9_JAVA_OPTIONS 的环境变量并将其设置为 -Xshareclasses:enableBCI。

   上述设置应显示在同一行上（无换行分隔符）。

   备注: 通常，这些变量值由 UFT One 自动设置，您只需验证其正确性即可。另外，如果您出于任何理由需要修改这些变量，请按照以下说明将其恢复为 UFT One 所需的值。

2. 根据您使用的 Java 环境，设置 JAVA_TOOL_OPTIONS 环境变量: 

   Java 版本	变量值
   Oracle Java、Zulu OpenJDK	-agentlib:jvmhook
   IBM Java 1.8 及更高版本/IBM Semeru 8 及更高版本	-agentlib:jvmhook -Dmic.enforce=ibm

   提示: 如果需要，可以通过重命名 _JAVA_OPTIONS/IBM_JAVA_OPTIONS 和 JAVA_TOOL_OPTIONS 环境变量，暂时删除 Java 支持。例如，如果要测试嵌入基于 SWT 或 Eclipse 的应用程序的 ActiveX 控件，则必须删除 Java 支持。

3. 为了使 UFT One 标识 Java 16 或更高版本中的 Java 对象 (使用 Oracle JDK、OpenJDK、Zulu OpenJDK 或 OpenJ9)，您必须在运行 Java 应用程序时指定以下选项:

   • 对于 SWT、Swing 和 AWT 应用程序:

     --add-modules=java.desktop --add-opens java.desktop/sun.awt=ALL-UNNAMED --add-opens java.desktop/sun.awt.image=ALL-UNNAMED --add-opens java.desktop/java.awt=ALL-UNNAMED

   • JavaFX 应用程序:

     --add-modules=java.desktop,javafx.controls --add-opens java.desktop/sun.awt=ALL-UNNAMED --add-opens java.desktop/sun.awt.image=ALL-UNNAMED --add-opens java.desktop/java.awt=ALL-UNNAMED --add-opens javafx.controls/javafx.scene.control.cell=ALL-UNNAMED

   您可以通过以下方式之一指定这些选项: 

   • 在用于运行应用程序的 Java 命令中包含这些选项。

   • 在 JDK_JAVA_OPTIONS 环境变量的值中输入这些选项。请注意，这会影响您在这台计算机上运行的所有 Java 应用程序。

4. 通过使用以下变量定义 Java 应用程序的详细信息，覆盖 Java 选项卡（录制和运行设置对话框） 中“可执行文件”、“命令行”和“工作目录”框中的值:

   选项	变量名称	描述
   可执行文件	EXEPATH_ENV	要打开的可执行文件或批处理文件。
   命令行	CMDLINE_ENV	用于打开文件的命令行。
   工作目录	WORKDIR_ENV	指定命令行或可执行文件指向的文件夹。

-Xbootclasspath/a:C:\PROGRA~2\
OpenText\UNIFIE~1\bin\JAVA_S~1\classes\jasmine.jar