Android Koin升级至3.2.0后org.koin.androidx.viewmodel.koin包缺失问题

背景 #

我在Android应用中使用Koin框架，此前使用3.1.5版本，libs.versions.toml配置如下：

koin = "3.1.5"

koin-android = { module = "io.insert-koin:koin-android", version.ref = "koin" }
koin-androidx-workmanager = { module = "io.insert-koin:koin-androidx-workmanager", version.ref = "koin" }
koin-androidx-navigation = { module = "io.insert-koin:koin-androidx-navigation", version.ref = "koin" }
koin-androidx-compose = { module = "io.insert-koin:koin-androidx-compose", version.ref = "koin" }

[bundles]  
koin-android = ["koin-core", "koin-android", "koin-androidx-workmanager", "koin-androidx-compose", "koin-androidx-navigation"]

当时导入import org.koin.androidx.viewmodel.koin.getViewModel并可正常调用该方法。

问题 #

升级至3.2.0版本后，出现"Unresolved reference: koin"错误，原使用的org.koin.androidx.viewmodel.koin包无法找到。我尝试添加多个Koin依赖：

koin-core = { module = "io.insert-koin:koin-core", version.ref = "koin" }
koin-android = { module = "io.insert-koin:koin-android", version.ref = "koin" }
koin-androidx-workmanager = { module = "io.insert-koin:koin-androidx-workmanager", version.ref = "koin" }
koin-androidx-navigation = { module = "io.insert-koin:koin-androidx-navigation", version.ref = "koin" }
koin-androidx-compose = { module = "io.insert-koin:koin-androidx-compose", version.ref = "koin" }
koin-android-compat = { module = "io.insert-koin:koin-android-compat", version.ref = "koin" }
koin-androidx-viewmodel = { module = "org.koin:koin-androidx-viewmodel", version.ref = "koin" }
koin-androidx-scope = { module = "org.koin:koin-androidx-scope", version.ref = "koin" }
koin-androidx-fragment = { module = "org.koin:koin-androidx-fragment", version.ref = "koin" }
koin-androidx-lifecycle = { module = "androidx.lifecycle:lifecycle-viewmodel-savedstate", version.ref = "koin" }

甚至尝试升级到3.5.0版本，问题仍未解决，getKoin().getViewModel(...)无法正常运行。

补充：发现import org.koin.androidx.viewmodel.ext.android.getViewModel包，但无法适配现有代码：

getKoin().getViewModel(owner = {
  ViewModelOwner.fromAny(activity)
})

请问该包去向何处？若已合并，该方法在哪里可以找到？

1. API迁移说明 #

Koin 3.2+版本对ViewModel相关的扩展方法做了包结构与API调整：

• 原org.koin.androidx.viewmodel.koin.getViewModel（Koin实例的扩展方法）被移除，相关功能整合到了org.koin.androidx.viewmodel包下。
• ViewModelOwner.fromAny()方法被废弃，改用更明确的构造方式。

2. 适配现有代码的具体方案 #

方式一：通过Koin实例调用（适配原代码结构） #

首先确保依赖中包含正确的koin-androidx-viewmodel（3.2+版本统一使用io.insert-koin作为groupId）：

koin-androidx-viewmodel = { module = "io.insert-koin:koin-androidx-viewmodel", version.ref = "koin" }

然后导入正确的扩展方法，调整ViewModelOwner的构建：

import org.koin.androidx.viewmodel.getViewModel

// 适配原调用逻辑
val viewModel = getKoin().getViewModel(
    owner = ViewModelOwner.from(activity)
)

方式二：使用Android组件扩展方法（推荐） #

如果代码上下文是Activity或Fragment，直接用组件的扩展方法更简洁，无需调用getKoin()：

import org.koin.androidx.viewmodel.ext.android.getViewModel

// 在Activity/Fragment内直接调用
val viewModel = getViewModel(owner = { ViewModelOwner.from(activity) })

3. 精简依赖配置 #

无需添加多余依赖，3.2+版本推荐的libs.versions.toml配置如下：

koin = "3.5.0"

koin-core = { module = "io.insert-koin:koin-core", version.ref = "koin" }
koin-android = { module = "io.insert-koin:koin-android", version.ref = "koin" }
koin-androidx-workmanager = { module = "io.insert-koin:koin-androidx-workmanager", version.ref = "koin" }
koin-androidx-navigation = { module = "io.insert-koin:koin-androidx-navigation", version.ref = "koin" }
koin-androidx-compose = { module = "io.insert-koin:koin-androidx-compose", version.ref = "koin" }
koin-androidx-viewmodel = { module = "io.insert-koin:koin-androidx-viewmodel", version.ref = "koin" }

[bundles]  
koin-android = ["koin-core", "koin-android", "koin-androidx-workmanager", "koin-androidx-compose", "koin-androidx-navigation", "koin-androidx-viewmodel"]

内容的提问来源于stack exchange，提问作者Tobias Reich