Java Add-in

このトピックでは,Internet Explorer,Mozilla Firefox,Java Web Start,アプレットビューアなどの環境,およびスタンドアロンの Java アプリケーションで Java ユーザ・インタフェース・オブジェクト(コントロール)のテストのために使用される OpenText Functional Testing の Java Add-in を紹介します。

Java Add-in のサポート・リファレンス

Java Add-in では,Java アプリケーションでオブジェクトをテストするときに使用できるユーザ定義の Java テスト・オブジェクト,メソッド,およびプロパティが提供されます。

詳細については,Object Model Referenceの「Java」セクションを参照してください。

ヒント: OpenText Functional Testing の初期状態でコントロールがサポートされない場合は,独自のサポートを開発してください。詳細については,Java Add-in Extensibilityを参照してください。

詳細については,次を参照してください。

先頭に戻る

Java Add-in の前提条件

次の表に,OpenText Functional Testing を使用して Java アプリケーションをテストする際に必要になる可能性のある前提条件を示します。

前提条件 説明

アプリケーションを開く

OpenText Functional Testing の起動後に Java アプリケーションを開けない場合,メモリ断片化の問題が発生している可能性があります。メモリ設定を確認しメモリの問題を参照してください。

Web ブラウザでの Java アプレットのテスト

Web ブラウザで Java アプレットをテストするときに,テストに Web テスト・オブジェクトに対する操作が含まれている場合は,Web Add-inJava Add-in をロードする必要があります。

このような場合は,[記録と実行環境設定]ダイアログ・ボックスの[Web]タブを使用して,記録と実行環境の設定を指定します。

注:Firefox での Java アプレットのテストはサポートされなくなりました。

アプリケーションに必要なすべての Java モジュールを含める

標準設定で含まれていない Java モジュールがアプリケーションに必要な場合は,アプリケーションの実行に使用するコマンドに関連するモジュールを含めて,開くようにしてください。

start コマンドに以下の行を含めます。

--add-modules={アプリケーションに必要なすべてのモジュール} --add-opens {必要に応じてモジュールのオープンを指定}

Java 16 以降でのオブジェクト認識(AWT,Swing,SWT)

OpenText Functional Testing が,Java 16 以降の Java オブジェクト(Oracle JDK,OpenJDK,または Zulu OpenJDK を使用)を識別するには,Java AWT,Swing,SWT アプリケーションの実行時に,次のモジュールを含めて,開く必要があります。

--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

これらのオプションは,次のいずれかの方法で指定できます。 

  • アプリケーションの実行に使用する Java コマンドにオプションを含めます。

  • JDK_JAVA_OPTIONS 環境変数の値にオプションを入力します。これは,このマシンで実行するすべての Java アプリケーションに影響することに注意してください。

注:JavaFX アプリケーションを操作する場合は,代わりに JavaFX アプリケーションを参照してください。

先頭に戻る

Java Add-in の設定

次の表は,Java テストに関連する OpenText Functional Testing 設定オプションの場所を示しています。

オプション 説明
OpenText Functional Testing オプション

Java]表示枠を使用。
GUI テストが開いていることを確認し,[ツール]>[オプション]>[GUI テスト]タブ>[Java]ノードを選択します。

記録と実行環境設定

Java]タブを使用。
[記録]>[記録と実行環境設定]

詳細については,[Java]タブ([記録と実行環境設定]ダイアログ・ボックス)を参照してください。

テストの設定

Java]表示枠を使用。
[ファイル]>[設定]>[Java]ノード)。

詳細については,[Java]表示枠([テストの設定]/[ビジネス コンポーネントの設定]ダイアログ・ボックス / [アプリケーション領域]の[追加設定]表示枠)を参照してください。

ActiveScreen キャプチャのカスタム設定

Java]セクションを使用。
[ツール]>[オプション]>[GUI テスト]タブ>[ActiveScreen]ノード>[カスタム レベル])

詳細については,[ActiveScreen]表示枠([オプション]ダイアログ・ボックス>[GUI テスト]タブ)を参照してください。

アプリケーション領域の[追加設定]

Java]表示枠を使用。
アプリケーション領域ウィンドウ内で,[追加設定]をクリックし,サイドバーで[Java]を選択します。

ビジネス・コンポーネントの場合,この表示枠に表示される設定は読み取り専用です。ビジネス・コンポーネントの[Java]表示枠の設定を変更するには,関連するアプリケーション領域を開き,アプリケーション領域の[追加設定]>[Java]表示枠を使用します。

詳細については,[Java]表示枠([テストの設定]/[ビジネス コンポーネントの設定]ダイアログ・ボックス / [アプリケーション領域]の[追加設定]表示枠)を参照してください。

先頭に戻る

JavaFX アプリケーション

JavaFX アプリケーションを使用する場合は,jre8_u60 以上を使用することをお勧めします。

注: Java 8 を使用している場合は,Java のバージョンが 8.0.1010.13 以上であることを確認してください。

Java 11 以降:OpenText Functional Testing が Java オブジェクトを識別するには,アプリケーションを実行しているコンピュータで次の手順を実行します。

  1. Gluon サイトから JavaFX モジュールをダウンロードして,ローカルに保存します。

    注意:JavaFX モジュールを格納するパスにスペースが含まれていないことを確認してください。

  2. 次の環境変数を設定します。

    PATH_TO_FX = <JavaFX モジュールの場所>\lib

  3. パスに %PATH_TO_FX% を追加します。

    個別に行うことも,JavaFX アプリケーションの実行時に次のオプションを追加することもできます。

    --module-path="%PATH_TO_FX%"

  4. JavaFX アプリケーションの実行時に,以下のモジュールとパッケージを含めます。

    注: ここに表示されているモジュール・パスを設定する構文は,start javaw コマンドでの設定に適用されます。

    Java 11 ~ 15:

    --module-path="%PATH_TO_FX%" --add-modules=javafx.controls,javafx.fxml,javafx.base,javafx.swing,javafx.media --add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED --add-opens javafx.base/com.sun.javafx.event=ALL-UNNAMED --add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED --add-opens javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED --add-opens javafx.base/javafx.event=ALL-UNNAMED --add-opens javafx.graphics/javafx.stage=ALL-UNNAMED --add-opens javafx.graphics/javafx.scene=ALL-UNNAME

    Java 16 以降:

    --module-path="%PATH_TO_FX%" --add-modules=javafx.controls,javafx.fxml,javafx.base,javafx.swing,javafx.media,java.desktop --add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED --add-opens javafx.base/com.sun.javafx.event=ALL-UNNAMED --add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED --add-opens javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED --add-opens javafx.base/javafx.event=ALL-UNNAMED --add-opens javafx.graphics/javafx.stage=ALL-UNNAMED --add-opens javafx.graphics/javafx.scene=ALL-UNNAMED --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 コマンドに add-modules および add-opens オプションを含めます。

start javaw --module-path="%PATH_TO_FX%" --add-modules={関連モジュール} --add-opens {モジュールごとの関連パッケージ} -jar <Application_Name>.jar

 

バッチ・ファイル

コマンド・ラインを使用する代わりに,バッチ・ファイルからアプリケーションを起動します。

アプリケーションの.jar ファイルを含むフォルダに,次のコマンドを含む .bat ファイルを作成します。 

start javaw --module-path="%PATH_TO_FX%" --add-modules={関連モジュール} --add-opens {モジュールごとの関連パッケージ} -jar <Application_Name>.jar

例(Java 16 以降):

start javaw --module-path="%PATH_TO_FX%" --add-modules=javafx.controls,javafx.fxml,javafx.base,javafx.swing,javafx.media,java.desktop --add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED --add-opens javafx.base/com.sun.javafx.event=ALL-UNNAMED --add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED --add-opens javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED --add-opens javafx.base/javafx.event=ALL-UNNAMED --add-opens javafx.graphics/javafx.stage=ALL-UNNAMED --add-opens javafx.graphics/javafx.scene=ALL-UNNAMED --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 -jar JavaFX.jar

.bat ファイルを保存して実行します。

環境変数

JDK_JAVA_OPTIONS 環境変数の値に add-modules および add-opens オプションを入力します。

これは,このマシンで実行するすべての Java アプリケーションに影響することに注意してください。

注: 環境変数でモジュール・パスを設定する構文は,start javaw コマンドでパスを設定する構文とは少し異なります。

例(Java 16 以降):

JDK_JAVA_OPTIONS = --module-path %PATH_TO_FX% --add-modules=javafx.controls,javafx.fxml,javafx.base,javafx.swing,javafx.media,java.desktop --add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED --add-opens javafx.base/com.sun.javafx.event=ALL-UNNAMED --add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED --add-opens javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED --add-opens javafx.base/javafx.event=ALL-UNNAMED --add-opens javafx.graphics/javafx.stage=ALL-UNNAMED --add-opens javafx.graphics/javafx.scene=ALL-UNNAMED --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

先頭に戻る

その他の参照項目: