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)

除外するテストのフィルターのERROR(/Set)を追加します。

void addAllIncludeFilters ( filters) addAllIncludeFilters ( filters)

含めるテストのフィルターのERROR(/Set)を追加します。

void addExcludeFilter (String filter)

除外するテストのフィルターを追加します。

void addIncludeFilter (String filter)

含めるテストのフィルターを追加します。

String cleanFilter (String filter)
void clearExcludeFilters ()

現在追跡されているすべての除外フィルターを削除します。

void clearIncludeFilters ()

現在追跡されているすべての包含フィルターを削除します。

IAbi getAbi ()
getAfterTestCmd ()

GTest の後に実行するシェル コマンドを取得します。

getBeforeTestCmd ()

GTest の前に実行するシェル コマンドを取得します。

getExcludeFilters ()

除外フィルターの現在のERROR(/Set)を返します。

getFileExclusionFilterRegex ()

特定のファイルを実行から除外する正規表現を取得します。

getGTestFlags ()

ネイティブ テストのシェル コマンドに渡す追加のフラグ値を取得します。

getIncludeFilters ()

インクルード フィルターの現在のERROR(/Set)を返します。

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)

使用中のIConfigurationを挿入します。

void setModuleName (String moduleName)

Android ネイティブ テスト モジュールを実行するように設定します。

void setShardCount (int shardCount)

このテストのシャード数を設定します。

void setShardIndex (int shardIndex)

このテストのシャード インデックスを設定します。

split (int shardCountHint)

実行しようとする shardCount も提供するsplit()の代替バージョン。

保護されたメソッド

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)

指定されたERROR(/Exception)について意味のある短い説明メッセージを取得するために最善を尽くします。

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 の場合に重複テストを検出して報告するなど、追加のデバッグ情報を提供する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

clearExcludeFilters

public void clearExcludeFilters ()

現在追跡されているすべての除外フィルターを削除します。

clearIncludeFilters

public void clearIncludeFilters ()

現在追跡されているすべての包含フィルターを削除します。

getAbi

public IAbi getAbi ()

戻り値
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

GTest の後に実行するシェル コマンドを取得します。

戻り値

getBeforeTestCmd

public  getBeforeTestCmd ()

GTest の前に実行するシェル コマンドを取得します。

戻り値

getExcludeFilters

public  getExcludeFilters ()

除外フィルターの現在のERROR(/Set)を返します。

戻り値

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

特定のファイルを実行から除外する正規表現を取得します。

戻り値

getGTestFlags

public  getGTestFlags ()

ネイティブ テストのシェル コマンドに渡す追加のフラグ値を取得します。

戻り値

getIncludeFilters

public  getIncludeFilters ()

インクルード フィルターの現在のERROR(/Set)を返します。

戻り値

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

setAbi

public void setAbi (IAbi abi)

パラメーター
abi IAbi

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

スプリット

public  split (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