第4章 ViewModel与Hilt集成：@HiltViewModel注解、ViewModelProvider注入、Fragment中获取ViewModel

4.1 原理概述

在Android架构中，ViewModel负责管理UI相关数据，并在配置更改（如屏幕旋转）后保持存活。传统ViewModel创建依赖手动工厂或AndroidViewModel的构造函数。Hilt通过@HiltViewModel注解，让ViewModel的构造函数自动接收依赖注入，无需手写工厂。

• @HiltViewModel：标记在ViewModel类上，Hilt为其生成工厂，自动注入依赖（如Repository、UseCase）。
• ViewModelProvider：Hilt扩展了ViewModelProvider的默认实现，Fragment或Activity中通过by viewModels()委托即可获取带注入的ViewModel。
• Fragment中获取：使用by viewModels()或by activityViewModels()，Hilt自动提供依赖并管理生命周期。

4.2 实现流程

1. 在ViewModel类上添加@HiltViewModel注解。
2. ViewModel构造函数中添加@Inject注解，参数为需要注入的依赖。
3. 在Fragment中通过private val vm: MyViewModel by viewModels()获取ViewModel实例。
4. 确保Fragment已用@AndroidEntryPoint注解（参见第3章）。
5. 运行应用，Hilt自动解析构造函数依赖并创建ViewModel。

4.3 核心注解与API说明

4.4 代码示例

定义ViewModel（注入Repository）：

// MyViewModel.kt
@HiltViewModel
class MyViewModel @Inject constructor(
    private val repository: UserRepository
) : ViewModel() {
    private val _user = MutableLiveData()
    val user: LiveData get() = _user

    fun loadUser(userId: String) {
        viewModelScope.launch {
            _user.value = repository.getUser(userId)
        }
    }
}

Fragment中使用ViewModel：

// UserFragment.kt
@AndroidEntryPoint
class UserFragment : Fragment(R.layout.fragment_user) {
    private val viewModel: MyViewModel by viewModels()

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        viewModel.loadUser("42")
        viewModel.user.observe(viewLifecycleOwner) { name ->
            // 更新UI
            binding.userName.text = name
        }
    }
}

4.5 内联SVG：ViewModel与Hilt集成流程

4.6 调试与验证

• 检查Fragment是否添加@AndroidEntryPoint，否则Hilt不会处理ViewModel注入。
• 查看编译后生成的Hilt_MyViewModel工厂类（位于build/generated/source/hilt/...）。
• 在Logcat中过滤“Hilt”标签，查看是否有因依赖解析失败导致的错误。
• 使用ViewModelProvider.Factory自定义工厂的旧代码需要移除，避免冲突。

4.7 常见错误与解决方案

4.8 性能与稳定性优化

• 避免在ViewModel中持有Fragment/Activity引用：否则会导致内存泄漏；Hilt注入的依赖应是无状态的单例或作用域对象。
• 使用viewModelScope：在ViewModel中启动协程，当ViewModel被清除时自动取消，防止后台任务泄漏。
• 按需使用by activityViewModels()：如果数据不需要跨Fragment共享，尽量使用by viewModels()缩小作用域，减少ViewModel存活时长。
• 测试时模拟Hilt组件：利用Hilt的测试库（如@HiltAndroidTest）注入Mock依赖，避免真实网络请求。