docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거
Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를 Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류. - 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로 자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거, 동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거. - 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming, Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business, Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로, 나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는 title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백). 원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지. - 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서. - 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는 지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지. - Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경. - 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
This commit is contained in:
Antigravity Agent
@@ -0,0 +1,141 @@
|
||||
---
|
||||
id: android-hilt-di-patterns
|
||||
title: Android Hilt — DI 모듈과 스코프
|
||||
category: Coding
|
||||
status: draft
|
||||
source_trust_level: B
|
||||
verification_status: conceptual
|
||||
created_at: 2026-05-09
|
||||
updated_at: 2026-05-09
|
||||
tags: [android, hilt, di, dagger, vibe-coding]
|
||||
tech_stack: { language: "Kotlin / Hilt", applicable_to: ["Android"] }
|
||||
applied_in: []
|
||||
aliases: [@HiltAndroidApp, @Module, @Provides, ViewModelComponent]
|
||||
---
|
||||
|
||||
# Android Hilt — DI
|
||||
|
||||
> Dagger 의 Android 친화 wrapper. **컴포넌트 = 스코프**. ApplicationComponent (Singleton), ActivityComponent, FragmentComponent, ViewModelComponent. 잘못된 스코프 = leak 또는 잘못된 인스턴스 공유.
|
||||
|
||||
## 📖 핵심 개념
|
||||
- @HiltAndroidApp: Application 클래스에. 부팅.
|
||||
- @AndroidEntryPoint: Activity / Fragment / View / Service 에.
|
||||
- @HiltViewModel: ViewModel 자동 주입.
|
||||
- @Module + @InstallIn: 어떤 컴포넌트에 binding.
|
||||
|
||||
## 💻 코드 패턴
|
||||
|
||||
### 부팅
|
||||
```kotlin
|
||||
@HiltAndroidApp
|
||||
class App : Application()
|
||||
|
||||
// AndroidManifest.xml — name=".App"
|
||||
```
|
||||
|
||||
### Module — 외부 라이브러리 binding
|
||||
```kotlin
|
||||
@Module
|
||||
@InstallIn(SingletonComponent::class)
|
||||
object NetworkModule {
|
||||
|
||||
@Provides @Singleton
|
||||
fun retrofit(): Retrofit = Retrofit.Builder()
|
||||
.baseUrl("https://api.example.com/")
|
||||
.addConverterFactory(MoshiConverterFactory.create())
|
||||
.build()
|
||||
|
||||
@Provides @Singleton
|
||||
fun userApi(retrofit: Retrofit): UserApi = retrofit.create(UserApi::class.java)
|
||||
}
|
||||
|
||||
@Module
|
||||
@InstallIn(SingletonComponent::class)
|
||||
abstract class RepoModule {
|
||||
@Binds @Singleton
|
||||
abstract fun bindUserRepo(impl: UserRepoImpl): UserRepo
|
||||
}
|
||||
```
|
||||
|
||||
### Scoped repository
|
||||
```kotlin
|
||||
@Singleton
|
||||
class UserRepo @Inject constructor(
|
||||
private val api: UserApi,
|
||||
private val dao: UserDao,
|
||||
) { ... }
|
||||
```
|
||||
|
||||
### ViewModel 주입
|
||||
```kotlin
|
||||
@HiltViewModel
|
||||
class ProfileViewModel @Inject constructor(
|
||||
private val repo: UserRepo,
|
||||
private val savedState: SavedStateHandle,
|
||||
) : ViewModel() { ... }
|
||||
```
|
||||
|
||||
### Compose
|
||||
```kotlin
|
||||
@Composable
|
||||
fun ProfileScreen(viewModel: ProfileViewModel = hiltViewModel()) { ... }
|
||||
```
|
||||
|
||||
### Worker 주입
|
||||
```kotlin
|
||||
@HiltWorker
|
||||
class SyncWorker @AssistedInject constructor(
|
||||
@Assisted ctx: Context,
|
||||
@Assisted params: WorkerParameters,
|
||||
private val repo: SyncRepo,
|
||||
) : CoroutineWorker(ctx, params) { ... }
|
||||
|
||||
// App 에서
|
||||
@HiltAndroidApp
|
||||
class App : Application(), Configuration.Provider {
|
||||
@Inject lateinit var workerFactory: HiltWorkerFactory
|
||||
override val workManagerConfiguration: Configuration
|
||||
get() = Configuration.Builder().setWorkerFactory(workerFactory).build()
|
||||
}
|
||||
```
|
||||
|
||||
### Qualifier — 같은 타입 다른 인스턴스
|
||||
```kotlin
|
||||
@Qualifier annotation class Authed
|
||||
@Qualifier annotation class Public
|
||||
|
||||
@Provides @Singleton @Authed
|
||||
fun authedClient(): OkHttpClient = OkHttpClient.Builder().addInterceptor(AuthInterceptor()).build()
|
||||
|
||||
@Provides @Singleton @Public
|
||||
fun publicClient(): OkHttpClient = OkHttpClient()
|
||||
|
||||
class Repo @Inject constructor(@Authed private val client: OkHttpClient) { ... }
|
||||
```
|
||||
|
||||
## 🤔 의사결정 기준
|
||||
| 인스턴스 lifecycle | 스코프 |
|
||||
|---|---|
|
||||
| 앱 전체 (DB, network client, repo) | @Singleton in SingletonComponent |
|
||||
| Activity 동안 (navigation graph) | @ActivityRetainedScoped |
|
||||
| ViewModel 동안 | @ViewModelScoped |
|
||||
| Fragment 동안 | @FragmentScoped |
|
||||
| 매번 새로 | scope 없음 (default) |
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **모든 곳 @Singleton**: 큰 객체 메모리 영구 점유. 필요한 곳만.
|
||||
- **Activity scope 인데 ViewModel 에 주입**: ViewModel 이 Activity 보다 오래 → leak.
|
||||
- **Context 잘못된 종류**: ApplicationContext vs ActivityContext. 가장 작은 scope.
|
||||
- **모듈을 잘못된 컴포넌트에 InstallIn**: 의존성 못 찾음.
|
||||
- **@Provides 와 @Binds 혼용 + 같은 타입**: ambiguous.
|
||||
- **테스트 환경에서 production module 그대로**: 외부 의존. @TestInstallIn 으로 fake.
|
||||
- **ViewModel constructor 에 Context 주입**: leak. @ApplicationContext 만.
|
||||
|
||||
## 🤖 LLM 활용 힌트
|
||||
- 신규 Android = Hilt 디폴트.
|
||||
- Singleton vs ViewModelScoped 명확히.
|
||||
- Test 는 hiltRules + fake module.
|
||||
|
||||
## 🔗 관련 문서
|
||||
- [[Android_Room_Patterns]]
|
||||
- [[Android_WorkManager_Patterns]]
|
||||
Reference in New Issue
Block a user