GTestBase

public abstract class GTestBase
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

java.lang.Object
   ↳ com.android.tradefed.testtype.GTestBase

gTest の基本クラス

概要

定数

String FILTER_EXTENSION

String GTEST_FLAG_FILE

String GTEST_FLAG_FILTER

String GTEST_FLAG_LIST_TESTS

String GTEST_FLAG_PRINT_TIME

String GTEST_FLAG_RUN_DISABLED_TESTS

String GTEST_XML_OUTPUT

パブリック コンストラクタ

GTestBase()

パブリック メソッド

void addAllExcludeFilters( filters)

除外するテストのフィルタの ERROR(/Set) を追加します。
void 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 notifyTestExecution(boolean incompleteTestFound, failedTests)

テスト実行の親に通知して、再試行で一致フィルタと除外フィルタを適切に処理できるようにします。
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 convertName(String gtestFlagName)
String createFlagFile(String filter)

--gtest_flagfile を介して使用されるフィルタを含むファイルを作成して、引数のサイズに関する OS の制限を回避します。
void erasePrependedFileName( filters, String filename)
String getAllGTestFlags(String path)

adb shell コマンドに渡す GTest フラグをすべて取得するヘルパー。

IConfiguration getConfiguration()

テスト構成を返します。
String getExceptionMessage(Exception e)

指定された Exception の意味のある短い説明メッセージを取得するよう最善を尽くします。
String getGTestCmdLine(String fullPath, String flags)

実行する gtest コマンドをビルドするヘルパー メソッド。
String getGTestCmdLineWrapper(String fullPath, String flags)

派生クラスが gtest コマンドを他のツール（chroot、strace、gdb など）でラップできるようにするヘルパー。

String getGTestFilters(String path)

実行するテストの g-test フィルタを取得するヘルパー。
ITestInvocationListener getGTestListener(ITestInvocationListener... listeners)

mDisabledDuplicateCheck が false の場合、重複するテストを検出して報告するなど、追加のデバッグ情報を提供する GTestListener を返します。
abstract String loadFilter(String path)

get フィルタ メソッドを定義します。
void setRunDisabled(boolean runDisabled)

GTest で無効なテストを実行するかどうかを設定します。

定数

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

定数値: ".filter"

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

定数値: "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

定数値: "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

定数値: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

定数値: "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

定数値: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

定数値: "--gtest_output=xml:%s"

パブリック コンストラクタ

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 ()

現在トラッキングされているすべての包含フィルタを削除します。

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

isSharded

public boolean isSharded ()

isSharded フラグを取得します。

戻り値
boolean

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

テスト実行の親に通知して、再試行で包含/除外フィルタを適切に処理できるようにします。

パラメータ
incompleteTestFound boolean

failedTests

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

保護されたメソッド

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 shell コマンドに渡す 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)

派生クラスが gtest コマンドを他のツール（chroot、strace、gdb など）でラップできるようにするヘルパー。

パラメータ
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)

mDisabledDuplicateCheck が false の場合、重複するテストを検出して報告するなど、追加のデバッグ情報を提供する GTestListener を返します。それ以外の場合は、渡されたリスナーを返します。

パラメータ
listeners ITestInvocationListener

戻り値
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

get フィルタ メソッドを定義します。

サブクラスは、独自のフィルタを取得する方法を実装する必要があります。

パラメータ
path String: フィルタ ファイルのフルパス。
戻り値
String フィルタ文字列。
例外
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

GTest で無効なテストを実行するかどうかを設定します。

パラメータ
runDisabled boolean