このページは Cloud Translation API によって翻訳されました。

GTestBase

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

java.lang.オブジェクト
↳	com.android.tradefed.testtype.GTestBase

既知の直接サブクラス

GTest 、ホストGTest

GTest	指定されたデバイス上でネイティブテストパッケージを実行するテスト。
ホストGTest	ネイティブテストパッケージを実行するテスト。

既知の間接サブクラス

アートGTest

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`	`notifyTestExecution (boolean incompleteTestFound, failedTests)` `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`	`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)` 特定の`Exception`に対して意味のある短い説明メッセージを取得するために最善の努力を試みます。
`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 ()

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

アビを取得

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`

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`

通知テスト実行

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

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

パラメーター
`incompleteTestFound`	`boolean`
`failedTests`

セットアビ

public void setAbi (IAbi abi)

パラメーター
`abi`	`IAbi`

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`

スプリット

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

get構成

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 テストの「テストケース」が考慮されます。

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