GTestBase
public
abstract
class
GTestBase
extends Object
implements
IAbiReceiver,
IConfigurationReceiver,
IRemoteTest,
IRuntimeHintProvider,
IShardableTest,
ITestCollector,
ITestFilterReceiver
| 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(
除外するテストのフィルタの |
void
|
addAllIncludeFilters(
含めるテストのフィルタの |
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
|
notifyTestExecution(boolean incompleteTestFound,
親にテストの実行を通知して、再試行の試行で包含フィルタと除外フィルタを適切に処理できるようにします。 |
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)
|
保護されたメソッド | |
|---|---|
String
|
convertName(String gtestFlagName)
|
String
|
createFlagFile(String filter)
--gtest_flagfile で使用されるフィルタを含むファイルを作成して、引数のサイズに関する OS の制限を回避します。 |
void
|
erasePrependedFileName(
|
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... listeners)
mDisabledDuplicateCheck が false の場合に重複するテストを検出して報告するなど、追加のデバッグ情報を提供する GTestListener を返します。 |
abstract
String
|
loadFilter(String path)
フィルタ取得メソッドを定義します。 |
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 |
cleanFilter
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 |
|
isSharded
public boolean isSharded ()
isSharded フラグを取得します。
| 戻り値 | |
|---|---|
boolean |
|
notifyTestExecution
public void notifyTestExecution (boolean incompleteTestFound,
failedTests) 親にテストの実行を通知して、再試行の試行で包含/除外フィルタを適切に処理できるようにします。
| パラメータ | |
|---|---|
incompleteTestFound |
boolean |
failedTests |
|
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)
split() の代替バージョン。実行が試行される shardCount も提供します。これは、場合によっては任意に決定できない一部のテストランナーに便利です。
| パラメータ | |
|---|---|
shardCountHint |
int: 試行されたシャードの数。 |
| 戻り値 | |
|---|---|
|
個別に実行されるサブテストのコレクション。テストが現在シャーディング可能でない場合は null |
保護されたメソッド
convertName
protected String convertName (String gtestFlagName)
| パラメータ | |
|---|---|
gtestFlagName |
String |
| 戻り値 | |
|---|---|
String |
|
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)
adb シェルコマンドに渡すすべての GTest フラグを取得するヘルパー。
| パラメータ | |
|---|---|
path |
String: デバイス上のバイナリのフルパス。 |
| 戻り値 | |
|---|---|
String |
GTest に渡す必要があるすべての GTest フラグの String |
| 例外 | |
|---|---|
DeviceNotAvailableException |
|
getConfiguration
protected IConfiguration getConfiguration ()
テスト構成を返します。
| 戻り値 | |
|---|---|
IConfiguration |
IConfiguration |
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 Test「Test Cases」が考慮されます。
| パラメータ | |
|---|---|
path |
String: デバイス上のバイナリのフルパス。 |
| 戻り値 | |
|---|---|
String |
g-test に渡す完全なフィルタ フラグ。指定されていない場合は空の文字列 |
| 例外 | |
|---|---|
DeviceNotAvailableException |
|
getGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)
追加のデバッグ情報を提供する GTestListener を返します。たとえば、mDisabledDuplicateCheck が false の場合、重複するテストを検出して報告します。それ以外の場合は、渡されたリスナーを返します。
| パラメータ | |
|---|---|
listeners |
ITestInvocationListener |
| 戻り値 | |
|---|---|
ITestInvocationListener |
|
loadFilter
protected abstract String loadFilter (String path)
取得フィルタ メソッドを定義します。
サブクラスは、独自のフィルタを取得する方法を実装する必要があります。
| パラメータ | |
|---|---|
path |
String: フィルタ ファイルのフルパス。 |
| 戻り値 | |
|---|---|
String |
フィルタ文字列。 |
| 例外 | |
|---|---|
DeviceNotAvailableException |
|
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
GTest で無効なテストを実行するかどうかを設定します。
| パラメータ | |
|---|---|
runDisabled |
boolean |