Android Hilt 에 관하여

hjseo-dev·2025년 2월 20일

Android

목록 보기

19/19

💡 Android Hilt란?

Hilt는 Dagger를 기반으로 한 Android 공식 의존성 주입(Dependency Injection, DI) 라이브러리입니다. Google이 제공하며, Android 앱에서 의존성 관리를 쉽게 할 수 있도록 설계되었습니다.

📍 Hilt 사용법

1. 프로젝트 설정

Gradle에 Hilt 의존성을 추가해야 합니다.

(1) build.gradle (Project)

plugins {
    id 'com.android.application'
    id 'kotlin-kapt'
    id 'dagger.hilt.android.plugin'
}

(2) build.gradle (Module)

dependencies {
    implementation "com.google.dagger:hilt-android:2.50"
    kapt "com.google.dagger:hilt-android-compiler:2.50"
}

2. Application 클래스에 Hilt 설정

모든 앱의 최상위에서 DI를 적용하기 위해 @HiltAndroidApp을 추가합니다.

@HiltAndroidApp
class MyApplication : Application()

3. 의존성 주입 (Module)

Hilt에서 @Module과 @InstallIn을 사용하여 의존성을 주입합니다.

@Module
@InstallIn(SingletonComponent::class) // 앱 전체에서 사용 가능
object AppModule {

    @Provides
    @Singleton
    fun provideRetrofit(): Retrofit {
        return Retrofit.Builder()
            .baseUrl("https://api.example.com/")
            .addConverterFactory(GsonConverterFactory.create())
            .build()
    }
}

4. ViewModel에서 DI 사용

Hilt를 사용하면 ViewModel에서도 간단하게 DI를 적용할 수 있습니다.

@HiltViewModel
class MyViewModel @Inject constructor(
    private val retrofit: Retrofit
) : ViewModel() {
    fun fetchData() {
        // Retrofit을 사용하여 API 호출
    }
}

5. Activity에서 의존성 주입

Activity 또는 Fragment에서 @AndroidEntryPoint를 추가하면 Hilt가 자동으로 의존성을 주입합니다.

@AndroidEntryPoint
class MainActivity : AppCompatActivity() {
    @Inject lateinit var retrofit: Retrofit

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Retrofit 사용 가능
    }
}