驗證你的配置
本頁面介紹 verify()(無需執行即可檢查 Koin 配置的測試 API)以及已棄用的 checkModules()。此外還會說明這兩者與 Koin Compiler Plugin 的編譯期檢查之間的關係,以協助你了解是否仍需要它們。你應該已經了解如何撰寫使用 Koin 的單元測試。
你仍需要 verify() 嗎?
Koin Compiler Plugin 會在建置時檢查完整的相依圖:缺少的定義、限定詞不符、作用域錯誤以及 get() / inject() 呼叫點。當它已涵蓋你的專案時,verify() 測試不會帶來任何額外好處,你可以將其刪除。
在下列情況下,你仍需要 verify():
- 未使用 Compiler Plugin:你的專案在沒有外掛程式的情況下使用 Constructor 或 Classic DSL。(已棄用的註解 KSP 處理器有其專屬的
KOIN_CONFIG_CHECK選項。) - 建置時無法得知相依圖:外掛程式無法解析透過
if/when或可變參數(varargs)構建的模組清單。它會回報KOIN-W003並略過該入口點的檢查。 - 函式庫模組:未擁有獨立
startKoin/@KoinApplication的函式庫或功能模組,在應用程式將其組裝之前不會進行缺少相依性檢查。在函式庫中編寫verify()測試可以對其單獨進行檢查。 - 延遲載入模組:你使用延遲載入模組載入相依圖的一部分,並希望針對完整配置進行單一測試(請參閱模組與延遲載入模組結合使用)。
verify()
verify() 是 Module 的擴充函式,可於 koin-test 中的 JVM 上使用。它會讀取每個定義類別的建構函式,並檢查每個參數型別在該模組或其包含的模組中是否有對應的定義。它不會執行任何定義,也不需要 mock。
val appModule = module {
includes(dataModule, networkModule)
viewModel<UserViewModel>()
}import org.koin.test.verify.verify
class AppModuleCheck {
@Test
fun checkKoinModule() {
appModule.verify()
}
}當缺少相依性時,verify() 會拋出 MissingKoinDefinitionException 並輸出建議的修復方式。當兩個建構函式之間存在循環相依時,它會拋出 CircularInjectionException。
若要檢查多個未透過 includes() 連結的模組,請使用 listOf(dataModule, uiModule).verifyAll()。
verify() 接受的條件
建構函式參數在符合下列情況時即通過檢查:
- 已宣告:該型別的定義存在於模組樹中。
- 選填:該參數具有預設值。如果不存在定義,
verify()會輸出警告。 - 已包裝:其
T已宣告的Lazy<T>或List<T>。 - 列入白名單:其型別在
extraTypes中,或是基本型別(String、Int、Long、Double)。 - 注入或提供:該參數帶有
@InjectedParam或@Provided註解,或是使用injections宣告。
verify() 僅讀取建構函式。它不會檢查定義 Lambda 內部編寫的限定詞、屬性或 get() 呼叫。
於執行階段提供的型別
某些型別從未在模組中宣告:例如架構物件,或是由平台建立的值。請將它們新增至 extraTypes:
appModule.verify(
extraTypes = listOf(HttpClientEngine::class, Clock::class)
)在 Android 上,請使用來自 koin-android-test 的 androidVerify()。它會自動為你加入 Context、Activity、Fragment、Application、SavedStateHandle 和 WorkerParameters:
import org.koin.android.test.verify.androidVerify
@Test
fun checkKoinModule() {
appModule.androidVerify()
}注入的參數
透過 parametersOf() 傳遞的參數沒有定義,因此 verify() 會將其回報為缺少。請使用 injections 宣告它:
class UserPresenter(val userId: String, val repository: UserRepository)
val presenterModule = module {
factory { (userId: String) -> UserPresenter(userId, get()) }
}
@Test
fun checkKoinModule() {
presenterModule.verify(
injections = injectedParameters(
definition<UserPresenter>(String::class)
)
)
}或者為建構函式參數加上註解。@InjectedParam 標記透過 parametersOf() 傳遞的值,@Provided 標記在 Koin 模組外部提供的型別:
class UserPresenter(@InjectedParam val userId: String, val repository: UserRepository)
class SyncWorker(@Provided val params: WorkerParameters, val repository: UserRepository)這兩個註解皆來自 koin-core-annotations,且與 Compiler Plugin 讀取的註解相同(請參閱注入的參數)。
模組與延遲載入模組結合使用
koin-test-coroutines 為 ModuleConfiguration 增加了 verify(),可將常規模組與延遲載入模組作為單一相依圖一起檢查:
val configuration = moduleConfiguration {
modules(coreModule)
lazyModules(featureModule)
}
@Test
fun checkConfiguration() {
configuration.verify()
}moduleConfiguration 與此 verify() 皆屬於實驗性功能(@KoinExperimentalAPI)。
checkModules()(已棄用)
WARNING
checkModules()、checkKoinModules() 及其 DSL 已被棄用。請遷移至 verify() 或 Compiler Plugin。
與 verify() 不同的是,checkModules() 會啟動模組並建立每個定義,因此它需要執行階段解析的所有項目的值。你可能會在較舊的專案中看到它:
@Test
fun checkAllModules() {
koinApplication {
modules(appModule)
checkModules {
withInstance<Context>()
withParameter<UserPresenter> { "user-1" }
withProperty("api_url", "http://localhost")
}
}
}
// or
@Test
fun checkAllModules() {
checkKoinModules(listOf(appModule))
}檢查 DSL 包含:
withInstance(value):將value新增至相依圖。withInstance<T>()會新增T的 mock,並且需要MockProviderRule(請參閱使用 declareMock 進行 Mock)。withParameter<T> { value }:用於建立T的注入參數。若有多個參數,請使用withParameters<T> { parametersOf(a, b) }。withProperty(key, value):新增一個 Koin 屬性。withScopeLink(scope, targetScope):為檢查連結兩個作用域。
若要遷移至 verify():移除架構型別的 withInstance(改用 extraTypes 或 androidVerify()),並將 withParameter 替換為 injections 或 @InjectedParam。
