版本發佈與升級指南
本頁列出了每個主要的 Koin 版本,以便您規劃升級並檢查相容性。每個版本都遵循相同的結構:
- Kotlin:建置 Koin 所使用的 Kotlin 版本。
- New:新功能與改進。
- Experimental:標記為
@KoinExperimentalAPI的 API,這些 API 仍可能變更。 - Deprecated:標記為即將移除的 API,並提供其替代方案。
- Breaking:升級時需要在程式碼中進行相應更新的變更。
- Bug fixes(錯誤修正)、Improvements(改進)、Library updates(程式庫更新):當該版本包含時顯示。
實驗性與棄用的定義請參閱 API Stability。
版本列表
| 版本 | Kotlin | 狀態 | 主要變更 |
|---|---|---|---|
| 4.2.2 | 2.3.20 | 穩定版 | Resolver 迴歸修正、ViewModel 與作用域修正、tvOS、R8/ProGuard 規則 |
| 4.2.1 | 2.3.20 | 前一穩定版 | 作用域解析修正、ABI 還原、效能 |
| 4.2.0 | 2.3.20 | 前一穩定版 | @KoinApplication 與 @Configuration、Ktor 3.4 DI 橋接、Navigation 3、Dagger 橋接 |
| 4.1.1 | 2.1.21 | 前一穩定版 | Navigation 改進、解析器效能 |
| 4.1.0 | 2.1.20 | 前一穩定版 | 作用域原型、功能選項、Ktor KMP |
| 4.0.4 | 2.0.21 | 前一穩定版 | 穩定的 ViewModel API、UUID 產生 |
| 3.5.6 | 1.9.22 | LTS | Kotlin 1.x 的長期支援版本分支、隔離上下文 |
| 3.4.3 | 1.8.21 | 舊版 | 驗證 API、ExtensionManager |
目前版本:Koin 4.2.2 以及 Koin Compiler Plugin 1.2.1(請參閱 Koin Compiler Plugin)。
NOTE
並行維護兩條 LTS 分支:適用於 Kotlin 1.x 專案的 Koin 3.5.6,以及適用於 Kotlin 2.x 專案的 Koin 4.2.x。請選擇符合您 Kotlin 基準版本的版本。有關支援政策,請參閱 Long-Term Support。
4.2.2
Kotlin 2.3.20。
4.2.x 分支的維護版本:修正 4.2.0 中重寫 CoreResolverV2 所引入的解析器迴歸問題、ViewModel 與作用域修正、Ktor 請求作用域修正、tvOS 支援以及 R8/ProGuard 規則。
WARNING
如果您在 4.2.0 或 4.2.1 上遇到解析器問題,請升級至 4.2.2。
新功能
koin-core-viewmodel
- tvOS 目標(
tvosArm64、tvosX64、tvosSimulatorArm64),使 ViewModel 可在 tvOS 上使用。
koin-android / koin-core-viewmodel
- 消費者 R8/ProGuard 規則現已隨附於 AAR 中,並附有新的 R8/ProGuard 指南。
錯誤修正
koin-core
- 修正 #2370、#2408:堆疊參數(
parametersOf)可能會遮蔽具有限定符的get(named(...))請求。限定查詢現在只讀取註冊表,絕不讀取參數堆疊。 - 修正 #2379:在根作用域定義的非
single工廠,從子作用域解析時,其作用域相依性會針對_root_解析而非請求作用域。連結作用域解析現在會針對請求作用域執行工廠。 - 修正 #2299:使用
viewModelScopeFactory()建立的作用域未連結至其原始作用域,導致無法解析父級中宣告的相依性。建立的作用域現已連結至其父級(父級為根時除外)。 - 修正 #2348:由於未檢查的 map 轉換,載入帶有非
String值的環境或系統屬性會拋出ClassCastException。非String值現在保留為Any。 - 修正 #2044、#2417:在沒有適當 extras 的情況下解析
SavedStateHandle,或在沒有viewModelScopeFactory()選項的情況下使用viewModelScope { },現在會提供具體可行的錯誤訊息。
koin-ktor
- 修正 #2410:並行請求可能會在請求作用域 ID 上發生衝突。ID 現在由啟動時初始化一次的單調計數器產生(由 @lfavreli-betclic 貢獻)。
改進
koin-core
bind()和binds()現在以 O(1) 追加次要型別,而不是為每次繫結重新分配型別清單。這消除了當定義宣告許多繫結時的平方級開銷。
文件
- 在 Navigation 3 參考資料 中新增了搭配型別化
entryProvider使用 Koin 的指南(#2336)。
4.2.1
Kotlin 2.3.20。
4.2.0 之上的修補版本:作用域解析修正、ABI 還原以及更好的診斷。
新功能
koin-core
- 更清晰的作用域解析錯誤訊息。
錯誤修正
koin-core
- 修正 #2387:
CoreResolverV2在連結作用域上遺失了堆疊參數查詢。 - 還原了
runOnKoinStarted的 ABI 相容性。現在會在 CI 中執行 API 檢查以防止迴歸。 - 關閉作用域的並行修正(volatile 標記),由 @inemtsev 貢獻。
- 為作用域
ViewModel和SavedStateHandleViewModel 新增了測試。
4.2.0
Kotlin 2.3.20。所有程式庫版本皆可在 libs.versions.toml 中查看。
新功能
koin-core
- 全新的
CoreResolverV2:更快存取堆疊參數、子作用域與 ViewModel 作用域解析、針對每個作用域最佳化ThreadLocal載入。 KoinApplication.withConfiguration<T>()擴充方法:將KoinApplication與 Koin Compiler Plugin 從@KoinApplication類別中探索到的模組連接起來。koinConfiguration<T>()DSL:編譯器外掛程式進入點,用於從帶有註解的類別建置KoinConfiguration。- 作用域解析與執行緒安全性的效能最佳化。
koin-android
koinActivityInject:從目前的Activity作用域擷取相依項。
koin-androidx-startup
onKoinStartup { }:透過 AndroidX Startup 的InitializerAPI 啟動 Koin。KoinConfiguration型別與KoinStartup更新(KoinInitializer維持實驗性)。
koin-ktor:Ktor 3.4 整合
- 全新的 Koin 與 Ktor DI 橋接,建構於官方 Ktor 3.4 DI API 之上。
KoinDependencyMap:Koin 直接透過 Ktor DI 解析執行個體。KoinKtorApplication:DSL 橋接,提供 Ktor 到 Koin 以及 Koin 到 Ktor 裝配的明確選項。Application.koinModule與Application.koinModules擴充方法現在是宣告模組的建議方式。
koin-compose-navigation3(新模組)
- 支援 Jetpack Navigation 3(穩定版 1.0.0)。
- 泛型
EntryProvider:將元資料參數(動畫等)傳遞給導覽項目。 - 適用於 Compose Navigation 2 的導覽作用域輔助程式。
koin-dagger-bridge(新模組)
- 從 Dagger 端注入 Koin 元件,用於從 Dagger 平滑遷移至 Koin。
koin-core-annotations(由編譯器外掛程式使用)
@KoinApplication:將類別標記為 Koin 應用程式進入點。接著startKoin<MyApp>()會組裝所有探索到的@Configuration模組。@Configuration("name"):將@Module類別分組為不同配置(例如prod、test、default)。具有相同配置標籤的模組可以看到彼此的定義。@PropertyValue("key"):@Property注入的預設值。@ScopeId(name = "...")與@ScopeId(MyScope::class):從具名的 Koin 作用域注入值。@Monitor:使用 Kotzilla SDK 追蹤(執行時間)包裝帶有註解的函式。請參閱 @Monitor。@Provided可被整個安全圖識別:它會跳過對外部提供型別的編譯期驗證。
實驗性功能
koin-core
@KoinApplication(modules = [...]):明確的modules陣列允許進入點繞過探索,並使用固定的模組清單。
koin-androidx-startup
- 整個
koin-androidx-startupAPI 維持實驗性。KoinInitializer標記為@KoinExperimentalAPI。
棄用
koin-android / koin-android-annotation
org.koin.android.annotation.KoinViewModel已棄用。請改用org.koin.core.annotation.KoinViewModel。
koin-ktor
koin-ktor3構件已合併至koin-ktor(在 4.1.0 中棄用,在 4.2.0 中完全合併)。
破壞性變更
koin-android
- 最低 SDK 從 21 提升至 23,以與 Koin 使用的 AndroidX 程式庫保持一致。
koin-compose-navigation3
- 最低 API 等級 23。
koin-core
Module.getAll(...)不再對結果進行排序。執行個體將依宣告順序傳回。如果您依賴特定順序,請明確進行排序。
Koin Compiler Plugin
目前版本:1.2.1。需要 Koin 4.2.0 或更高版本以及 Kotlin K2 編譯器(已在 2.3.20、2.4.0、2.4.10、2.4.20 上驗證)。
Koin Compiler Plugin 是原生 Kotlin 編譯器外掛程式。它取代了基於 KSP 的 Koin Annotations 處理器,並作為 Kotlin 編譯的一部分執行,無需 KSP 步驟。安裝與 Gradle 選項請參閱 Compiler Plugin Setup 和 Compiler Plugin Options。它所驗證的內容請參閱 Compile-Time Safety。它支援所有 Kotlin Multiplatform 目標:JVM、JS、Wasm、iOS、macOS、watchOS、tvOS、Linux 與 Windows。
若要從 koin-ksp-compiler 遷移,請參閱 Migrating from KSP to the Compiler Plugin。
1.2.1
支援 Kotlin 2.4.20,並修正了在實際 KMP 應用程式中發現的兩個問題。
- Kotlin 2.4.20:在 1.2.0 中,任何使用 Kotlin 2.4.20 的專案在 IR 產生期間均因
NoSuchMethodError而失敗(#89、#99)。Kotlin 2.4.20 移除或變更了外掛程式使用的四個編譯器 API 的簽章。這四個問題均已修正。 - KLIB 修正:當
@Configuration模組透過相依性轉發時,wasmJs、JS 和 Kotlin/Native 組建在componentscan_*提示上出現Different declarations with the same signatures were detected錯誤。JVM 和 Android 不受影響。 - 限定符修正:跨模組讀取時,同一型別的兩個
@Named提供者合併為一個,從而導致誤報的KOIN-D001。如果您因 D001 誤報錯誤而關閉了compileSafety,請重新開啟進行檢查。 - 嚴格 Kotlin 版本檢查:現在只有經過完全相符版本檢查的 Kotlin 版本才算已驗證。未驗證的版本會發出警告並繼續執行,絕不封鎖。
請參閱 1.2.1 release notes。
1.2.0
編譯期安全性現已涵蓋整個 Koin DSL,且跨模組的 includes 不再隱藏定義。
- 建構函式 DSL 驗證:
singleOf(::T)、factoryOf(::T)、scopedOf(::T)、viewModelOf(::T)與Scope.new(::T)獲得與single<T>()相同的缺失相依性及限定符檢查。先前依賴於此處未檢查缺失相依性的程式碼現在將無法通過編譯。這是補齊檢查缺口,並非迴歸錯誤。 - 新進入點:
KoinApplication.withConfiguration<T>()與 Ktor 的install(Koin) { modules(...) }。 - 模組清單:
startKoin { modules(myList) }可解析listOf、+、.toList()以及回傳List<Module>的函式。在執行階段具有分支的清單仍保持未解析狀態,且KOIN-W003會指向該呼叫。 - 模組函式:
fun myModule(): Module = module { ... }會像頂層val一樣被追蹤。 - 跨模組修正:間隔兩個或更多
implementation跳躍的定義在透過@Module(includes)(#82)、@Configuration自動探索以及 DSLincludes(...)時先前是不可見的。複數binds(...)現已被識別,且@Module(includes)不再合併僅限定符不同的提供者(#94)。 - 手寫 Lambda:
single { X(get()) }會透過其自身的get()呼叫進行驗證,而不是從建構函式進行猜測。這消除了KOIN-D004循環的誤報。
請參閱 1.2.0 release notes。
1.1.0
僅進行全圖驗證。移除了個別模組驗證,改為在每個 Koin 進入點(startKoin、koinApplication、@KoinApplication)進行一次全圖檢查。這消除了實質的跨模組誤報。權衡之處在於:在編譯時自身沒有進入點的葉模組或程式庫模組,在有其他模組圍繞其組裝成真實的圖之前,不會獲得編譯期安全診斷。
請參閱 1.1.0 release notes。
4.1.1
Kotlin 2.1.21。
新功能
koin-compose-viewmodel-navigation
sharedKoinViewModel具有可選的navGraphRoute參數,適用於 Compose Navigation。
koin-core
- 核心解析器最佳化:在單一作用域中解析時不再進行不必要的扁平化。
- 作用域偵錯會顯示連結的作用域 ID。
程式庫更新
- Kotlin:2.1.21(原為 2.1.20)
- Ktor:3.2.3(原為 3.1.3)
- JetBrains Compose:1.8.2(原為 1.8.0)
- AndroidX:Fragment 1.8.9、WorkManager 2.10.3、Lifecycle 2.9.3、Navigation 2.9.3
- 測試:Robolectric 4.15.1、Benchmark 0.4.14
- 建置:Binary Validator 0.18.1、NMCP 1.1.0
錯誤修正
koin-core
- 還原了導致相容性錯誤的記錄器條件約束。
- 修正了 Compose 作用域解析,提供更好的
LocalKoinApplication與LocalKoinScope上下文處理。
koin-build
- 修正 Maven Central 發佈問題。
4.1.0
Kotlin 2.1.20。
新功能
koin-core
KoinConfigurationAPI,用於包裝 Koin 配置。- 作用域原型:針對某類作用域的專用作用域型別限定符。現在可以針對某個作用域類別(即原型)來解析執行個體。
- 功能選項:Koin 內部新行為的功能旗標。在 Koin 配置的
options區塊中啟用選項:
startKoin {
options(
// activate a new feature
viewModelScopeFactory()
)
}- 全新
CoreResolver,包含ResolutionExtension以允許 Koin 從外部系統或資源進行解析(用於連接 Ktor DI)。
koin-android
- 升級的程式庫(
androidx.appcompat:appcompat:1.7.0、androidx.activity:activity-ktx:1.10.1)將最低 SDK 從 14 提升至 21。 - 模組 DSL 擴充方法
activityScope、activityRetainedScope與fragmentScope,用於為 Activity 或 Fragment 宣告作用域。 - 函式
activityScope()、activityRetainedScope()與fragmentScope()現在使用作用域原型。
koin-androidx-compose
- 與 Koin Compose Multiplatform、Compose 1.8 及 Lifecycle 2.9 對齊。
koin-compose
- 與 Compose 1.8 和 Lifecycle 2.9 對齊。
KoinApplicationPreview,用於在 Android Studio 與 IntelliJ IDEA 中平行轉譯預覽。
koin-compose-viewmodel
koinActivityViewModel,使用父 Activity 作為 ViewModel 主機。
koin-ktor
- 多平台:此模組現已為 Kotlin Multiplatform 建置。您可以在多平台專案中使用
koin-ktor。 - 先前的
koin-ktor3模組已合併至koin-ktor。 Application.koinModule { }與Application.koinModules(),用於直接在 Ktor 模組中宣告 Koin 模組:
fun Application.customerDataModule() {
koinModule {
singleOf(::CustomerRepositoryImpl) bind CustomerRepository::class
}
}Module.requestScope:在 Ktor 請求作用域內宣告定義,無需手動宣告scope<RequestScope>。請求作用域也可以在建構函式中注入ApplicationCall。
koin-core-coroutines
ModuleConfiguration:將模組配置收集在單一結構中,以便後續驗證。
val m1 = module {
single { Simple.ComponentA() }
}
val lm1 = lazyModule {
single { Simple.ComponentB(get()) }
}
val conf = moduleConfiguration {
modules(m1)
lazyModules(lm1)
}- Koin 配置可以從
ModuleConfiguration載入模組:
startKoin {
moduleConfiguration {
modules(m1)
lazyModules(lm1)
}
}
// or even
val conf = moduleConfiguration {
modules(m1)
lazyModules(lm1)
}
startKoin {
moduleConfiguration(conf)
}koin-test-coroutines
- 全新的
koin-test-coroutines模組,提供協同程式相關的測試 API。 - Verify API 可以檢查混合一般模組與延遲載入模組的
moduleConfiguration:
val conf = moduleConfiguration {
modules(m1)
lazyModules(lm1)
}
conf.verify()
// if you want Android types (koin-android-test)
conf.verify(extraTypes = androidTypes)koin-core-annotations
@InjectedParam與@Provided將屬性標記為注入參數或動態提供。目前供VerifyAPI 使用。
實驗性功能
koin-core
- Wasm:使用 Kotlin 2.1.20 的 UUID 產生機制。
koin-core-viewmodel
- 模組 DSL 擴充方法
viewModelScope,用於宣告範圍限定於 ViewModel 作用域原型的元件。 viewModelScope()函式:建立繫結至 ViewModel 類別的作用域。它使用ViewModelScopeAutoCloseable(AutoCloseableAPI)來關閉作用域,因此您不再需要手動關閉 ViewModel 作用域。ScopeViewModel類別更新:開箱即用的 ViewModel 作用域類別,負責處理作用域的建立與關閉。- 透過
viewModelScopeFactory選項從 ViewModel 的作用域進行建構函式注入:
startKoin {
options(
// activate a new ViewModel scope creation
viewModelScopeFactory()
)
}
// will inject Session from MyScopeViewModel's scope
class MyScopeViewModel(val session: Session) : ViewModel()
module {
viewModelOf(::MyScopeViewModel)
viewModelScope {
scopedOf(::Session)
}
}koin-compose
KoinMultiplatformApplication函式:Compose Multiplatform 進入點。
koin-core-viewmodel-navigation
sharedViewModel擴充方法,用於重用導覽NavBackStackEntry中的 ViewModel 執行個體。
koin-test
VerifyAPI 現在會檢查可為 null、延遲載入以及清單參數。將屬性標記為@InjectedParam或@Provided,以將其宣告為注入參數或動態提供,而無需在 Verify 呼叫中聲明。
// now detected in Verify
class ComponentB(val a: ComponentA? = null)
class ComponentBParam(@InjectedParam val a: ComponentA)
class ComponentBProvided(@Provided val a: ComponentA)棄用
koin-android
ScopeViewModel已棄用。請改用koin-core-viewmodel中的ScopeViewModel類別。
koin-compose
KoinContext已棄用且可移除:Koin 上下文現在已在目前的預設上下文上準備就緒。
koin-androidx-compose
KoinAndroidContext已棄用且可移除:Koin 上下文現在已在目前的預設上下文上準備就緒。
koin-androidx-compose-navigation
- 在 Lifecycle 程式庫更新後不再需要
koinNavViewModel。請將其替換為koinViewModel。
koin-core-viewmodel-navigation
- 在 Lifecycle 程式庫更新後不再需要
koinNavViewModel。請將其替換為koinViewModel。
koin-ktor
Application.koin已棄用,建議改用Application.koinModules與Application.koinModule。
破壞性變更
koin-android
- 舊的 state ViewModel API 已移除:
stateViewModel()、getStateViewModel():改用viewModel()。getSharedStateViewModel()、sharedStateViewModel():改用viewModel(),共用執行個體則改用activityViewModel()。
koin-compose
- 舊的 Compose API 函式已移除:
inject():改用koinInject()。getViewModel():改用koinViewModel()。rememberKoinInject():已合併至koinInject()。
rememberKoinApplication被標記為@KoinInternalApi。
4.0.4
Kotlin 2.0.21。
所有程式庫版本皆可在 libs.versions.toml 中查看。
新功能
koin-core
KoinPlatformTools.generateId()現在使用 Kotlinkotlin.uuidAPI,並在所有平台上產生真實的 UUID。
koin-viewmodel
- Koin 4.0 引入了跨 Google 和 JetBrains KMP API 共用的 ViewModel DSL 與 API。為了避免重複,ViewModel API 現在位於
koin-core-viewmodel和koin-core-viewmodel-navigation中。 - ViewModel DSL 匯入路徑為
org.koin.core.module.dsl.*。
koin-core-coroutines:整個 API 現已穩定
- 所有
lazyModules awaitAllStartJobs、onKoinStarted、isAllStartedJobsDonewaitAllStartJobs、runOnKoinStartedKoinApplication.coroutinesEngineModule.includes(lazy)lazyModule()KoinPlatformCoroutinesTools
實驗性功能
koin-test
ParameterTypeInjection:為VerifyAPI 宣告動態參數注入。
koin-androidx-startup
- 透過
androidx.startup.InitializerAPI 使用 AndroidX Startup 啟動 Koin。整個koin-androidx-startupAPI 均為實驗性。
koin-compose
rememberKoinModules:使用@Composable載入與卸載 Koin 模組。rememberKoinScope:使用@Composable載入與卸載 Koin 作用域。KoinScope:為所有子 Composable 載入 Koin 作用域。
棄用
koin-test
- 整個
checkModulesAPI。請遷移至VerifyAPI。
koin-android
- Android ViewModel DSL 已棄用,建議改用
koin-core中的共用 DSL。 - state ViewModel API(設為錯誤等級):
stateViewModel()、getStateViewModel():改用viewModel()。getSharedStateViewModel()、sharedStateViewModel():改用viewModel(),共用執行個體則改用activityViewModel()。
koin-compose
- 舊的 Compose API 函式(設為錯誤等級):
inject():改用koinInject()。getViewModel():改用koinViewModel()。rememberKoinInject():改用koinInject()。
koin-compose-viewmodel
- ViewModel DSL 已棄用,建議改用
koin-core中的共用 DSL。 koinNavViewModel已棄用,改用koinViewModel。
破壞性變更
在前一個里程碑中棄用後,下列 API 已被移除。所有帶有 @KoinReflectAPI 註解的 API 也一併移除。
koin-core
ApplicationAlreadyStartedException更名為KoinApplicationAlreadyStartedException。KoinScopeComponent.closeScope()已移除(內部不再使用)。- 內部的
ResolutionContext取代了InstanceContext。 KoinPlatformTimeTools、Timer和measureDuration已移除。請使用 Kotlin Time API。KoinContextHandler已移除,改用GlobalContext。
koin-android
Fragment.createScope()已移除。- ViewModel 工廠 API(主要為內部使用)已針對新的內部架構重新設計。
koin-compose
StableParametersDefinition已移除(內部不再使用)。- 延遲 ViewModel API(舊的
viewModel())已移除。 rememberStableParametersDefinition()已移除(內部不再使用)。
3.5.6
Kotlin 1.9.22。
所有程式庫版本皆可在 libs.versions.toml 中查看。
新功能
koin-core
KoinContext包含新函式:fun loadKoinModules(module: Module, createEagerInstances: Boolean = false)fun loadKoinModules(modules: List<Module>, createEagerInstances: Boolean = false)
koinApplication()具有多種簽章:koinApplication(createEagerInstances: Boolean = true, appDeclaration: KoinAppDeclaration? = null)koinApplication(appDeclaration: KoinAppDeclaration?)koinApplication(createEagerInstances: Boolean)
KoinAppDeclaration,開放更多宣告樣式。KoinPlatformTimeTools,以便在 JS 上使用 Time API。- iOS:
synchronizedAPI 使用 Touchlab Lockable API。
koin-androidx-compose
KoinAndroidContext,用於從 Android 環境繫結至目前的 Koin 上下文。
koin-compose
KoinContext,以目前的預設上下文啟動。
koin-ktor
- 為 Ktor 執行個體使用隔離上下文(使用
Application.getKoin()而非預設上下文)。 - Koin Ktor 外掛程式中的新監控功能。
RequestScope,將執行個體限制在 Ktor 請求的作用域內。
實驗性功能
koin-android
ViewModelScope:適用於 ViewModel 作用域的實驗性 API。
koin-core-coroutines
- 在背景載入模組的新 API。
棄用
koin-android
getLazyViewModelForClass():較複雜,且會呼叫預設的全域上下文。請使用 Activity 和 Fragment API。resolveViewModelCompat()已棄用,建議改用resolveViewModel()。
koin-compose
get()和inject()已棄用,建議改用koinInject()。getViewModel()已棄用,建議改用koinViewModel()。rememberKoinInject()已棄用,建議改用koinInject()。
破壞性變更
koin-core
Koin.loadModules(modules: List<Module>, allowOverride: Boolean = true, createEagerInstances: Boolean = false)取代了Koin.loadModules(modules: List<Module>, allowOverride: Boolean = true)。KoinExtension.koin屬性被KoinExtension.onRegister()函式取代。- iOS:
internal fun globalContextByMemoryModel(): KoinContext使用MutableGlobalContext。
koin-compose
KoinApplication(moduleList: () -> List<Module>, content: @Composable () -> Unit)已移除,改用KoinContext和KoinAndroidContext。
3.4.3
Kotlin 1.8.21。
新功能
koin-core
ExtensionManagerAPI,用於為 Koin 編寫擴充引擎(ExtensionManager與KoinExtension)。- 參數 API:
parameterArrayOf和parameterSetOf。
koin-test
VerificationAPI,用於在模組上執行verify()。
koin-android
- 重新設計了 ViewModel 注入的內部機制。
AndroidScopeComponent.onCloseScope()回呼。
koin-android-test
VerificationAPI,用於在模組上執行androidVerify()。
koin-androidx-compose
get()。getViewModel()。- 作用域
KoinActivityScope與KoinFragmentScope。
koin-androidx-compose-navigation(新模組)
koinNavViewModel()。
koin-compose(Compose 的新 Multiplatform API)
koinInject與rememberKoinInject。KoinApplication。
實驗性功能
koin-compose
rememberKoinModules。KoinScope與rememberKoinScope。
棄用
koin-compose
inject()已棄用,建議改用get()以避免延遲函式。viewModel()已棄用,建議改用getViewModel()以避免延遲函式。
破壞性變更
koin-android
LifecycleScopeDelegate已移除。
koin-androidx-compose
getStateViewModel已移除,改用koinViewModel。
相關主題
- API Stability:實驗性、棄用與內部的意涵。
- Versions, Roadmap & Support:發佈週期與 LTS 分支。
- Compiler Plugin Setup:安裝或升級 Koin Compiler Plugin。
- Migrating from KSP to the Compiler Plugin:從 KSP 處理器遷移。
- Gradle Setup:Koin 構件與 BOM。
