Eggplant Functional 19 リリースノート

以下のノートは、Eggplant Functionalの各リリースで導入される新機能と変更の説明を提供します。早期のバージョンからアップグレードする際には、関連する変更について読むことを強く推奨します。

潜在的な互換性問題はREDで強調表示されます。

互換性

Mac: macOS 10.15, macOS 10.14, macOS 10.13, macOS 10.12. OS X 10.11

Windows: 64ビットのディストリビューションのみ。Windows 10, Windows 8, Windows 7, Windows Server 2012, Windows Server 2008

Linux: 64ビットのディストリビューションのみ。glib 2.11以降をベースにしたDebianとRed Hat。

注: Eggplant Functionalは2020年からAndroid Debug Bridge (ADB)を含まなくなります。Androidデバイスをテストするユーザーは、今後Android Gatewayを使用する必要があります。

注: Eggplant Functionalは、Eggplant Functional 19.1のリリースからUbuntu 12またはUbuntu 14をサポートしていません。

注: Eggplant Functionalは、2020年からCentOS 6をサポートしなくなります。

注: Windows 10システム上のODBC 8.0用MySQL Connectorにはバグが存在し、ODBCデータベースに接続するとEggplant Functionalがクラッシュする可能性があります。クラッシュは通常、2回目の接続時に発生します。この問題のステータスについてのMySQLからの最新情報は、ここでMySQLフォーラムをご覧ください。唯一の既知のワークアラウンドは、古いバージョンの5.3コネクタを代わりに使用することです。

リリース 19.2.1 (2019年11月14日)

機能

• 新しいrunscriptコマンドラインオプション -connectionnameを追加し、ユーザーが初期接続の名前とその他のパラメータ（-host, -port, 等）を設定できるようにします。
• username接続プロパティをEdit ConnectionパネルでCapabilityとして通過させることにより、SauceLabs SUTへのWebDriver接続をサポートします（Eggplant Automation Cloud経由でデバイスに接続するを参照）。また、スクリプト内でdesiredCapabilityとして使用します（WebConnectコマンドを参照）。
• macOS 10.15（Catalina）のために認証されています。

バグ修正

• Adaptive to Image検索タイプのイメージに対するホットスポットを尊重するようになりました。
• 一部の新しいAndroidデバイスでSetDeviceOrientationコマンドを使用できないというバグを修正しました。

既知の問題

• macOS 15（Catalina）を実行している一部のEggplant Functionalユーザーは、runscriptコマンドを使用するために完全修飾パスを指定する必要があります：/Applications/Eggplant.app/Contents/MacOS/runscript

  /Applications/Eggplant.app/Contents/MacOS内で、ピリオドとスラッシュ（./runscript）に続いて実行することができます。

  Run PreferencesのInstall runscript in /usr/local/binボタンは、Catalina上のこの問題を修正しません。

リリース 19.2 (2019年10月2日)

機能

• 新しいイメージ検索タイプ、Adaptive to Imageを追加しました。

  • この検索タイプは、異なるデバイスや環境で実行されるクロスプラットフォームのスクリプトとともに使用するのに理想的です。これらはサイズや解像度が異なる可能性があります。
  • この検索タイプは既存のアルゴリズムよりもあいまいで、人間の視覚をよりよく反映しているべきです。
  • この検索タイプは低コントラストのイメージには最適ではありません。
  • この検索タイプは、スケールの変化には自動的に対応しません。一般的に、画像ごとにスケール設定を変更するのではなく、スイートの設定で画像検索のスケールファクターを使用することをお勧めします。

• スイート設定に画像検索のスケールファクターという新たなフィールドを追加します。これにより、スイート内のすべての画像に対して複数のスケールオプションを指定できるようになります。この機能は、同じ画像を複数のデバイスやスケールで使用する場面で、画像の再キャプチャが少なくて済むようサポートします。これらのシナリオの場合、新たに導入された"画像に適応する検索タイプ"の使用をお勧めします。

  • このフィールドは、スイート内のスクリプトが実行されるたびにScaleFactorsグローバルプロパティの初期設定を提供します。

  • ScaleFactors設定は、すべての画像検索で使用する複数のスケールファクターを提供できます。

  • 最良の結果を得るためには、常に大きな画像をキャプチャして縮小することを選択すべきです。

  • 選択するスケールファクターは、元の画像がキャプチャされたスケール（キャプチャスケール）と現在のデバイスのスケール（接続スケール）に依存します。理想的なスケールを決定する式は次の通りです：検索スケールファクター = 接続スケール / キャプチャスケール。

  • 私たちは、以下のスケールのセットを使用することを推奨します。これらは大多数のモバイルデバイスで動作するはずです：

    1, 2, 0.5, 0.6667, 1.5, 0.75, 3, 4, 1.15, 0.5752, 2.608, 1.304, 3.477, 1.739, 0.8693, 5.333, 0.3834, 0.3333, 0.25

• 新しい-ScaleFactorsコマンドラインオプションは、スイートのスケールファクターを上書きすることができます。これは、作成環境の画像と実行環境の画像が一致しないシナリオや、ランタイムでそれらの値を簡単に変更する方法を提供します。

• 画像検索タイプの名前が変更されました。新しい名前を使用するためにスクリプトを更新する必要はありません、それらは後方互換性があります。新しい名前は以下の通りです：

  "Tolerant" > "背景に寛容"

  "Smooth" > "テキスト用にスムーズ"

  "Precise" > "ピクセルまで正確"

  "Pulsing" > "要素までパルス"

  "Smooth and Pulsing" は変わらず

  いくつかの検索タイプは、高度な検索タイプを有効にするとのみ利用可能です。

  常に利用可能な検索タイプ：

  "Adaptive to Image"

  "背景に寛容"

  "テキスト用にスムーズ"

  高度な検索タイプ：

  "ピクセルまで正確"

  "要素までパルス"

  "Smooth and Pulsing"

  ノート

  FoundImageInfo()およびImageInfo()関数は、新しいlongsearchType名を返します。

バグ修正

• WindowsおよびLinuxのImage Update Panelでスピナーが止まらなくなる問題を修正しました。
• 時間計算のタイムゾーンに関する問題を修正しました。
• Eggplant Automation Cloud経由でSUTを予約したときに発生するクラッシュを修正しました。
• 画像に設定されたスケールプロパティが継続しない問題を修正しました。
• 画像から許容値を削除するサポートを追加しました。
• リストの最後のアイテムが時折切り取られる問題を修正しました。
• Cloud Preferencesパネルとのやり取り中に時折発生するクラッシュを修正しました。

注意

• バージョン19.2の一部のグラフィックはEggplant FunctionalをEggplant Studioと表記しています。これは名前の変更だけであり、ツール自体は以前と同じです。

リリース19.1.2 (2019年8月7日)

バグ修正

• ハイライト
• WindowsでGMTに表示される時間に関する問題を修正しました。これは、システム設定、特に夏時間(DST)との関連で、一部の時間がGMTではなくローカルタイムに表示されるように変更しました。* 画像プレビューをGMTではなくローカルタイムで表示するように変更しました。
• 画像のプレビューを見るために画像にマウスを乗せるときの例外を修正しました。
• 最終実行日でスクリプトをソートするときの例外を修正しました。

リリース 19.1.1 (2019年7月29日)

機能

• Linux上でのFIPSモードのサポートを追加しました。
• CentOSでのEggplant Functionalの安定性を向上しました。
• availableTimeZoneNames()およびavailableTimeZoneAbbreviations()SenseTalk関数のドキュメンテーションを追加しました。

バグ修正

• タイムゾーンの報告方法に関連するいくつかのバグを修正しました。

リリース 19.1 (2019年6月25日)

機能

• Autoscanセッションでは、EggplantのモバイルゲートウェイへのモバイルVNC接続を使用してオブジェクトモデルからの情報に基づいて、Eggplant Functionalが自動的に要素名、タイプ、および画像ファイル名を決定します。Android Gateway 5.5以降、またはiOS Gateway 5.5以降が必要です。

• AppList()関数には、FullおよびSimpleの2つの新しいオプションがあります。

  • AppList(Full)オプションは、デバイスにインストールされているアプリに関する詳細情報を返します：appID、appName、canUninstall、およびdeviceName。

  • AppList(Simple)オプションはappNameのみを返します。 :::note

    ノート

    パラメータなしで使用されるAppList()関数は、現在iOSデバイスに対してもappNameのみを返します。これは、以前はdeviceNameとappNameの両方を返していたという以前の振る舞いからの変更です。

    AppList()関数のオプションは、Eggplantのモバイルゲートウェイを経由してモバイルVNC SUTに接続したときに利用可能です。Android Gateway 5.5以降、またはiOS Gateway 5.5以降が必要です。

• 新しいコントロールメニューアイテムであるアプリリストの更新は、Eggplantのモバイルゲートウェイを経由して接続されたモバイルVNC SUTからアクティブな接続の更新されたアプリリストを返します。Android Gateway 5.5以降、またはiOS Gateway 5.5以降が必要です。

• 大量の画像を含むスイートのスイートパフォーマンスを向上しました。

• Unicodeの日付/時刻形式のサポートを追加し、新たにもっと人間が読みやすいSenseTalkの日付/時刻形式を追加しました。 基本的な実装は現在、Unicode（ICU）標準に基づいていますが、古いパーセントスタイルのトークンもサポートしています。内蔵の時間と日付の形式は現在、ブラケットスタイルのトークンを使用しています：

  • ブラケットスタイル: [month name] [day], [year] [hr]:[mi]:[se]

  • Unicodeスタイル: MMMM d, yyyy HH:mm:ss

  • パーセントスタイル: %B %e, %Y %H:%M:%S

    これらの日付フォーマットコードへの変更とともに、いくつか他の結果としての変更があります：

  • フォーマット内の"%w"トークン（週の日）は、以前とは異なり、1-7の数値を表示します。

  • DayOfWeek()関数も、今では0-6ではなく1-7を返します。数値1が対応する日はロケールによるかもしれません。

  • "%I"（12時間制の時刻）フォーマット文字列を使用して日付文字列を解析する場合、時間 "12"は午前12時、午後12時ではなく解釈されます。

  • コマンドput " 14:20" plus one hourは正しく"15:20"を返します。

• Eggplant Functionalを改善するために私たちを手伝ってください！一般的な設定の新しいインストール詳細の共有オプションを有効にして、Eggplantにオペレーティングシステムとアプリケーションバージョン情報を提供し、私たちの将来の開発努力を指導してください。

バグ修正

• 画面が少しオフスクリーンになったときにTurbo Captureセッションでスクリプトを生成しようとするとクラッシュする問題を修正しました。
• 非常に大きなスイートを開くときの速度を向上しました。
• WindowsのViewerウィンドウのLiveモードでCaps Lockが機能しない問題を修正しました。
• Signal 11エラーを結果としてスクリプト実行中にクラッシュする問題を修正しました。
• ファイル（またはソケット、プロセス）から指定した数の文字を読み取るというバグを修正しましたが、代わりに指定した数のバイトを読み取っていました。readコマンドは、読み取る量が明示的に文字として要求された場合、可能な限り指定した数の文字を読み取ります。データタイプが指定されていない場合、コマンドは以前のようにバイトを読み取り続けます。
• ファイル（またはソケット、プロセス）から行を読み取るときに、改行文字だけを使用して行を分割するのではなく、the lineDelimiterグローバルプロパティの現在の設定を使用するように修正しました。
• Windowsでファイルコンテナの値を設定してファイルに書き込む（たとえば、put x into file y）ときに、書き込みが原子的な書き込み操作を試みるのを防ぎます。この設定は、デフォルトの書き込みコマンドを通じてSTFileValueUseAtomicWriteデフォルトをYesに設定することで変更できます。
• ドキュメントツリーの等価性比較にマイナーチェンジを加え、URIの一方が空の値である場合、_xmlinfo.URIの値の差を無視するようにしました。
• MacでST_ODBC xmoduleがロードされず、ODBCデータベースにアクセスできないバグを修正しました。
• Unarchive関数に関連するバグを修正しました。これは、バックスラッシュ(\)で終わる文字列値で失敗する可能性がありました。
• ドットと括弧（パラメータありまたはなし）を両方含む関数を呼び出すときにクラッシュを引き起こす可能性のあるバグを修正しました。例えば、set trimmedVar to var.trim()。

リリース 19.0.1 (2019年4月4日)

バグ修正

• WindowsでAPIテストを使用している場合、一部のケースで接続が早期に終了する問題を修正しました。
• macOS Mojaveでスクリプトエディターにアセットをドラッグしても期待通りの参照が作成されない問題を修正しました。
• スクリプトでグローバルプロパティを設定したとき、問題が見つからない場合にUsability ModeのJSONファイルが作成されない問題を修正しました。
• MacのODBCバンドルへのパスを修正しました。
• ベースライン画像が現在のSUT画面と大幅に異なる場合、比較画面機能でクラッシュする問題を修正しました。
• 画像がクロップ中に移動する問題を修正しました。
• CompareScreenコマンドとColorAtLocation関数でメモリリークの問題を修正しました。

リリース 19.0 (2019年2月20日)

ハイライト

• 画面比較： UIテスト用にキャプチャしたベースライン画像と現在のテストシステム（SUT）画面を比較する機能を追加しました。
• この機能の詳細情報はこちらをご覧ください：Eggplant FunctionalでのCompare Screenの使用について。

機能

• ベースライン画像をキャプチャし、そのベースライン画像と後続の呼び出しを比較して差異を検出するCompareScreenというSenseTalkコマンドと関数を追加しました。
  • 比較は、新規、欠落、移動、変更された画像とテキストを検出します。
• ベースライン画像上のエリアを比較中に無視するマスクを設定し、比較中に他のエリアを動的コンテンツとしてマークできるCompare Screenパネルを追加しました。
  • スクリプトの実行中または結果ペインからCompare Screenパネルを使用できます。
• スクリプトの実行中に動的にCompare Screenパネルを開くかどうかを決定できるように、the CompareScreenActionグローバルプロパティを追加しました。

バグ修正

• セットが常にプットと同じように動作しない問題を修正しました。それは常に同じように動作すべきです。
• ホームディレクトリ（〜）のパスがどこでも認識されない問題を修正しました。
• macOS Mojaveでボタンとブレークポイントが正しく描画されない問題を修正しました。
• ロギング出力が時間とともに遅くなる問題を修正しました。