Android ViewModel 与 Navigation

koin-android Gradle 模块引入了一个新的 viewModel DSL 关键字，作为对 single 和 factory 的补充，用于帮助声明 ViewModel 组件并将其绑定到 Android 组件生命周期。viewModelOf 关键字也可用，允许你使用其构造函数声明 ViewModel。

val appModule = module {

    // ViewModel for Detail View
    viewModel { DetailViewModel(get(), get()) }

    // or directly with constructor
    viewModelOf(::DetailViewModel)

}

你声明的组件必须至少继承 android.arch.lifecycle.ViewModel 类。你可以指定如何注入类的构造函数，并使用 get() 函数注入依赖项。

INFO

viewModel/viewModelOf 关键字有助于声明 ViewModel 的工厂实例。此实例将由内部 ViewModelFactory 处理，并在需要时重新关联 ViewModel 实例。它也允许注入参数。

注入你的 ViewModel

要在 Activity、Fragment 或 Service 中注入 ViewModel，请使用：

• by viewModel() - 惰性委托属性，用于将 ViewModel 注入到属性中
• getViewModel() - 直接获取 ViewModel 实例

class DetailActivity : AppCompatActivity() {

    // Lazy inject ViewModel
    val detailViewModel: DetailViewModel by viewModel()
}

NOTE

ViewModel 键是根据 Key 和/或 Qualifier 计算的。

Activity 共享 ViewModel

一个 ViewModel 实例可以在 Fragment 及其宿主 Activity 之间共享。

要在 Fragment 中注入一个共享 ViewModel，请使用：

• by activityViewModel() - 惰性委托属性，用于将共享 ViewModel 实例注入到属性中
• getActivityViewModel() - 直接获取共享 ViewModel 实例

NOTE

sharedViewModel 已被弃用，推荐使用 activityViewModel() 函数。后者的命名更具表述性。

只需声明 ViewModel 一次即可：

val weatherAppModule = module {

    // WeatherViewModel declaration for Weather View components
    viewModel { WeatherViewModel(get(), get()) }
}

注意：ViewModel 的限定符（qualifier）将被视为 ViewModel 的 Tag。

并在 Activity 和 Fragment 中复用它：

class WeatherActivity : AppCompatActivity() {

    /*
     * Declare WeatherViewModel with Koin and allow constructor dependency injection
     */
    private val weatherViewModel by viewModel<WeatherViewModel>()
}

class WeatherHeaderFragment : Fragment() {

    /*
     * Declare shared WeatherViewModel with WeatherActivity
     */
    private val weatherViewModel by activityViewModel<WeatherViewModel>()
}

class WeatherListFragment : Fragment() {

    /*
     * Declare shared WeatherViewModel with WeatherActivity
     */
    private val weatherViewModel by activityViewModel<WeatherViewModel>()
}

向构造函数传递参数

viewModel 关键字和注入 API 与注入参数兼容。

在模块中：

val appModule = module {

    // ViewModel for Detail View with id as parameter injection
    viewModel { parameters -> DetailViewModel(id = parameters.get(), get(), get()) }
    // ViewModel for Detail View with id as parameter injection, resolved from graph
    viewModel { DetailViewModel(get(), get(), get()) }
    // or Constructor DSL
    viewModelOf(::DetailViewModel)
}

从注入调用点：

class DetailActivity : AppCompatActivity() {

    val id : String // id of the view

    // Lazy inject ViewModel with id parameter
    val detailViewModel: DetailViewModel by viewModel{ parametersOf(id)}
}

SavedStateHandle 注入 (3.3.0)

向你的构造函数添加一个 SavedStateHandle 类型的新属性，以处理你的 ViewModel 状态：

class MyStateVM(val handle: SavedStateHandle, val myService : MyService) : ViewModel()

在 Koin 模块中，只需使用 get() 或参数来解析它：

viewModel { MyStateVM(get(), get()) }

或使用构造函数 DSL：

viewModelOf(::MyStateVM)

要在 Activity、Fragment 中注入状态 ViewModel，请使用：

• by viewModel() - 惰性委托属性，用于将状态 ViewModel 实例注入到属性中
• getViewModel() - 直接获取状态 ViewModel 实例

class DetailActivity : AppCompatActivity() {

    // MyStateVM viewModel injected with SavedStateHandle
    val myStateVM: MyStateVM by viewModel()
}

INFO

所有 stateViewModel 函数均已弃用。你只需使用常规的 viewModel 函数来注入 SavedStateHandle。

导航图 ViewModel

你可以将 ViewModel 实例的作用域限定到你的导航图。只需使用 by koinNavGraphViewModel() 即可检索。你只需要你的图 ID。

class NavFragment : Fragment() {

    val mainViewModel: NavViewModel by koinNavGraphViewModel(R.id.my_graph)

}

ViewModel 作用域 API

查看所有用于 ViewModel 和作用域的 API：ViewModel 作用域

ViewModel 通用 API

Koin 提供了一些“幕后”API，可以直接调整你的 ViewModel 实例。针对 ComponentActivity 和 Fragment 的可用函数是 viewModelForClass：

ComponentActivity.viewModelForClass(
    clazz: KClass<T>,
    qualifier: Qualifier? = null,
    owner: ViewModelStoreOwner = this,
    state: BundleDefinition? = null,
    key: String? = null,
    parameters: ParametersDefinition? = null,
): Lazy<T>

NOTE

此函数仍在使用 state: BundleDefinition，但会将其转换为 CreationExtras。

请注意，你可以访问顶级函数，可从任何地方调用：

fun <T : ViewModel> getLazyViewModelForClass(
    clazz: KClass<T>,
    owner: ViewModelStoreOwner,
    scope: Scope = GlobalContext.get().scopeRegistry.rootScope,
    qualifier: Qualifier? = null,
    state: BundleDefinition? = null,
    key: String? = null,
    parameters: ParametersDefinition? = null,
): Lazy<T>

ViewModel API - Java 兼容

Java 兼容性必须添加到你的依赖项中：

// Java Compatibility
implementation "io.insert-koin:koin-android-compat:$koin_version"

你可以通过使用 ViewModelCompat 中的 viewModel() 或 getViewModel() 静态函数，将 ViewModel 实例注入到你的 Java 代码库中：

@JvmOverloads
@JvmStatic
@MainThread
fun <T : ViewModel> getViewModel(
    owner: ViewModelStoreOwner,
    clazz: Class<T>,
    qualifier: Qualifier? = null,
    parameters: ParametersDefinition? = null
)