XCTest

API 文件XCTest

執行 XCTest 測試。測試始終在單次執行中運行。

屬性

屬性描述
binaryResultsDirectory

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

ignoreFailures

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

reports

此任務可能產生的報告。

runScriptFile

返回測試套件組合或可執行檔位置

testInstallDirectory

測試套件組合或可執行檔位置

workingDirectory

此測試的工作目錄屬性。

方法

方法描述
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)

新增一個閉包,以便在測試套件執行後收到通知。 TestDescriptorTestResult 實例會作為參數傳遞給閉包。

afterTest(closure)

新增一個閉包,以便在測試執行後收到通知。 TestDescriptorTestResult 實例會作為參數傳遞給閉包。

beforeSuite(closure)

新增一個閉包,以便在測試套件執行前收到通知。 TestDescriptor 實例會作為參數傳遞給閉包。

beforeTest(closure)

新增一個閉包,以便在測試執行前收到通知。 TestDescriptor 實例會作為參數傳遞給閉包。

onOutput(closure)

新增一個閉包,以便在收到來自測試的輸出時收到通知。 TestDescriptorTestOutputEvent 實例會作為參數傳遞給閉包。

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

腳本區塊

沒有腳本區塊

屬性詳細資訊

DirectoryProperty binaryResultsDirectory

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

預設
project.testResultsDir/binary/task.name

boolean ignoreFailures

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

TestTaskReports reports (唯讀)

此任務可能產生的報告。

RegularFileProperty runScriptFile

返回測試套件組合或可執行檔位置

DirectoryProperty testInstallDirectory

測試套件組合或可執行檔位置

DirectoryProperty workingDirectory

此測試的工作目錄屬性。

方法詳細資訊

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)

新增一個閉包,以便在測試套件執行後收到通知。 TestDescriptorTestResult 實例會作為參數傳遞給閉包。

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

void afterTest(Closure closure)

新增一個閉包,以便在測試執行後收到通知。 TestDescriptorTestResult 實例會作為參數傳遞給閉包。

void beforeSuite(Closure closure)

新增一個閉包,以便在測試套件執行前收到通知。 TestDescriptor 實例會作為參數傳遞給閉包。

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

void beforeTest(Closure closure)

新增一個閉包,以便在測試執行前收到通知。 TestDescriptor 實例會作為參數傳遞給閉包。

void onOutput(Closure closure)

新增一個閉包,以便在收到來自測試的輸出時收到通知。 TestDescriptorTestOutputEvent 實例會作為參數傳遞給閉包。

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