AbstractTestTask

目錄

屬性
方法
腳本區塊
屬性詳細資訊
方法詳細資訊
腳本區塊詳細資訊
API 文件AbstractTestTask
已知子類型
測試 (Test)
XCTest

所有測試任務的抽象類別。

  • 測試監聽器支援
  • 報告支援
  • 控制台輸出中的報告連結支援

注意： 這個抽象類別不適合由建置腳本或外掛作者實作。

屬性

屬性描述
binaryResultsDirectory

內部二進制格式的測試結果根目錄屬性。

ignoreFailures

指定當此任務執行的驗證失敗時，建置是否應該中斷。

reports

此任務可能產生的報告。

方法

方法描述
addTestListener(listener)

為此任務註冊一個測試監聽器。也請考慮以下方便的方法，以便更快地掛鉤到測試執行： AbstractTestTask.beforeTest(groovy.lang.Closure), AbstractTestTask.afterTest(groovy.lang.Closure), AbstractTestTask.beforeSuite(groovy.lang.Closure), AbstractTestTask.afterSuite(groovy.lang.Closure)

addTestOutputListener(listener)

為此任務註冊一個輸出監聽器。更快的掛鉤到輸出事件的方法是使用 AbstractTestTask.onOutput(groovy.lang.Closure) 方法。

afterSuite(closure)

添加一個閉包，以便在測試套件執行後收到通知。一個 TestDescriptor 和 TestResult 實例將作為參數傳遞給閉包。

afterTest(closure)

添加一個閉包，以便在測試執行後收到通知。一個 TestDescriptor 和 TestResult 實例將作為參數傳遞給閉包。

beforeSuite(closure)

添加一個閉包，以便在測試套件執行之前收到通知。一個 TestDescriptor 實例將作為參數傳遞給閉包。

beforeTest(closure)

添加一個閉包，以便在測試執行之前收到通知。一個 TestDescriptor 實例將作為參數傳遞給閉包。

onOutput(closure)

添加一個閉包，以便在收到測試輸出時收到通知。一個 TestDescriptor 和 TestOutputEvent 實例將作為參數傳遞給閉包。

removeTestListener(listener)

取消註冊此任務的測試監聽器。此方法僅會移除透過呼叫 AbstractTestTask.addTestListener(org.gradle.api.tasks.testing.TestListener) 在此任務上添加的監聽器。如果監聽器是使用 Gradle.addListener(java.lang.Object) 向 Gradle 註冊的，則此方法不會執行任何操作。請改用 Gradle.removeListener(java.lang.Object)。

removeTestOutputListener(listener)

取消註冊此任務的測試輸出監聽器。此方法僅會移除透過呼叫 AbstractTestTask.addTestOutputListener(org.gradle.api.tasks.testing.TestOutputListener) 在此任務上添加的監聽器。如果監聽器是使用 Gradle.addListener(java.lang.Object) 向 Gradle 註冊的，則此方法不會執行任何操作。請改用 Gradle.removeListener(java.lang.Object)。

reports(configureAction)

配置此任務可能產生的報告。

setTestNameIncludePatterns(testNamePattern)

設定要包含在執行中的測試名稱模式。支援類別或方法名稱，支援萬用字元 '*'。有關更多資訊，請參閱使用者指南中關於測試的章節。有關支援模式的更多資訊，請參閱 TestFilter

腳本區塊

區塊描述
reports

配置此任務可能產生的報告。

屬性詳細資訊

DirectoryProperty binaryResultsDirectory

內部二進制格式的測試結果根目錄屬性。

預設值
project.testResultsDir/binary/task.name

boolean ignoreFailures

指定當此任務執行的驗證失敗時，建置是否應該中斷。

TestTaskReports reports (唯讀)

此任務可能產生的報告。

方法詳細資訊

void addTestListener(TestListener listener)

為此任務註冊一個測試監聽器。也請考慮以下方便的方法，以便更快地掛鉤到測試執行： AbstractTestTask.beforeTest(groovy.lang.Closure), AbstractTestTask.afterTest(groovy.lang.Closure), AbstractTestTask.beforeSuite(groovy.lang.Closure), AbstractTestTask.afterSuite(groovy.lang.Closure)

此監聽器將不會收到由其他任務執行的測試通知。若要獲得該行為，請使用 Gradle.addListener(java.lang.Object)。

void addTestOutputListener(TestOutputListener listener)

為此任務註冊一個輸出監聽器。更快的掛鉤到輸出事件的方法是使用 AbstractTestTask.onOutput(groovy.lang.Closure) 方法。

void afterSuite(Closure closure)

添加一個閉包，以便在測試套件執行後收到通知。一個 TestDescriptor 和 TestResult 實例將作為參數傳遞給閉包。

此方法也在所有測試套件執行後呼叫。提供的描述符將具有一個 null 父套件。

void afterTest(Closure closure)

添加一個閉包，以便在測試執行後收到通知。一個 TestDescriptor 和 TestResult 實例將作為參數傳遞給閉包。

void beforeSuite(Closure closure)

添加一個閉包，以便在測試套件執行之前收到通知。一個 TestDescriptor 實例將作為參數傳遞給閉包。

此方法也在任何測試套件執行之前呼叫。提供的描述符將具有一個 null 父套件。

void beforeTest(Closure closure)

添加一個閉包，以便在測試執行之前收到通知。一個 TestDescriptor 實例將作為參數傳遞給閉包。

void onOutput(Closure closure)

添加一個閉包，以便在收到測試輸出時收到通知。一個 TestDescriptor 和 TestOutputEvent 實例將作為參數傳遞給閉包。

apply plugin: 'java'

test {
   onOutput { descriptor, event ->
       if (event.destination == TestOutputEvent.Destination.StdErr) {
           logger.error("Test: " + descriptor + ", error: " + event.message)
       }
   }
}

void removeTestListener(TestListener listener)

取消註冊此任務的測試監聽器。此方法僅會移除透過呼叫 AbstractTestTask.addTestListener(org.gradle.api.tasks.testing.TestListener) 在此任務上添加的監聽器。如果監聽器是使用 Gradle.addListener(java.lang.Object) 向 Gradle 註冊的，則此方法不會執行任何操作。請改用 Gradle.removeListener(java.lang.Object)。

void removeTestOutputListener(TestOutputListener listener)

取消註冊此任務的測試輸出監聽器。此方法僅會移除透過呼叫 AbstractTestTask.addTestOutputListener(org.gradle.api.tasks.testing.TestOutputListener) 在此任務上添加的監聽器。如果監聽器是使用 Gradle.addListener(java.lang.Object) 向 Gradle 註冊的，則此方法不會執行任何操作。請改用 Gradle.removeListener(java.lang.Object)。

TestTaskReports reports(Action<? super TestTaskReports> configureAction)

配置此任務可能產生的報告。

AbstractTestTask setTestNameIncludePatterns(List<String> testNamePattern)

設定要包含在執行中的測試名稱模式。支援類別或方法名稱，支援萬用字元 '*'。有關更多資訊，請參閱使用者指南中關於測試的章節。有關支援模式的更多資訊，請參閱 TestFilter

腳本區塊詳細資訊

reports { }

配置此任務可能產生的報告。

委派至
TestTaskReports 來自 reports