지금 TodoViewModel 하나를 열어보면 이렇다: Room 데이터베이스를 직접 만들고, DataStore도 직접 만들고, Retrofit도 직접 만든다. 한 클래스가 하는 일이 너무 많다.

지금 코드의 문제

class TodoViewModel(application: Application) : AndroidViewModel(application) {
    private val dao = Room.databaseBuilder(application, TodoDatabase::class.java, "todo.db")
        .build()
        .todoDao()
    private val settingsRepository = SettingsRepository(application.settingsDataStore)
    private val todoApiService = Retrofit.Builder()
        .baseUrl("https://jsonplaceholder.typicode.com/")
        .addConverterFactory(GsonConverterFactory.create())
        .build()
        .create(TodoApiService::class.java)

    // ... addTodo, toggleDone, deleteTodo, importFromServer, toggleDarkMode ...
}

TodoViewModel을 테스트하려면 진짜 Room 데이터베이스와 진짜 네트워크 연결이 필요하다. 가짜(mock) 데이터로 바꿔서 테스트하기가 어렵다. 그리고 이 세 가지(dao, settingsRepository, todoApiService)를 만드는 코드가 다른 ViewModel에서도 필요해지면, 매번 똑같은 코드를 복붙해야 한다.

Repository로 한 단계 더 감싸기

먼저 Room, Retrofit을 직접 다루는 부분을 하나의 Repository로 모은다.

class TodoRepository @Inject constructor(
    private val dao: TodoDao,
    private val apiService: TodoApiService
) {
    val todoList: Flow<List<Todo>> = dao.getAll()

    suspend fun addTodo(title: String) = dao.insert(Todo(title = title))
    suspend fun toggleDone(todo: Todo) = dao.update(todo.copy(isDone = !todo.isDone))
    suspend fun deleteTodo(todo: Todo) = dao.delete(todo)

    suspend fun importFromServer() {
        apiService.getTodos().take(5).forEach { remote ->
            dao.insert(Todo(title = remote.title, isDone = remote.completed))
        }
    }
}

ViewModel은 이제 "화면에 뭘 보여줄지"만 고민하고, "데이터를 어디서 어떻게 가져올지"는 Repository가 책임진다.

Hilt 의존성 추가

// 최상위 build.gradle.kts
plugins {
    id("com.google.dagger.hilt.android") version "2.60.1" apply false
}

// app/build.gradle.kts
plugins {
    id("com.google.dagger.hilt.android")
    id("com.google.devtools.ksp")
}

dependencies {
    implementation("com.google.dagger:hilt-android:2.60.1")
    ksp("com.google.dagger:hilt-android-compiler:2.60.1")
    implementation("androidx.hilt:hilt-navigation-compose:1.4.0")
}

Application 클래스 하나 만들기

import android.app.Application
import dagger.hilt.android.HiltAndroidApp

@HiltAndroidApp
class TodoApplication : Application()

@HiltAndroidApp을 붙인 Application 클래스가 있어야 Hilt가 앱 전체의 의존성 그래프를 만들기 시작한다. AndroidManifest.xml의 <application> 태그에 android:name=".TodoApplication"을 추가해야 한다.

Module - "이걸 어떻게 만드는지" 알려주는 설명서

import android.content.Context
import dagger.Module
import dagger.Provides
import dagger.hilt.InstallIn
import dagger.hilt.android.qualifiers.ApplicationContext
import dagger.hilt.components.SingletonComponent
import javax.inject.Singleton

@Module
@InstallIn(SingletonComponent::class)
object AppModule {

    @Provides
    @Singleton
    fun provideTodoDatabase(@ApplicationContext context: Context): TodoDatabase =
        Room.databaseBuilder(context, TodoDatabase::class.java, "todo.db").build()

    @Provides
    fun provideTodoDao(database: TodoDatabase): TodoDao = database.todoDao()

    @Provides
    @Singleton
    fun provideTodoApiService(): TodoApiService =
        Retrofit.Builder()
            .baseUrl("https://jsonplaceholder.typicode.com/")
            .addConverterFactory(GsonConverterFactory.create())
            .build()
            .create(TodoApiService::class.java)
}

TodoDatabase나 TodoApiService는 생성자에 @Inject를 붙일 수 없는, 우리가 만든 게 아닌 외부 라이브러리 타입이다. 그래서 "이걸 어떻게 만드는지"를 @Provides 함수로 직접 알려줘야 한다. @Singleton을 붙인 건 앱 전체에서 인스턴스를 하나만 쓰겠다는 뜻이다. TodoRepository는 아까 생성자에 @Inject constructor를 붙여뒀기 때문에, Hilt가 TodoDao와 TodoApiService를 알아서 채워서 만들어준다. 따로 @Provides를 안 써도 된다.

ViewModel - @HiltViewModel

import dagger.hilt.android.lifecycle.HiltViewModel
import javax.inject.Inject

@HiltViewModel
class TodoViewModel @Inject constructor(
    private val repository: TodoRepository
) : ViewModel() {

    val uiState: StateFlow<TodoUiState> = repository.todoList
        .map { TodoUiState(todoList = it) }
        .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), TodoUiState(isLoading = true))

    fun addTodo(title: String) {
        if (title.isBlank()) return
        viewModelScope.launch { repository.addTodo(title) }
    }

    fun toggleDone(todo: Todo) {
        viewModelScope.launch { repository.toggleDone(todo) }
    }

    fun deleteTodo(todo: Todo) {
        viewModelScope.launch { repository.deleteTodo(todo) }
    }

    fun importFromServer() {
        viewModelScope.launch {
            try {
                repository.importFromServer()
            } catch (e: Exception) {
                // 에러 처리는 지난 글과 동일
            }
        }
    }
}

AndroidViewModel에서 평범한 ViewModel로 돌아왔다. Context가 더 이상 필요 없다. TodoRepository를 생성자로 받기만 하면, 그 안에 든 TodoDao, TodoApiService까지 Hilt가 전부 연쇄적으로 만들어서 채워준다.

컴포저블에서는 hiltViewModel() 사용

import androidx.hilt.navigation.compose.hiltViewModel

@Composable
fun TodoApp(viewModel: TodoViewModel = hiltViewModel()) {
    // 이전과 동일
}

viewModel()이 hiltViewModel()로 바뀌었다는 것만 다르다. Hilt가 관리하는 TodoViewModel을 가져온다.

[이미지: 똑같이 동작하는 to-do 앱 — Hilt 적용 전후로 화면 동작은 바뀐 게 없는 모습]

정리

• Room, Retrofit처럼 생성자에 @Inject를 못 붙이는 외부 타입은 @Module + @Provides로 "만드는 법"을 알려준다
• 생성자에 @Inject constructor가 붙은 내 클래스(TodoRepository, TodoViewModel)는 Hilt가 필요한 걸 자동으로 채워서 만들어준다
• ViewModel은 @HiltViewModel, 컴포저블에서는 viewModel() 대신 hiltViewModel()을 쓴다

여기까지 데이터 저장(Room, DataStore)과 서버 통신(Retrofit), 그리고 그걸 깔끔하게 엮는 구조(Repository, Hilt)까지 봤다. 다음 글부터는 컴포즈 쪽으로 다시 돌아와서, LaunchedEffect 같은 부수 효과를 다루겠다.

(이 글의 Hilt 관련 버전(2.60.1, hilt-navigation-compose:1.4.0)은 작성 시점 기준으로 확인한 값이다. Hilt의 KSP 지원은 비교적 최근에 안정화된 영역이라, 실제로 적용할 때는 Hilt 공식 Gradle 설정 문서에서 현재 Kotlin/KSP 버전과 맞는 조합인지 한 번 더 확인하는 게 좋다.)