GTestBase
public abstract class GTestBase
extends Object
implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver
java.lang.オブジェクト | |
↳ | 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) OS の引数サイズの制限を回避するために、--gtest_flagfile 経由で使用されるフィルターを含むファイルを作成します。 |
void | erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename) |
String | getAllGTestFlags (String path) adb シェル コマンドに渡すすべての GTest フラグを取得するヘルパー。 |
IConfiguration | getConfiguration () テスト構成を返します。 |
String | getExceptionMessage (Exception e) 特定の |
String | getGTestCmdLine (String fullPath, String flags) 実行する gtest コマンドを構築するヘルパー メソッド。 |
String | getGTestCmdLineWrapper (String fullPath, String flags) 派生クラスが他のツール (chroot、strace、gdb など) の下で gtest コマンドをラップできるようにするヘルパー。 |
String | getGTestFilters (String path) 実行するテストの g-test フィルターを取得するヘルパー。 |
ITestInvocationListener | getGTestListener ( ITestInvocationListener listener) mDisabledDuplicateCheck が false の場合に重複したテストを検出して報告するなど、追加のデバッグ情報を提供する GTestListener を返します。 |
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 |
クリア除外フィルタ
public void clearExcludeFilters ()
現在追跡されているすべての除外フィルターを削除します。
ClearIncludeFilters
public void clearIncludeFilters ()
現在追跡されているすべての組み込みフィルターを削除します。
getAfterTestCmd
publicgetAfterTestCmd ()
GTest の後に実行するシェル コマンドを取得します。
戻り値 | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
GTest の前に実行するシェル コマンドを取得します。
戻り値 | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
特定のファイルの実行を除外するための正規表現を取得します。
戻り値 | |
---|---|
getGTestFlags
publicgetGTestFlags ()
ネイティブ テストのシェル コマンドに渡す追加のフラグ値を取得します。
戻り値 | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
gtest の最大実行時間を取得します。
戻り値 | |
---|---|
long |
getモジュール名
public String getModuleName ()
実行する Android ネイティブ テスト モジュールを取得します。
戻り値 | |
---|---|
String | 実行するネイティブ テスト モジュールの名前、または設定されていない場合は null |
getRunDisabledTests
public boolean getRunDisabledTests ()
GTest が無効なテストを実行する必要があるかどうかを取得します。
戻り値 | |
---|---|
boolean | 無効なテストを実行する場合は true、それ以外の場合は false |
ランタイムヒントの取得
public long getRuntimeHint ()
テストの予想実行時間をミリ秒単位で返します。この時間は、シャード実行の負荷分散に使用されます。
戻り値 | |
---|---|
long |
getShardCount
public int getShardCount ()
現在のシャード数を返します。
戻り値 | |
---|---|
int |
getShardIndex
public int getShardIndex ()
このテストのシャード インデックスを取得します。
戻り値 | |
---|---|
int |
getTestFilterKey
public String getTestFilterKey ()
テストフィルターキーを取得します。
戻り値 | |
---|---|
String |
getテストモジュール
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)
テスト収集モードを有効または無効にします。
set構成
public void setConfiguration (IConfiguration configuration)
使用中のIConfiguration
を挿入します。
パラメーター | |
---|---|
configuration | IConfiguration |
setモジュール名
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 |
保護されたメソッド
フラグファイルの作成
protected String createFlagFile (String filter)
OS の引数サイズの制限を回避するために、--gtest_flagfile 経由で使用されるフィルターを含むファイルを作成します。
パラメーター | |
---|---|
filter | String : フィルター文字列 |
戻り値 | |
---|---|
String | フィルターを含むファイルへのパス。 |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
消去前に追加されたファイル名
protected void erasePrependedFileName (filters, String filename)
パラメーター | |
---|---|
filters | |
filename | String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
adb シェル コマンドに渡すすべての GTest フラグを取得するヘルパー。
パラメーター | |
---|---|
path | String : デバイス上のバイナリのフルパス。 |
戻り値 | |
---|---|
String | GTest に渡す必要があるすべての GTest フラグのString |
投げる | |
---|---|
DeviceNotAvailableException |
getExceptionMessage
protected String getExceptionMessage (Exception e)
特定のException
に対して意味のある短い説明メッセージを取得するために最善の努力を試みます。
パラメーター | |
---|---|
e | Exception : 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)
派生クラスが他のツール (chroot、strace、gdb など) の下で gtest コマンドをラップできるようにするヘルパー。
パラメーター | |
---|---|
fullPath | String |
flags | String |
戻り値 | |
---|---|
String |
getGTestFilters
protected String getGTestFilters (String path)
実行するテストの 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 |