GTestBase
public abstract class GTestBase
extends Object
implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver
java.lang.Object | |
↳ | com.android.tradefed.testtype.GTestBase |
gTest の基本クラス
まとめ
田畑 | |
---|---|
protected static final String | FILTER_EXTENSION |
protected static final String | GTEST_FLAG_FILE |
protected static final String | GTEST_FLAG_FILTER |
protected static final String | GTEST_FLAG_LIST_TESTS |
protected static final String | GTEST_FLAG_PRINT_TIME |
protected static final String | GTEST_FLAG_RUN_DISABLED_TESTS |
protected static final String | GTEST_XML_OUTPUT
|
パブリック コンストラクター | |
---|---|
GTestBase () |
公開メソッド | |
---|---|
void | addAllExcludeFilters ( filters) addAllExcludeFilters ( filters) 除外するテストのフィルターの |
void | addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) 含めるテストのフィルターの |
void | addExcludeFilter (String filter) 除外するテストのフィルターを追加します。 |
void | addIncludeFilter (String filter) 含めるテストのフィルターを追加します。 |
String | cleanFilter (String filter) |
void | clearExcludeFilters () 現在追跡されているすべての除外フィルターを削除します。 |
void | clearIncludeFilters () 現在追跡されているすべての包含フィルターを削除します。 |
IAbi | getAbi () |
getAfterTestCmd () GTest の後に実行するシェル コマンドを取得します。 | |
getBeforeTestCmd () GTest の前に実行するシェル コマンドを取得します。 | |
getExcludeFilters () 除外フィルターの現在の | |
getFileExclusionFilterRegex () 特定のファイルを実行から除外する正規表現を取得します。 | |
getGTestFlags () ネイティブ テストのシェル コマンドに渡す追加のフラグ値を取得します。 | |
getIncludeFilters () インクルード フィルターの現在の | |
long | getMaxTestTimeMs () gtest の最大実行時間を取得します。 |
String | getModuleName () 実行する Android ネイティブ テスト モジュールを取得します。 |
boolean | getRunDisabledTests () GTest が無効なテストを実行するかどうかを取得します。 |
long | getRuntimeHint () テストの予想実行時間をミリ秒単位で返します。 |
int | getShardCount () 現在のシャード数を返します。 |
int | getShardIndex () このテストのシャード インデックスを取得します。 |
String | getTestFilterKey () テスト フィルター キーを取得します。 |
String | getTestModule () モジュール名を取得します。 |
boolean | isCollectTestsOnly () テスト バイナリを呼び出して、適用可能なテスト ケースのリストを収集するかどうかのみを取得します。 |
boolean | isEnableXmlOutput () テスト結果に gtest xml 出力を使用するかどうかを取得します。 |
boolean | isSharded () isSharded フラグを取得します。 |
void | setAbi ( IAbi abi) |
void | setCollectTestsOnly (boolean shouldCollectTest) テスト収集モードを有効または無効にします |
void | setConfiguration ( IConfiguration configuration) 使用中の |
void | setModuleName (String moduleName) Android ネイティブ テスト モジュールを実行するように設定します。 |
void | setShardCount (int shardCount) このテストのシャード数を設定します。 |
void | setShardIndex (int shardIndex) このテストのシャード インデックスを設定します。 |
split (int shardCountHint) 実行しようとする shardCount も提供する |
保護されたメソッド | |
---|---|
String | createFlagFile (String filter) --gtest_flagfile を介して使用されるフィルターを含むファイルを作成して、引数サイズの OS 制限を回避します。 |
void | erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename) |
String | getAllGTestFlags (String path) すべての GTest フラグを取得して adb shell コマンドに渡すためのヘルパー。 |
IConfiguration | getConfiguration () テスト構成を返します。 |
String | getExceptionMessage (Exception e) 指定された |
String | getGTestCmdLine (String fullPath, String flags) 実行する gtest コマンドをビルドするためのヘルパー メソッド。 |
String | getGTestCmdLineWrapper (String fullPath, String flags) 派生クラスが gtest コマンドを他のツール (chroot、strace、gdb など) でラップできるようにするヘルパー。 |
String | getGTestFilters (String path) test の g-test フィルターを実行するためのヘルパー。 |
ITestInvocationListener | getGTestListener ( ITestInvocationListener listener) mDisabledDuplicateCheck が false の場合に重複テストを検出して報告するなど、追加のデバッグ情報を提供する |
abstract String | loadFilter (String path) get フィルター メソッドを定義します。 |
void | setRunDisabled (boolean runDisabled) GTest が無効なテストを実行するかどうかを設定します。 |
田畑
FILTER_EXTENSION
protected static final String FILTER_EXTENSION
GTEST_FLAG_FILE
protected static final String GTEST_FLAG_FILE
GTEST_FLAG_FILTER
protected static final String GTEST_FLAG_FILTER
GTEST_FLAG_LIST_TESTS
protected static final String GTEST_FLAG_LIST_TESTS
GTEST_FLAG_PRINT_TIME
protected static final String GTEST_FLAG_PRINT_TIME
GTEST_FLAG_RUN_DISABLED_TESTS
protected static final String GTEST_FLAG_RUN_DISABLED_TESTS
GTEST_XML_OUTPUT
protected static final String GTEST_XML_OUTPUT
パブリック コンストラクター
GTestBase
public GTestBase ()
公開メソッド
addAllExcludeFilters
public void addAllExcludeFilters (filters)
除外するテストのフィルターのERROR(/Set)
を追加します。
パラメーター | |
---|---|
filters |
addAllIncludeFilters
public void addAllIncludeFilters (filters)
含めるテストのフィルターのERROR(/Set)
を追加します。
パラメーター | |
---|---|
filters |
addExcludeFilter
public void addExcludeFilter (String filter)
除外するテストのフィルターを追加します。
パラメーター | |
---|---|
filter | String |
addIncludeFilter
public void addIncludeFilter (String filter)
含めるテストのフィルターを追加します。
パラメーター | |
---|---|
filter | String |
クリーンフィルター
public String cleanFilter (String filter)
パラメーター | |
---|---|
filter | String |
戻り値 | |
---|---|
String |
clearExcludeFilters
public void clearExcludeFilters ()
現在追跡されているすべての除外フィルターを削除します。
clearIncludeFilters
public void clearIncludeFilters ()
現在追跡されているすべての包含フィルターを削除します。
getAfterTestCmd
publicgetAfterTestCmd ()
GTest の後に実行するシェル コマンドを取得します。
戻り値 | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
GTest の前に実行するシェル コマンドを取得します。
戻り値 | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
特定のファイルを実行から除外する正規表現を取得します。
戻り値 | |
---|---|
getGTestFlags
publicgetGTestFlags ()
ネイティブ テストのシェル コマンドに渡す追加のフラグ値を取得します。
戻り値 | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
gtest の最大実行時間を取得します。
戻り値 | |
---|---|
long |
getModuleName
public String getModuleName ()
実行する Android ネイティブ テスト モジュールを取得します。
戻り値 | |
---|---|
String | 実行するネイティブ テスト モジュールの名前、または設定されていない場合は null |
getRunDisabledTests
public boolean getRunDisabledTests ()
GTest が無効なテストを実行するかどうかを取得します。
戻り値 | |
---|---|
boolean | 無効なテストを実行する必要がある場合は true、それ以外の場合は false |
getRuntimeHint
public long getRuntimeHint ()
テストの予想実行時間をミリ秒単位で返します。この時間は、シャード実行の負荷分散に使用されます
戻り値 | |
---|---|
long |
getShardCount
public int getShardCount ()
現在のシャード数を返します。
戻り値 | |
---|---|
int |
getShardIndex
public int getShardIndex ()
このテストのシャード インデックスを取得します。
戻り値 | |
---|---|
int |
getTestFilterKey
public String getTestFilterKey ()
テスト フィルター キーを取得します。
戻り値 | |
---|---|
String |
getTestModule
public String getTestModule ()
モジュール名を取得します。
戻り値 | |
---|---|
String |
isCollectTestsOnly
public boolean isCollectTestsOnly ()
テスト バイナリを呼び出して、適用可能なテスト ケースのリストを収集するかどうかのみを取得します。
戻り値 | |
---|---|
boolean |
isEnableXmlOutput
public boolean isEnableXmlOutput ()
テスト結果に gtest xml 出力を使用するかどうかを取得します。
戻り値 | |
---|---|
boolean |
シャード
public boolean isSharded ()
isSharded フラグを取得します。
戻り値 | |
---|---|
boolean |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
テスト収集モードを有効または無効にします
setConfiguration
public void setConfiguration (IConfiguration configuration)
使用中のIConfiguration
を挿入します。
パラメーター | |
---|---|
configuration | IConfiguration |
setModuleName
public void setModuleName (String moduleName)
Android ネイティブ テスト モジュールを実行するように設定します。
パラメーター | |
---|---|
moduleName | String : 実行するネイティブ テスト モジュールの名前 |
setShardCount
public void setShardCount (int shardCount)
このテストのシャード数を設定します。
パラメーター | |
---|---|
shardCount | int |
setShardIndex
public void setShardIndex (int shardIndex)
このテストのシャード インデックスを設定します。
パラメーター | |
---|---|
shardIndex | int |
スプリット
publicsplit (int shardCountHint)
実行しようとする shardCount も提供するsplit()
の代替バージョン。これは、時々任意に決定できないテスト ランナーに役立ちます。
パラメーター | |
---|---|
shardCountHint | int : 試行されたシャード数。 |
戻り値 | |
---|---|
個別に実行されるサブテストのコレクション、またはテストが現在シャード可能でない場合はnull |
保護されたメソッド
createFlagFile
protected String createFlagFile (String filter)
--gtest_flagfile を介して使用されるフィルターを含むファイルを作成して、引数サイズの OS 制限を回避します。
パラメーター | |
---|---|
filter | String : フィルタ文字列 |
戻り値 | |
---|---|
String | フィルターを含むファイルへのパス。 |
スロー | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
erasePrependedFileName
protected void erasePrependedFileName (filters, String filename)
パラメーター | |
---|---|
filters | |
filename | String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
すべての GTest フラグを取得して adb shell コマンドに渡すためのヘルパー。
パラメーター | |
---|---|
path | String : デバイス上のバイナリのフル パス。 |
戻り値 | |
---|---|
String | GTest に渡す必要があるすべての GTest フラグのERROR(/String) |
スロー | |
---|---|
DeviceNotAvailableException |
getConfiguration
protected IConfiguration getConfiguration ()
テスト構成を返します。
戻り値 | |
---|---|
IConfiguration | IConfiguration |
getExceptionMessage
protected String getExceptionMessage (Exception e)
指定されたERROR(/Exception)
について意味のある短い説明メッセージを取得するために最善を尽くします。
パラメーター | |
---|---|
e | Exception : ERROR(/Exception) |
戻り値 | |
---|---|
String | 短いメッセージ |
getGTestCmdLine
protected String getGTestCmdLine (String fullPath, String flags)
実行する gtest コマンドをビルドするためのヘルパー メソッド。
パラメーター | |
---|---|
fullPath | String : デバイス上の gtest バイナリへの絶対ファイル システム パス |
flags | String : gtest 実行フラグ |
戻り値 | |
---|---|
String | gtest で実行するシェル コマンド ライン |
getGTestCmdLineWrapper
protected String getGTestCmdLineWrapper (String fullPath, String flags)
派生クラスが gtest コマンドを他のツール (chroot、strace、gdb など) でラップできるようにするヘルパー。
パラメーター | |
---|---|
fullPath | String |
flags | String |
戻り値 | |
---|---|
String |
getGTestFilters
protected String getGTestFilters (String path)
test の g-test フィルターを実行するためのヘルパー。
フィルターは関数名のみをフィルター処理することに注意してください (例: Google Test "Test")。すべての Google テスト「テスト ケース」が考慮されます。
パラメーター | |
---|---|
path | String : デバイス上のバイナリのフル パス。 |
戻り値 | |
---|---|
String | g-test に渡す完全なフィルター フラグ、または何も指定されていない場合は空の文字列 |
スロー | |
---|---|
DeviceNotAvailableException |
getGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)
mDisabledDuplicateCheck が false の場合に重複テストを検出して報告するなど、追加のデバッグ情報を提供するGTestListener
を返します。それ以外の場合は、渡されたリスナーを返します。
パラメーター | |
---|---|
listener | ITestInvocationListener |
戻り値 | |
---|---|
ITestInvocationListener |
ロードフィルター
protected abstract String loadFilter (String path)
get フィルター メソッドを定義します。
サブクラスは、独自のフィルターを取得する方法を実装する必要があります。
パラメーター | |
---|---|
path | String : フィルタ ファイルのフル パス。 |
戻り値 | |
---|---|
String | フィルタ文字列。 |
スロー | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
GTest が無効なテストを実行するかどうかを設定します。
パラメーター | |
---|---|
runDisabled | boolean |