Share
Embed
Transcript
309 slides
-
Sungyong An NAVER WEBTOON Android GDE @fornewid Link: h tt
ps://speakerdeck.com/fornewid -
(Dependency Injection) Manual DI Dagger Hilt Dagger Hilt (Modularization) Dagger
Hilt Dagger Hilt DI , Metro -
(Dependency) ? (Reference) . . , Car Engine . Car
Engine Dependency -
class Car { private val engine: Engine = Engine() //
construct + use fun start() { engine.start() } } fun main(args: Array) { val car = Car() car.start() } Car Engine Current -
class Car( private val engine: Engine // use ) {
fun start() { engine.start() } } fun main(args: Array) { val engine = Engine() // construct val car = Car(engine) car.start() } Car With DI (Constructor Injection) Engine -
class Car { lateinit var engine: Engine // use fun
start() { engine.start() } } fun main(args: Array) { val car = Car() car.engine = Engine() // construct car.start() } With DI (Field Injection) Car Engine -
Engine , Car . fun main(args: Array<String>) { val electricCar
= Car(ElectricEngine()) val combustionCar = Car(CombustionEngine()) ... } Reuse Car -
class CarTest { @Test fun `Car happy path`() { val
car = Car(FakeEngine()) ... } @Test fun `Car with failing Engine`() { val car = Car(FakeFailingEngine()) ... } } Ease of Testing -
class Car { private val engine: Engine = Engine() }
fun main(args: Array) { val car = Car() car.start() } Car Engine Current -
class Car( private val engine: Engine ) { ... }
fun main(args: Array) { val engine = Engine() val car = Car(engine) car.start() } Car Dependency Injection Engine -
class Car { private val engine: Engine = ServiceLocator.getEngine() }
object ServiceLocator { fun getEngine() : Engine = Engine() } fun main(args: Array) { val car = Car() car.start() } Service Locator Engine Car Service Locator -
class CarTest { @Test fun `Car happy path`() { ServiceLocator.set(FakeEngine())
val car = Car() } @Test fun `Car with failing Engine`() { ServiceLocator.set(FakeFailingEngine()) val car = Car() // ܲ పझ৬ ج! } } Service Locator -
class Car { private val engine = ServiceLocator.get() // Carо
Engineী ઓೞח ৻ࠗীࢲח ঌ ࣻ হ } Service Locator -
? . Android Studio Dagger/Hilt . DI . DI ,
. Link: h tt ps://medium.com/androiddevelopers/dagger-navigation-suppo rt -in-android-studio-49aa5d149ec9 -
Before . , DB Activity , Singleton Activity . ExampleActivity
Network Database -
class ExampleViewModel : ViewModel() { fun doSomething() { Database.getSomething().subscribe(...) Network.getSomething().subscribe(...)
} } object Database { ... } object Network { ... } Before -
class ExampleViewModel( private val database: Database, private val network: Network,
) : ViewModel() { fun doSomething() { database.getSomething().subscribe(...) network.getSomething().subscribe(...) } } class Database { ... } class Network { ... } Manual DI -
class ExampleActivity: Activity() { private lateinit var viewModel: ExampleViewModel override
fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val database = Database() // Singleton ইפ. val network = Network() // , ݒߣ ࢤࢿػ. viewModel = ExampleViewModel(database, network) viewModel.doSomething() } } Manual DI -
class ExampleActivity: Activity() { private lateinit var viewModel: ExampleViewModel override
fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val database = Database() // Singleton ইפ. val network = Network() // , ݒߣ ࢤࢿػ. viewModel = ExampleViewModel(database, network) viewModel.doSomething() } } Manual DI -
Manual DI ViewModel Boilerplate , ExampleViewModel . . ExampleViewModel Database
Network . . Database Network Singleton . , . -
class AppContainer { val database = Database() val network =
Network() } class MyApplication : Application() { val appContainer = AppContainer() } -
class ExampleActivity: Activity() { private lateinit var viewModel: ExampleViewModel override
fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val appContainer = (application as MyApplication).appContainer viewModel = ExampleViewModel(appContainer.database, appContainer.network) viewModel.doSomething() } } -
Android . Example Activity Example ViewModel Example Repository Example LocalDataSource
Example RemoteDataSource Network Database -
class AppContainer { private val database = Database() private val
network = Network() private val localDataSource = ExampleLocalDataSource(database) private val remoteDataSource = ExampleRemoteDataSource(network) val exampleRepository = ExampleRepository(localDataSource, remoteDataSource) } class MyApplication : Application() { val appContainer = AppContainer() } -
class ExampleActivity: Activity() { private lateinit var viewModel: ExampleViewModel override
fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val appContainer = (application as MyApplication).appContainer viewModel = ExampleViewModel(appContainer.exampleRepository) // Singleton viewModel.doSomething() } } -
class ExampleActivity: Activity() { private lateinit var viewModel: ExampleViewModel override
fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val appContainer = (application as MyApplication).appContainer viewModel = ExampleViewModel(appContainer.getExampleRepository()) // New! viewModel.doSomething() } } -
class AppContainer { private val database = Database() private val
network = Network() private val localDataSource = ExampleLocalDataSource(database) private val remoteDataSource = ExampleRemoteDataSource(network) fun getExampleRepository() : ExampleRepository { return ExampleRepository(localDataSource, remoteDataSource) // New! } } -
Singleton . Example Activity Example ViewModel Example Repository Example LocalDataSource
Example RemoteDataSource Network Database Custom Scope -
// Application ࠁ ߧਤ ઓࢿ ஶపց class ExampleContainer(val exampleRepository:
ExampleRepository) { val exampleData = ExampleData() val exampleViewModelFactory = ExampleViewModelFactory(exampleRepository) } class AppContainer { ... val exampleRepository = ExampleRepository(localDataSource, remoteDataSource) var exampleContainer: ExampleContainer? = null } : Custom Scope -
class ExampleActivity: Activity() { private lateinit var viewModel: ExampleViewModel private
lateinit var appContainer: AppContainer private lateinit var data: ExampleData override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) appContainer = (application as MyApplication).appContainer appContainer.exampleContainer = // ઓࢿ ஶపց ࢤࢿ ExampleContainer(appContainer.exampleRepository) viewModel = appContainer.exampleContainer.exampleViewModelFactory.create() data = appContainer.exampleContainer.exampleData } ... : Custom Scope -
class ExampleActivity: Activity() { private lateinit var viewModel: ExampleViewModel private
lateinit var appContainer: AppContainer private lateinit var data: ExampleData ... override fun onDestroy() { appContainer.exampleContainer = null // ઓࢿ ஶపց ઁ super.onDestroy() } } } : Custom Scope -
DI . Android ߂ Java ਊ ઓࢿ ੑ ۨਕ. ஹੌ
ఋী ࣗझ٘ ࢤࢿ. Dependency Injection ಁఢ. https://github.com/google/dagger Dagger ӝ߈ Android ઓࢿ ੑ ۨਕ. ࠗ࠙ Dagger ࢚ਊҳ ઁѢ. Dependency Injection ಁఢ. https://github.com/google/dagger Dagger Hilt (Recommended) Dagger ઓࢿ ੑਸ ؊ औѱ ݅٘ח Kotlin ஹੌ۞ ۞Ӓੋ. Dependency Injection ಁఢ. https://github.com/square/anvil Anvil Kotlin ҃ ઓࢿ ੑ ۨਕ. ۠ఋী ઓࢿ Ӓې ҳࢿ. Service Locator ಁఢ. https://github.com/InsertKoinIO/koin Kotlin ਊ ઓࢿ ੑ ۄ࠳۞ܻ. ஹੌ ఋী ઓࢿ Ӓې ਬബࢿ Ѩࢎ. KSP, Kotlin Multiplatform ਗ. https://github.com/evant/kotlin-inject Koin kotlin-inject … -
Dagger Hilt Android DI Android , . (Application, Activity, Service,
BroadcastReceiver, ViewModel) Dagger , . Jetpack Hilt . -
@Module @InstallIn(SingletonComponent::class) class EngineModule { @Provides // construct fun providesEngine():
Engine = Engine() } Engine @Provides ١ਸ ਊೞৈ, ઓࢿਸ ઁҕೡ ࣻ . -
@Module @InstallIn(SingletonComponent::class) class EngineModule { @Provides // construct fun providesEngine():
Engine = Engine() } // Dependency Injection (Constructor Injection) class Car @Inject constructor( // use private val engine: Engine, ) Car Engine @Injectܳ ਊೞৈ, ઓࢿਸ ېझ ࢤࢿী ੑೡ ࣻ . -
@Module @InstallIn(SingletonComponent::class) class EngineModule { @Provides fun providesEngine(): Engine =
Engine() } // Dependency Injection (Constructor Injection) class Car @Inject constructor( // construct private val engine: Engine, ) @AndroidEntryPoint class ExampleActivity : ComponentActivity() { // Dependency Injection (Field Injection) @Inject // use lateinit var car: Car } Car ExampleActivity Engine Android ېझח ࢤࢿо ইצ, ٘ী ઓࢿਸ ੑೠ. -
@Module @InstallIn(SingletonComponent::class) class EngineModule { @Provides fun providesEngine(): Engine =
Engine() } // Dependency Injection (Constructor Injection) class Car @Inject constructor( private val engine: Engine, ) @AndroidEntryPoint class ExampleActivity : ComponentActivity() { // Dependency Injection (Field Injection) @Inject lateinit var car: Car } = public @interface Module { ... } = public @interface InstallIn { ... } = public @interface Provides {} = public @interface Inject {} = public @interface AndroidEntryPoint { ... } = public @interface Inject {} Annotationਸ ӝ߈ਵ۽, ઓࢿਸ ੑೞח ٘ܳ ࢤࢿ೧ળ. -
// project’s root build.gradle buildscript { repositories { mavenCentral() }
dependencies { classpath 'com.google.dagger:hilt-android-gradle-plugin:2.59.2' } } // module’s build.gradle apply plugin: 'com.google.dagger.hilt.android' Gradle Build Setup -
// module’s build.gradle dependencies { implementation 'com.google.dagger:hilt-android:2.59.2' // For Java
annotationProcessor 'com.google.dagger:hilt-compiler:2.59.2' // For Kotlin kapt 'com.google.dagger:hilt-compiler:2.59.2' // or ksp 'com.google.dagger:hilt-compiler:2.59.2' } Gradle Build Setup -
Hilt Basics Dagger Hilt . @HiltAndroidApp @AndroidEntryPoint, @EntryPoint Components SingletonComponent,
ViewModelComponent, ActivityComponent, ... Scopes @Singleton, @ViewModelScoped, @ActivityScoped, … Modules @Inject, @Module, @Provides, @Binds, @Quali fi er, … -
Hilt Application Hilt Application @HiltAndroidApp . , Hilt . @Inject
, . @HiltAndroidApp class MyApplication : Application() { @Inject lateinit var data: ExampleData } MyApplication ExampleData -
Android Android @AndroidEntryPoint . @Inject , . @AndroidEntryPoint class ExampleActivity
: ComponentActivity() { @Inject lateinit var data: ExampleData } ... ExampleActivity ExampleData -
@AndroidEntryPoint class ExampleFragment : Fragment() { ... } @AndroidEntryPoint class
ExampleView @JvmOverloads constructor( context: Context, attrs: AttributeSet? = null, defStyleAttr: Int = 0, ) : View(context, attrs, defStyleAttr) { ... } @AndroidEntryPoint class ExampleService : Service() { ... } @AndroidEntryPoint class ExampleBroadcastReceiver : BroadcastReceiver() { ... } -
@AndroidEntryPoint // X class ExampleContentProvider : ContentProvider() { ... }
// Activity, Fragment, View, Service, BroadcastReceiverо ইצ, // ܲ Android ېझীח @AndroidEntryPointܳ ࢎਊೡ ࣻ হ. -
Hilt @EntryPoint . Context Hilt . Hilt @EntryPoint @InstallIn(SingletonComponent::class) interface
ExampleEntryPoint { fun foo(): Foo } val entryPoint = EntryPointAccessors.fromApplication( appContext, // Context ExampleEntryPoint::class.java, ) val foo = entryPoint.foo() -
class ExampleContentProvider : ContentProvider() { override fun query(...): Cursor {
val appContext = context?.applicationContext ?: throw Exception() val entryPoint = EntryPointAccessors.fromApplication( appContext, ExampleEntryPoint::class.java ) val foo = entryPoint.foo() ... } } -
@Composable private fun rememberFoo(): Foo { val context = LocalContext.current
return remember { val entryPoint = EntryPointAccessors.fromApplication( context.applicationContext, ExampleEntryPoint::class.java, ) entryPoint.foo() } } @Composable fun ExampleComposable() { val foo: Foo = rememberFoo() ... } -
val entryPoint = EntryPointAccessors.fromActivity( activity, // Activity ExampleEntryPoint::class.java, ) val
entryPoint = EntryPointAccessors.fromFragment( fragment, // Fragment ExampleEntryPoint::class.java, ) val entryPoint = EntryPointAccessors.fromView( view, // View ExampleEntryPoint::class.java, ) -
Hilt Bindings Android , . @Inject , . @Singleton class
ExampleRepository @Inject constructor( private val local: ExampleLocalDataSource, private val remote: ExampleRemoteDataSource, ) { ... } ExampleRepository -
. Hilt @Module Binding . @Module @InstallIn(SingletonComponent::class) class AppModule {
@Singleton @Provides fun providesExampleRepository(...): ExampleRepository { return ExampleRepositoryImpl(...) } } Hilt Modules -
@Module @InstallIn(SingletonComponent::class) class AppModule { @Singleton @Provides fun providesExampleRepository( local:
ExampleLocalDataSource, remote: ExampleRemoteDataSource, ): ExampleRepository { return ExampleRepository(local, remote) } } Hilt Modules: @Provides ExampleRepository -
interface ExampleRepository @Singleton class ExampleRepositoryImpl @Inject constructor(...) : ExampleRepository {
... } @Module @InstallIn(SingletonComponent::class) interface AppModule { @Binds fun bindsExampleRepository( impl: ExampleRepositoryImpl, ): ExampleRepository } Hilt Modules: @Binds ExampleRepositoryImpl ExampleRepository -
, . ( ) Binding @Qualifier . @Inject lateinit var
coroutineDispatcher: CoroutineDispatcher @Module @InstallIn(SingletonComponent::class) object DispatchersModule { @Provides fun providesDefaultDispatcher(): CoroutineDispatcher = Dispatchers.Default @Provides fun providesIoDispatcher(): CoroutineDispatcher = Dispatchers.IO } Hilt Modules: @Qualifier ? -
@Qualifier @Retention(AnnotationRetention.BINARY) annotation class DefaultDispatcher // key @Qualifier @Retention(AnnotationRetention.BINARY) annotation
class IoDispatcher // key Hilt Modules: @Qualifier -
@Module @InstallIn(SingletonComponent::class) object DispatchersModule { @DefaultDispatcher @Provides fun providesMainDispatcher(): CoroutineDispatcher
= Dispatchers.Default @IoDispatcher @Provides fun providesIoDispatcher(): CoroutineDispatcher = Dispatchers.IO } Hilt Modules: @Qualifier -
class ExampleUseCase @Inject constructor( @DefaultDispatcher defaultDispatcher: CoroutineDispatcher, ) { ...
} @Module @InstallIn(SingletonComponent::class) object AppModule { @Provides fun providesExampleRepository( @IoDispatcher ioDispatcher: CoroutineDispatcher, ): ExampleRepository { ... } } Hilt Modules: @Qualifier -
Hilt Modules: Predefined @Qualifier Hilt @Qualifier . (@ApplicationContext, @ActivityContext) Context
. class ExampleRepository @Inject constructor( @ApplicationContext private val appContext: Context, ) { ... } class AnalyticsAdapter @Inject constructor( @ActivityContext private val activityContext: Context, ) { ... } -
@InstallIn , @Module Component . @Module @InstallIn(SingletonComponent::class) object ExampleModule {
@Provides fun providesBar(foo: Foo): Bar = BarImpl(foo) @Singleton @Provides fun providesFoo(): Foo = FooImpl() } Component -
Scope Annotation , Component . @Module @InstallIn(SingletonComponent::class) object ExampleModule {
// unscoped @Provides fun providesBar(foo: Foo): Bar = BarImpl(foo) @Singleton @Provides fun providesFoo(): Foo = FooImpl() } Scope -
Component hierarchy @Module @InstallIn(SingletonComponent::class) object AppModule { @Provides fun providesFoo():
Foo = FooImpl() } @Module @InstallIn(ActivityComponent::class) object ActivityModule { @Provides fun providesBar(foo: Foo): Bar = BarImpl(foo) } -
Component hierarchy @Module @InstallIn(SingletonComponent::class) object AppModule { @Provides fun providesBaz(bar:
Bar): Baz = BazImpl(bar) } @Module @InstallIn(ActivityComponent::class) object ActivityModule { @Provides fun providesBar(foo: Foo): Bar = BarImpl(foo) } -
: Provider @AndroidEntryPoint class ExampleActivity : ComponentActivity() { @Inject lateinit
var data: Provider<ExampleData> ... data.get() // दী ࢤࢿػ. ױ, ݒߣ ࢜۽ ёо ٜ݅য. ... } @Inject , . Provider get() . . -
: Lazy Lazy get() , . . @AndroidEntryPoint class ExampleActivity
: ComponentActivity() { @Inject lateinit var data: Lazy<ExampleData> ... data.get() // दী ёо ࢤࢿػ. ױ, ৈ۞ߣ ഐೞݶ ࢤࢿػ ёо ߈ജػ. ... } -
ViewModel @HiltViewModel . , . @HiltViewModel class ExampleViewModel @Inject constructor(
private val savedStateHandle: SavedStateHandle, private val repository: ExampleRepository, ) : ViewModel() { ... } @AndroidEntryPoint class ExampleActivity : Activity() { private val exampleViewModel: ExampleViewModel by viewModels() } Jetpack : ViewModel -
@HiltWorker, @AssistedInject , Worker . @Assisted . @HiltWorker class ExampleWorker
@AssistedInject constructor( @Assisted appContext: Context, @Assisted workerParams: WorkerParameters, private val repository: ExampleRepository, ) : Worker(appContext, workerParams) { ... } Jetpack : WorkManager -
// ۄ࠳۞ܻܳ ୶о ࢸ೧ঠ ೠ. dependencies { implementation 'androidx.hilt:hilt-work:1.0.0' kapt
'androidx.hilt:hilt-compiler:1.0.0' } // HiltWorkerFactory۽ WorkManagerܳ ୡӝച೧ঠ ೠ. @HiltAndroidApp class ExampleApplication : Application(), Configuration.Provider { @Inject lateinit var workerFactory: HiltWorkerFactory override fun getWorkManagerConfiguration() = Configuration.Builder() .setWorkerFactory(workerFactory) .build() } -
@Module @Provides @Binds @Inject @AndroidEntryPoint @EntryPoint @HiltAndroidApp Overview @Qualifier Provider
Lazy @HiltViewModel @HiltWorker @Singleton, ... -Component -
Before class ExampleActivity : ComponentActivity() { private val bar =
Bar() bar.doSomething() } -
@AndroidEntryPoint class ExampleActivity : ComponentActivity() { @Inject lateinit var bar:
Bar bar.doSomething() } @Module @InstallIn(SingletonComponent::class) object BarModule { @Provides fun provideBar(): Bar = Bar() } -
(1-A) : Singleton Singleton . object SingletonBar { fun doSomething()
{ ... } } ... SingletonBar.doSomething() -
Before class ExampleActivity : ComponentActivity() { SingletonBar.doSomething() } object SingletonBar
{ fun doSomething() { ... } } -
After: , Singleton @AndroidEntryPoint class ExampleActivity : ComponentActivity() { @Inject
lateinit var singletonBar: SingletonBar singletonBar.doSomething() } @Module @InstallIn(SingletonComponent::class) object BarModule { @Provides fun provideBar(): SingletonBar = SingletonBar } -
After: interface-impl , Singleton object SingletonBar { fun doSomething() {
... } } @Module @InstallIn(SingletonComponent::class) object BarModule { @Provides fun provideBar(): SingletonBar = SingletonBar } -
After: interface-impl , Singleton interface SingletonBar { fun doSomething() }
@Deprecated object SingletonBarImpl : SingletonBar { override fun doSomething() { ... } } @Module @InstallIn(SingletonComponent::class) object BarModule { @Provides fun provideBar(): SingletonBar = SingletonBarImpl } -
After: Hilt Singleton interface SingletonBar { fun doSomething() } @Singleton
class SingletonBarImpl @Inject constructor() : SingletonBar { override fun doSomething() { ... } } @Module @InstallIn(SingletonComponent::class) interface BarModule { @Binds fun bindBar(impl: SingletonBarImpl): SingletonBar } -
(1-B) : Singleton + Context Singleton Context . class SingletonBar
private constructor(private val context: Context) { fun doSomething() { ... } companion object { private lateinit var instance: SingletonBar fun initialize(context: Context) { instance = SingletonBar(context.applicationContext) } fun getInstance(): SingletonBar = instance } } -
Before class ExampleApplication : Application() { override fun onCreate() {
super.onCreate() SingletonBar.initialize(this) } } class ExampleActivity : ComponentActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) SingletonBar.getInstance().doSomething() } } -
After: , Singleton @Module @InstallIn(SingletonComponent::class) object BarModule { @Provides fun
provideBar(): SingletonBar = SingletonBar.getInstance() } @AndroidEntryPoint class ExampleActivity : ComponentActivity() { @Inject lateinit var singletonBar: SingletonBar override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) singletonBar.doSomething() } } -
After: interface-impl , Singleton @Module @InstallIn(SingletonComponent::class) object BarModule { @Provides
fun provideBar(): SingletonBar = SingletonBarImpl.getInstance() } interface SingletonBar { fun doSomething() } @Deprecated class SingletonBarImpl private constructor( context: Context ) : SingletonBar { ... } -
After: Hilt Singleton @Module @InstallIn(SingletonComponent::class) interface BarModule { @Binds fun
bindBar(impl: SingletonBarImpl): SingletonBar } interface SingletonBar { fun doSomething() } @Singleton class SingletonBarImpl @Inject constructor( @ApplicationContext context: Context ) : SingletonBar { ... } -
class ExampleApplication : Application() { override fun onCreate() { super.onCreate()
// SingletonBar.initialize(this) } } After: Hilt Singleton -
(1-C) : Singleton + Singleton Singleton . class SingletonBar private
constructor(...) { fun doSomething() { SingletonFoo.doSomething() } } class SingletonFoo private constructor(...) { fun doSomething() { ... } } -
Before class ExampleActivity : ComponentActivity() { override fun onCreate(savedInstanceState: Bundle?)
{ super.onCreate(savedInstanceState) SingletonBar.getInstance().doSomething() } } class SingletonBar private constructor(...) { fun doSomething() { SingletonFoo.getInstance().doSomething() } } class SingletonFoo private constructor(...) { fun doSomething() { ... } } -
Before class SingletonBar private constructor(private val context: Context) { fun
doSomething() { SingletonFoo.getInstance().doSomething() } } class SingletonFoo private constructor( private val context: Context ) { fun doSomething() { ... } } -
After class SingletonBar private constructor(private val context: Context) { private
val singletonFoo: SingletonFoo fun doSomething() { singletonFoo.doSomething() } } @Singleton class SingletonFoo @Inject constructor( @ApplicationContext private val context: Context ) { fun doSomething() { ... } } -
After class SingletonBar private constructor(private val context: Context) { private
val singletonFoo: SingletonFoo init { val entryPoint = EntryPointAccessors.fromApplication( context.applicationContext, SingletonBarEntryPoint::class.java ) singletonFoo = entryPoint.provideFoo() } } @EntryPoint @InstallIn(SingletonComponent::class) interface SingletonBarEntryPoint { fun provideFoo(): SingletonFoo } -
Final @Singleton class SingletonBar @Inject constructor( private val context: Context,
private val singletonFoo: SingletonFoo, ) { fun doSomething() { singletonFoo.doSomething() } } -
(2) Depth . @AndroidEntryPoint class ExampleActivity : ComponentActivity() { @Inject
lateinit var singletonBar: SingletonBar fun doSomething() { singletonBar.doSomething() } } (3) (1) (2) app start -
(2-A) : Component Component Component @AndroidEntryPoint . , Fragment Hilt
Fragment Activity @AndroidEntryPoint . @AndroidEntryPoint class ExampleActivity : ComponentActivity() { ... } @AndroidEntryPoint class ExampleFragment : Fragment() { ... } ExampleActivity ExampleFragment @inject -
ViewModel @HiltViewModel class ExampleViewModel @Inject constructor( private val singletonBar: SingletonBar,
) : ViewModel() { ... } @AndroidEntryPoint class ExampleActivity : ComponentActivity() { private val viewModel: ExampleViewModel by viewModels() } class ExampleFragment : ComponentActivity() { } -
ViewModel @HiltViewModel class ExampleViewModel @Inject constructor( private val singletonBar: SingletonBar,
) : ViewModel() { ... } @AndroidEntryPoint class ExampleActivity : ComponentActivity() { // private val viewModel: ExampleViewModel by viewModels() } @AndroidEntryPoint class ExampleFragment : ComponentActivity() { private val viewModel: ExampleViewModel by viewModels() } -
ViewModel @HiltViewModel class ExampleViewModel @Inject constructor( private val singletonBar: SingletonBar,
) : ViewModel() { ... } @AndroidEntryPoint class ExampleActivity : ComponentActivity() { ... } @AndroidEntryPoint class ExampleFragment : ComponentActivity() { private val viewModel: ExampleViewModel by activityViewModels() } -
(2-B) : Base Base , @AndroidEntryPoint . class BaseActivity :
ComponentActivity() { @Inject lateinit var bar: Bar } @AndroidEntryPoint class ExampleActivity : BaseActivity() { ... } -
, . , DI . Dagger Hilt . Component, Scope,
Module, @Inject, @AndroidEntryPoint, … . -
? A app B data app domain or app app
common C domain app app data app app feature app app app or -
App Architecture Modularization • UI Layer • Domain Layer (Optional)
• Data Layer 1:1 . • App Modules • Feature Modules • Data Modules • Common Modules • Test Modules -
? Layer Domain Data UI Feature Domain Data UI Layer
+ Feature Domain Data UI -
, . (ex. Common Data Feature) (1) Version Catalog (2)
Data (3) BuildCon fi g (4) Common (5) Convention Plugins (6) Feature -
(1) Version Catalog . (ex. Kotlin, Dagger Hilt) Version Catalog
, . 2023 Gradle Version Catalog 저 ᆨ 용하기 -
// build.gradle dependencies { implementation 'androidx.core:core-ktx:1.9.0' } // gradle/libs.versions.toml [versions]
androidx-core-ktx = "1.9.0" [libraries] androidx-core-ktx = { module = "androidx.core:core-ktx", version.ref = "androidx-core-ktx" } // build.gradle dependencies { implementation libs.androidx.core.ktx } -
(2) Data , . data: API, DB, SharedPreferences, DataStore Repository,
DataSource, DTO, Entity model: (ex. DTO, Enity annotation) Java, Kotlin :data :model :app -
// :data module interface ExampleRepository { suspend fun getExampleList(): List<Example>
} internal class ExampleRepositoryImpl(...) : ExampleRepository { ... } internal interface ExampleRemoteDataSource { ... } internal class ExampleRemoteDataSourceImpl(...) : ExampleRemoteDataSource { ... } internal class ExampleResponse(val something: String) internal interface ExampleLocalDataSource { ... } internal class ExampleLocalDataSourceImpl(...) : ExampleLocalDataSource { ... } internal class ExampleEntity(val something: String) // :model module class Example(val something: String) Repository৬ Model ېझ ৻ীח, internel ఃਕ٘ܳ ਊೞৈ Ӕਸ ઁೠೠ. -
(2) Data Legacy DB, SharedPreferences . interface app , data
. :app :data AppPreferences LegacyRemoteDataSource LegacyPreferences ExampleViewModel ExampleRepository ExampleApi ExamplePreferences ExamplePreferencesImpl ExampleRepositoryImpl internal LegacyLocalDataSource ExampleDatabase -
// :data module interface LegacyPreferences { var something: String }
interface ExamplePreferences : LegacyPreferences { ... } internal class ExamplePreferencesImpl( context: Context, private val legacyPrefs: LegacyPreferences, ) : ExamplePreferences, LegacyPreferences by legacyPrefs { ... } // :app module object AppPreferences : LegacyPreferences { override var something: String = ... } inte rf aceܳ ਊೞৈ, app ݽٕ Singletonਸ data ݽٕী ઁҕೡ ࣻ . -
// :app module @Module @InstallIn(SingletonComponent::class) object AppModule { @Provides fun
providesLegacyPreferences() : LegacyPreferences { return AppPreferences } } Hiltܳ ਊೞৈ, ઓࢿਸ ࢜۽ inte rf ace۽ ઁҕೡ ࣻ . -
// How to use - val something = AppPreferences.something +
@Inject + lateinit var prefs: ExamplePreferences + + val something = prefs.something ઁ ࢎਊೞ؍ ࠗ࠙ਸ ೞաঀ ജೡ ࣻ . -
(3) BuildConfig BuildCon fi g.DEBUG BuildCon fi g.VERSION_NAME BuildCon fi
g.API_BASE_URL (custom) -
// :app module android { defaultConfig { buildConfigField "String", "VERSION_NAME",
“String.valueOf(\"1.0.0\")" } flavorDimensions "default" productFlavors { dev { buildConfigField "String", "API_BASE_URL", "String.valueOf(\"https://dev...\")" } stage { buildConfigField "String", "API_BASE_URL", "String.valueOf(\"https://stage...\")" } real { buildConfigField "String", "API_BASE_URL", "String.valueOf(\"https://real...\")" } } } ࠁా fl avorী ٮۄ ч ׳ۄח ࢎਊ ٘ܳ ୶оೞৈ ࢎਊೠ. Link: h tt ps://developer.android.com/build/gradle-tips#share-custom- fi elds-and-resource-values-with-your-app-code -
(3) BuildConfig BuildCon fi g.DEBUG BuildCon fi g.VERSION_NAME BuildCon fi
g.API_BASE_URL (custom) data BuildConfig : (1) app . -
// :app module import soup.movie.BuildConfig // :data module import soup.movie.data.BuildConfig
... ࠛਃೞѱ BuildCon fi g ېझ ࣻо טযդ. -
(3) BuildConfig BuildCon fi g.DEBUG BuildCon fi g.VERSION_NAME BuildCon fi
g.API_BASE_URL (custom) data BuildConfig : (1) app . (2) BuildConfig . -
// :app module dependencies { implementation project(':buildconfig') } // :data
module dependencies { implementation project(':buildconfig') } ೧ਛա…? -
// :buildconfig module android { namespace 'soup.movie.buildconfig' defaultConfig { buildConfigField
"String", "VERSION_NAME", “String.valueOf(\"1.0.0\")" } buildFeatures { buildConfig true } flavorDimensions "default" productFlavors { dev { buildConfigField "String", "API_BASE_URL", "String.valueOf(\"https://dev...\")" } stage { buildConfigField "String", "API_BASE_URL", "String.valueOf(\"https://stage...\")" } real { buildConfigField "String", "API_BASE_URL", "String.valueOf(\"https://real...\")" } } } ઓࢿਸ ыח ݽٚ ݽٕী fl avorо غח ޙઁ. -
// :data module android { buildFeatures { buildConfig false }
flavorDimensions "default" productFlavors { dev {} dev2 {} stage {} real {} } } ೧Ѿೡ ࣻ ח ߑߨ ਸө…? // :app module android { buildFeatures { buildConfig false } flavorDimensions "default" productFlavors { dev {} dev2 {} stage {} real {} } } -
// :buildconfig-stub module android { namespace 'soup.movie.buildconfig' defaultConfig { buildConfigField
"String", "VERSION_NAME", "String.valueOf(\"0\")" buildConfigField "String", "API_BASE_URL", "String.valueOf(\"\")" } buildFeatures { buildConfig true } // productFlavors X } (1) fl avorо হח, stub ݽٕਸ ୶оೠ. -
// :app module dependencies { implementation project(':buildconfig') } // :data
module dependencies { compileOnly project(':buildconfig-stub') } (2) fl avorо ח app ݽٕ ৻ীח stubਸ compileOnly۽ ࢶೠ. -
(3) BuildConfig compileOnly , . , buildconfig-stub , buildconfig .
, flavor . :data :app :buildcon fi g :buildcon fi g-stub compileOnly implementation = :others … Link: h tt ps://developer.android.com/build/dependencies#dependency_con fi gurations -
:app :data :buildcon fi g :buildcon fi g-stub :model compileOnly
ߣীח app ݽٕীࢲ feature ݽٕਸ աׇࠁ. -
Feature Common (?) feature . : color, dimen, drawable, string,
style, … Base : Activity, Fragment, Dialog, … Widget, , , . . data ? :app :feature-common :data :feature:search :model api ? -
(4) Common , . kotlin: Kotlin, Coroutines logger: Log designsystem:
resources: … :common :data :feature:search :kotlin :logger :resources :designsystem api … Link: h tt ps://developer.android.com/topic/modularization/pa tt erns#common-modules -
(4) Common resources ID R . non-transitive R , R
. ( ) , R import . com.myapp.library2.R welcome_text = Hi, Songdo com.myapp.library1.R welcome_text = Hi, Songdo goodbye_text = Bye :library2 module welcome_text = Hi, Songdo :library1 module goodbye_text = Bye com.myapp.library.R welcome_text = Hi, Songdo com.myapp.library1.R goodbye_text = Bye non-transitive R classes Link: h tt ps://developer.android.com/build/optimize-your-build#use-non-transitive-r-classes -
// gradle.properties android.nonTransitiveRClass=true // :library2 module import com.myapp.library2.R val bar
= R.string.welcome_text // :library1 module import com.myapp.library1.R - val foo = R.string.welcome_text + val foo = com.myapp.library2.R.string.welcome_text val bar = R.string.goodbye drawable, string, color ١ ܻࣗझܳ ೞա ݽٕী فݶ…? Link: h tt ps://medium.com/androiddevelopers/5-ways-to-prepare-your-app-build-for-android-studio- fl amingo-release-da34616bb946 -
// gradle.properties android.nonTransitiveRClass=true // :library2 module - import com.myapp.library2.R +
import com.myapp.resources.R val bar = R.string.welcome_text // :library1 module - import com.myapp.library1.R + import com.myapp.resources.R val foo = R.string.welcome_text val bar = R.string.goodbye impo r ܳ ҙܻೞӝ ಞೞ. Link: h tt ps://medium.com/androiddevelopers/5-ways-to-prepare-your-app-build-for-android-studio- fl amingo-release-da34616bb946 -
(4) Common resources , override . override . com.myapp.library2.R welcome_text
= Hi, Incheon com.myapp.library1.R welcome_text = Hi, Incheon :library2 module welcome_text = Hi, Songdo :library1 module welcome_text = Hi, Incheon Link: h tt ps://developer.android.com/studio/projects/android-library#Considerations -
// :library2 module android { resourcePrefix 'myapp_lib2_' } <string name="welcome_text">Hi,
Songdo</string> // :library1 module android { resourcePrefix 'myapp_lib1_' } <string name="welcome_text">Hi, Incheon</string> // :app module val foo = R.string.myapp_lib2_welcome_text // Hi, Songdo val bar = R.string.myapp_lib1_welcome_text // Hi, Incheon (1) resourcePre fi xܳ ਊೞח ߑߨ. ೞ݅ ৻ࠗ ۄ࠳۞ܻীࢲ Ҁݶ…? Link: h tt ps://developer.android.com/reference/tools/gradle-api/8.2/com/android/build/api/dsl/CommonExtension#resourcePre fi x() -
// 3rd party library <string name="app_name">3rd Party Library</string> // :common:resources
module <string name="app_name">MyApp</string> // :app module android { sourceSets { main.res.srcDirs += '../common/resources/src/main/res' } } val foo = R.string.app_name // MyApp (2) জ ݽٕ sourceSetsী ܻࣗझ ݽٕ ಫ؊ܳ ୶оೞח ߑߨ. Link: h tt ps://developer.android.com/build/build-variants#con fi gure-sourcesets -
(5) Convention Plugins . , + . 2023 Gradle Kotlin
Link: h tt ps://docs.gradle.org/current/samples/sample_convention_plugins.html -
plugins { id 'com.android.library' id 'org.jetbrains.kotlin.android' } android { compileSdk
34 defaultConfig { minSdk 21 targetSdk 34 } compileOptions { sourceCompatibility JavaVersion.VERSION_11 targetCompatibility JavaVersion.VERSION_11 } kotlinOptions { jvmTarget = '11' } } plugins { id 'example.android.library' } ߈ࠂغח ٘ܳ ੌ ࣻ . -
plugins { id 'com.google.dagger.hilt.android' id 'org.jetbrains.kotlin.kapt' } dependencies { implementation
libs.hilt.android kapt libs.hilt.compiler } plugins { id 'example.android.hilt' } ݽٕ݃ pluginਸ ٜ݅ӝࠁח, ഝਊೡ ࣻ ח ױਤ۽ ա־ח Ѫ જ. -
// :feature:search module plugins { id 'example.android.library' id 'example.android.hilt' }
dependencies { implementation project(':common:kotlin') implementation project(':common:logger') implementation project(':common:designsystem') implementation project(':common:resources') implementation project(':data') implementation project(':model') } // :feature:search module plugins { id 'example.android.feature' } ա־ݶ ݻ ݅ਵ۽ ୡӝചೡ ࣻ Ҋ, ޘযࢲ ࢎਊೡ ࣻب . -
(6) Feature , . home: detail: search: settings: navigator: …
Link: h tt ps://developer.android.com/topic/modularization/pa tt erns#feature-modules :feature :app :home :search :se tt ings :data :navigator :detail -
(6) Feature navigator Feature , . :feature :app :home :detail
.DetailActivity .HomeActivity -
// :feature:detail module <manifest> <application> <activity android:name=".DetailActivity"/> </application> </manifest> //
:feature:home module startActivity(Intent(context, DetailActivity::class.java) э ݽٕীࢲח Activityܳ ଵઑೡ ࣻ ݅, ܲ ݽٕۄݶ…? -
// :feature:detail module <manifest> <application> <activity android:name=".DetailActivity" android:exported="true"> <intent-filter> ...
<data android:scheme="..." android:host="detail" /> </intent-filter> </activity> </application> </manifest> // :feature:home module startActivity(Intent(ACTION_VIEW, Uri.parse("...://detail")) ٩݂ب оמೞ. ೞ݅ ৻ࠗীب Activityо ֢ػ. -
// :feature:detail module <manifest> <application> <activity android:name=".DetailActivity" android:exported="true"> <intent-filter> ...
<data android:scheme="..." android:host="detail" /> </intent-filter> </activity> </application> </manifest> // :feature:home module startActivity(Intent(ACTION_VIEW, Uri.parse("...://detail?id=...")) ӒܻҊ ID э чਸ ׳೧ঠ ೠݶ…? -
(6) Feature navigator Feature , . :app :feature :home :detail
.DetailActivity .HomeActivity :navigator Navigator NavigatorImpl -
// :feature:navigator module sealed interface Destination class Detail(val id: String)
: Destination interface Navigator { fun createIntent(destination: Destination): Intent } // :feature:detail module class NavigatorImpl(private val context: Context) : Navigator { override fun createIntent(destination: Destination) { return when (destination) { is Detail -> Intent(context, DetailActivity::class.java) .putExtra(DetailActivity.EXTRA_ID, destination.id) ... } } } Activityী Ӕೡ ࣻ ח Ҕী ҳഅܳ ݅ٚ. -
// :feature:detail module <manifest> <application> <activity android:name=".DetailActivity" android:exported="false"/> </application> </manifest>
// :feature:home module startActivity(navigator.createIntent(Detail(id = ...))) ৻ࠗী Activityܳ ֢ೞ ঋҊ, ݽٕ р ചݶਸ زೡ ࣻ . -
(6) Feature navigator Activity , Fragment . :app :feature :home
:detail .DetailFragment .HomeFragment :navigator FragmentFactory FragmentFactoryImpl -
// :feature:navigator module sealed interface FragmentDestination class Detail(val id: String)
: FragmentDestination interface FragmentFactory { fun createFragment(destination: FragmentDestination): Fragment } // :app module class FragmentFactoryImpl : FragmentFactory { override fun createFragment(destination: FragmentDestination): Fragment { return when (destination) { is Detail -> DetailFragment.newInstance(id = destination.id) ... } } } Fragmentী Ӕೡ ࣻ ח Ҕী ҳഅܳ ݅ٚ. -
// :feature:detail module class DetailFragment : Fragment() { ... companion
object { fun newInstance(id: String): DetailFragment { ... } } } // :feature:home module fragmentManager.commit { val fragment = navigator.createFragment(Detail(id = ...)) add(R.id.fragment_view_container, fragment) } ݽٕ рী Fragmentܳ ҕਬೞৈ ࢎਊೡ ࣻ . -
:common :app :feature:navigator :data :common :designsystem :feature:search :logger :buildcon fi
g :buildcon fi g-stub :resources :model compileOnly … -
? :app :feature:se tt ings :feature:search :feature:navigator :data Link: h
tt ps://developer.android.com/topic/modularization -
internal . ( ) Link: h tt ps://kotlinlang.org/docs/visibility-modi fi ers.html#modules
:feature:search :data interface SearchRepository internal class SearchRepositoryImpl( ... ) : SearchRepository { ... } @Module @InstallIn(SingletonComponent::class) internal interface DataModule { @Provids fun provideSearchRepository(...) : SearchRepository { ... } } @HiltViewModel class SearchViewModel @Inject constructor( private val repository: SearchRepository, ) : ViewModel() { ... } -
Domain Layer , Data . UseCase . ( ) Link:
h tt ps://developer.android.com/topic/architecture/domain-layer#data-access-restriction UI Layer Domain Layer Data Layer -
// :ui module class ExampleViewModel @Inject constructor( private val repository:
ExampleRepository // X private val usecase: ExampleUseCase, ) { ... } // :domain module class ExampleUseCase( private val repository: ExampleRepository ) { ... } // :data module interface ExampleRepository { ... } internal class ExampleRepositoryImpl(...) : ExampleRepository { ... } :ui :domain :data -
Data Domain ? (DIP) app . ( ) impl ,
internal . Link: h tt ps://developer.android.com/topic/architecture/domain-layer#data-access-restriction UI Layer Domain Layer Data Layer App -
// :ui module class ExampleViewModel @Inject constructor( private val usecase:
ExampleUseCase, private val repository: ExampleRepository // O ) { ... } // :domain module class ExampleUseCase @Inject constructor( private val repository: ExampleRepository ) { ... } interface ExampleRepository { ... } // :data module internal class ExampleRepositoryImpl(...) : ExampleRepository { ... } Domain ݽٕী Dataо ೣԋ ח Ѫ ݏਸө…? :ui :domain :data -
-api, -impl , internal . runtimeOnly , -impl . Link:
h tt ps://developer.android.com/build/dependencies#dependency_con fi gurations :feature:search :data-api :data-impl runtimeOnly -
// :feature:search module dependencies { implementation project(':data-api') runtimeOnly project(':data-impl') }
// :data-impl module dependencies { implementation project(':data-api') } // :data-api module dependencies { ... } :feature:search :data-impl :data-api runtimeOnly -
// :feature-common module abstract class BaseActivity : AppCompatActivity { @Inject
lateinit var getCurrentLanguage: GetCurrentLanguageUseCase } // :feature:settings module interface GetCurrentLanguageUseCase { operator fun invoke(): Language } class LanguageSettingActivity : BaseActivity() { ... } :feature ܳ ٜয, Feature ݽٕী UI৬ Domain ۨযо ҕઓೞח ҃. :feature-common :se tt ings -
-api, -impl , . :feature-common :feature :se tt ings-api :app
:se tt ings-impl runtimeOnly Link: h tt ps://en.wikipedia.org/wiki/Circular_dependency -
// :feature-common module abstract class BaseActivity : AppCompatActivity { @Inject
lateinit var getCurrentLanguage: GetCurrentLanguageUseCase } // :feature:settings-api module interface GetCurrentLanguageUseCase { operator fun invoke(): Language } // :feature:settings-impl module class GetCurrentLanguageUseCaseImpl : GetCurrentLanguageUseCase { ... } class LanguageSettingActivity : BaseActivity() { ... } :feature-common :feature :se tt ings-api :se tt ings-impl impl ݽٕ api ݽٕਸ ଵઑೞҊ, ਵ۽ח ೡ ࣻ হ. -
-api, -impl -impl app , -impl . :app :feature:search-impl :feature-common
:feature:navigator-impl :data :feature:search-api :feature:navigator-api runtimeOnly runtimeOnly -
data -api, -impl . . Link: h tt ps://developer.android.com/topic/modularization/pa tt
erns#how_to_implement :data-impl :app :feature:search-impl :feature-common :feature:navigator-impl :data-api :feature:search-api :feature:navigator-api runtimeOnly runtimeOnly -
(7) Feature . -api: UseCase interface UI (Widget, ViewHolder )
-impl: UseCase class UI (Activity, Fragment, ViewModel ) :feature :app :search-impl :se tt ings-impl :se tt ings-api UseCase :search-api -
(7) Feature navigator runtimeOnly , Activity . :app :feature :home-impl
:detail-impl .DetailActivity .HomeActivity :navigator Navigator NavigatorImpl -
(7) Feature navigator Activity -impl -NavigatorImpl . :feature :navigator-impl :home-impl
:detail-impl DetailNavigatorImpl HomeNavigatorImpl :navigator-api Navigator NavigatorImpl HomeNavigator DetailNavigator -
// :feature:navigator module sealed interface Destination class Detail(val id: String)
: Destination // :app module class NavigatorImpl(private val context: Context) : Navigator { override fun createIntent(destination: Destination) { return when (destination) { is Detail -> Intent(context, DetailActivity::class.java) // X ... } } } জ ݽٕীࢲח -impl ݽٕ Activityী Ӕೡ ࣻ হ. -
// :feature:navigator-api module interface DetailNavigator { fun createIntent(destination: Detail): Intent
} // :feature:detail-impl module class DetailNavigatorImpl(private val context: Context) : DetailNavigator { override fun createIntent(destination: Detail): Intent { return Intent(context, DetailActivity::class.java) // O } } // :feature:navigator-impl module class NavigatorImpl(private val detailNavigator: DetailNavigator) : Navigator { override fun createIntent(destination: Destination) { ... } } Activityо ח -impl ݽٕীࢲ -NavigatorImplਸ ҳഅೞݶ ػ. -
(8) Data . , Conflict . :data :home-impl :detail-impl :search-impl
:database-impl :network-impl model … :home-api :detail-api :search-api :network-api :database-api -
:data :feature :navigator-impl :navigator-api :common :app :common :designsystem :logger :buildcon
fi g :buildcon fi g-stub :resources compileOnly … :search-impl :search-api :detail-impl :detail-api :search-api :search-impl :detail-api :detail-impl … -
:data :feature :navigator-impl :navigator-api :common :app :common :designsystem :logger :buildcon
fi g :buildcon fi g-stub :resources compileOnly … :search-impl :search-api :detail-impl :detail-api :search-api :search-impl :detail-api :detail-impl … :search-sample :detail-sample :designsystem-sample -
Dagger Hilt 6 ⚠ : = Gradle Module / @Module
= Dagger Module -
App Modularization (app, feature, data, common) :app:android :feature:home :data:books :feature:reviews
:feature:player :app:auto :core:network :data:reviews -
App Modularization: @Module Hilt @Module , . :app:android :feature:home :data:books
:feature:reviews :feature:player :app:auto :core:network :data:reviews @Module @Module @Module -
App Modularization: @Module @HiltAndroidApp Hilt Module . :app:android :feature:home :data:books
:core:network @Module @InstallIn(SingletonComponent::class) object FeatureHomeModule { ... } @Module @InstallIn(SingletonComponent::class) object DataBooksModule { ... } @Module @InstallIn(SingletonComponent::class) object CoreNetworkModule { ... } @HiltAndroidApp class MyApp : Application() -
Without Classpath Aggregation @Module . hilt_metadata :app:android :feature:home :data:books :core:network
implementation implementation api @Metadata @Metadata @InstallIn @InstallIn @InstallIn @Generated("dagger.hilt") interface MyApp_HiltComponents { @Component(modules = [ FeatureHomeModule::class, DataBooksModule::class, ... ]) interface SingletonC } CoreNetworkModule::class, Link: h tt ps://medium.com/androiddevelopers/mad-skills-series-hilt-under-the-hood-9d89ee227059 -
With Classpath Aggregation Classpath Aggregation , . (Gradle Plugin )
hilt_metadata :app:android :feature:home :data:books :core:network implementation implementation api @Metadata @Metadata @Metadata @InstallIn @InstallIn @InstallIn @Generated("dagger.hilt") interface MyApp_HiltComponents { @Component(modules = [ FeatureHomeModule::class, DataBooksModule::class, ... ]) interface SingletonC } CoreNetworkModule::class, Link: h tt ps://medium.com/androiddevelopers/mad-skills-series-hilt-under-the-hood-9d89ee227059 -
App Architecture Hilt , . :data class ExampleUseCase @Inject constructor(
private val repository: ExampleRepository ) { ... } :ui :domain class ExampleRepository @Inject constructor( ) { ... } -
App Architecture: interface, class , :domain :data class ExampleUseCase @Inject
constructor( private val repository: ExampleRepository ) { ... } class ExampleRepository @Inject constructor( ) { ... } -
App Architecture: interface, class interface class , . :domain :data
interface ExampleRepository class ExampleRepositoryImpl @Inject constructor( ) : ExampleRepository { ... } @Module @InstallIn(SingletonComponent::class) interface DataModule { @Binds fun bindRepository( impl: ExampleRepositoryImpl ) : ExampleRepository } class ExampleUseCase @Inject constructor( private val repository: ExampleRepository ) { ... } -
App Architecture: internal , internal . :domain :data interface ExampleRepository
internal class ExampleRepositoryImpl @Inject constructor( ) : ExampleRepository { ... } @Module @InstallIn(SingletonComponent::class) internal interface DataModule { @Binds fun bindRepository( impl: ExampleRepositoryImpl ) : ExampleRepository } class ExampleUseCase @Inject constructor( private val repository: ExampleRepository ) { ... } -
internal @Module , HiltWrapper internal @Module @OriginatingElement(topLevelClass = DataModule.class) @InstallIn(SingletonComponent.class)
@Module(includes = DataModule.class) public final class HiltWrapper_DataModule {} @Module @InstallIn(SingletonComponent::class) internal interface DataModule { @Binds fun bindRepository(impl: ExampleRepositoryImpl) : ExampleRepository } -
internal @Module न Componentী ୶о೧ળ. public final class ExampleApplication_HiltComponents {
@Component( modules = { ApplicationContextModule.class, ActivityRetainedCBuilderModule.class, HiltWrapper_DataModule.class, } ) @Singleton public abstract static class SingletonC implements HiltWrapper_ActivityRetainedComponentManager_ActivityRetainedComponentBuilderEntryPoint, SingletonComponent, GeneratedComponent { } } -
App Architecture: interface class . :domain-qux :domain-bar-api :domain-baz :domain-bar-impl interface
Bar class BarImpl(foo: Foo) : Bar interface Qux class QuxImpl(bar: Bar) : Qux interface Baz class BazImpl(bar: Bar) : Baz -
App Architecture: @Module . :domain-qux :domain-bar-api :domain-baz :domain-bar-impl interface Bar
class BarImpl(foo: Foo) : Bar -> interface Qux class QuxImpl(bar: Bar) : Qux @Module interface Baz class BazImpl(bar: Bar) : Baz -
App Architecture: (DIP) . :domain-qux-impl :domain-baz-impl :domain-bar-impl :domain-foo-impl class BazImpl(bar:
Bar) : Baz class BarImpl(foo: Foo) : Bar class FooImpl() : Foo class QuxImpl(baz: Baz) : Qux :domain-qux-api :domain-baz-api :domain-bar-api :domain-foo-api interface Baz interface Bar interface Foo interface Qux -
App Modularization: Final! . :app:android :feature:home-api :data:books-api :data:books-impl :app:android :feature:home
:data:books :feature:home-impl Before After implementation implementation -
App Modularization: Final! (+ runtimeOnly) , . :app:android :feature:home-api :data:books-api
:data:books-impl runtimeOnly :app:android :feature:home :data:books :feature:home-impl runtimeOnly Before After -
App Modularization: Final! (+ runtimeOnly) // app/build.gradle dependencies { implementation(projects(":feature:home-api"))
- implementation(projects(":feature:home-impl")) + runtimeOnly(projects(":feature:home-impl")) ... } // feature/home-impl/build.gradle dependencies { implementation(projects(":feature:home-api")) } -
Git Merge Conflict . . , Application . :app :feature
:home HomeData MyApplication :search SearchData -
// :app module class MyApplication : Application() { override fun
onCreate() { ... <<<<<<< HEAD HomeData.preload() ======= SearchData.preload() >>>>>>> ... } } ࢲ۽ ܲ PRীࢲ ୡӝച ೣࣻܳ ୶оೞݶ, Con fl ict ߊࢤೠ. -
Dagger Hilt app feature , feature app . :app :feature
:home-impl HomeInitializer :sta rt up-api Initializer Set<Initializer> :search-impl SearchInitializer -
// :feature:search-impl module @Module @InstallIn(SingletonComponent::class) interface SearchModule { @IntoSet @Binds
fun bindsInitializer(impl: SearchInitializer): Initializer } class SearchInitializer @Inject constructor() : Initializer { override operator fun invoke() { SearchData.preload(...) } } // :app module @HiltAndroidApp class MyApplication : Application() { @Inject lateinit var initializerSet: Set<@JvmSuppressWildcards Initializer> } // :feature:startup-api module interface Initializer { operator fun invoke() } -
Data, Common, Feature . , . Version Catalog, Convention Plugins
compileOnly + stub , fl avor . (ex. BuildCon fi g) -api, -impl , . , , runtimeOnly , app . . . , Con fl ict -
Dagger Hilt Hilt . @HiltAndroidApp class ExampleApplication : Application() {
@Inject lateinit var bar: Bar } @Module @InstallIn(SingletonComponent::class) object FooModule { @Provides fun provideBar(): Bar = Bar() } -
Dagger Hilt (1) . @HiltAndroidApp class ExampleApplication : Application() {
@Inject lateinit var bar: Bar } @Module @InstallIn(SingletonComponent::class) object FooModule { @Provides fun provideBar(): Bar = Bar() } -
@HiltAndroidApp class ExampleApplication : Application() // -------------------------------------------------------------------------------- // Generated by
Hilt public final class ExampleApplication_HiltComponents { @Component(modules = { ActivityRetainedCBuilderModule.class, ... }) @Singleton public abstract static class SingletonC implements SingletonComponent { } ... } // -------------------------------------------------------------------------------- // Generated by Dagger public final class DaggerExampleApplication_HiltComponents_SingletonC { // ઓࢿ ஶపց private static final class SingletonCImpl extends ExampleApplication_HiltComponents.SingletonC { public void injectExampleApplication(ExampleApplication exampleApplication) {} } ... } @HiltAndroidApp - ઓࢿ ஶపցܳ ࢤࢿೠ. -
Dagger Hilt (2) . @HiltAndroidApp class ExampleApplication : Application() {
@Inject lateinit var bar: Bar } @Module @InstallIn(SingletonComponent::class) object FooModule { @Provides fun provideBar(): Bar = Bar() } -
ࢶೠ Componentী Module ୶оػ. @Module @InstallIn(SingletonComponent::class) object FooModule { @Provides
fun provideBar(): Bar = Bar() } // -------------------------------------------------------------------------------- public final class ExampleApplication_HiltComponents { @Component( modules = { ApplicationContextModule.class, ActivityRetainedCBuilderModule.class, FooModule.class, } ) @Singleton public abstract static class SingletonC implements HiltWrapper_ActivityRetainedComponentManager_ActivityRetainedComponentBuilderEntryPoint, SingletonComponent, GeneratedComponent { } } -
@Provides݃ ઓࢿਸ ઁҕೞח Factory ېझо ࢤࢿػ. @Module @InstallIn(SingletonComponent::class) object FooModule
{ @Provides fun provideBar(): Bar = Bar() } // -------------------------------------------------------------------------------- public final class FooModule_ProvideBarFactory implements Factory<Bar> { public static Bar provideBar() { return Preconditions.checkNotNullFromProvides(FooModule.INSTANCE.provideBar()); } } -
Dagger Hilt (3) . @HiltAndroidApp class ExampleApplication : Application() {
@Inject lateinit var bar: Bar } @Module @InstallIn(SingletonComponent::class) object FooModule { @Provides fun provideBar(): Bar = Bar() } Hilt_ExampleApplication.java ExampleApplication_GeneratedInjector.java ExampleApplication_MembersInjector.java -
@HiltAndroidApp class ExampleApplication : Application() { @Inject lateinit var bar:
Bar } = @HiltAndroidApp class ExampleApplication : Hilt_ExampleApplication() { @Inject lateinit var bar: Bar } ߄٘ܳ ߸ജೞৈ, ࠗݽ ېझܳ ߸҃ೠ. (Gradle Plugin) -
Hilt_ExampleApplication.java public abstract class Hilt_ExampleApplication extends Application { private boolean
injected = false; @CallSuper @Override public void onCreate() { if (!injected) { injected = true; ((ExampleApplication_GeneratedInjector) componentManager.generatedComponent()) .injectExampleApplication(this); } super.onCreate(); } private final ApplicationComponentManager componentManager = new ApplicationComponentManager( () -> DaggerExampleApplication_HiltComponents_SingletonC.builder() .applicationContextModule(new ApplicationContextModule(Hilt_ExampleApplication.this)) .build()); } Injector۽ SingletonCী Ӕೞৈ, ઓࢿ ੑਸ ਃೠ. -
ExampleApplication_GeneratedInjector.java @GeneratedEntryPoint @InstallIn(SingletonComponent.class) public interface ExampleApplication_GeneratedInjector { void injectExampleApplication(ExampleApplication exampleApplication);
} // -------------------------------------------------------------------------------- public final class ExampleApplication_HiltComponents { @Component(modules = { ... }) @Singleton public abstract static class SingletonC implements HiltWrapper_ActivityRetainedComponentManager_ActivityRetainedComponentBuilderEntryPoint, SingletonComponent, GeneratedComponent, ExampleApplication_GeneratedInjector { } } // -------------------------------------------------------------------------------- public final class DaggerExampleApplication_HiltComponents_SingletonC { private static final class SingletonCImpl extends SingletonC { public void injectExampleApplication(ExampleApplication instance) { } } -
ExampleApplication_MembersInjector.java @HiltAndroidApp class ExampleApplication : Application() { @Inject lateinit var
bar: Bar } // -------------------------------------------------------------------------------- public final class ExampleApplication_MembersInjector implements MembersInjector<ExampleApplication> { public static void injectBar(ExampleApplication instance, Bar bar) { instance.bar = bar; } } // -------------------------------------------------------------------------------- public final class DaggerExampleApplication_HiltComponents_SingletonC { private static final class SingletonCImpl extends SingletonC { public void injectExampleApplication(ExampleApplication instance) { ExampleApplication_MembersInjector.injectBar( instance, FooModule_ProvideBarFactory.provideBar()); } } ࢤࢿػ Injector ېझܳ ా೧, উ٘۽٘ ېझী ઓࢿ ੑػ. -
Dagger Hilt Dagger Hilt . ( ) Link: h tt
ps://youtu.be/iE_2llWUI6A -
Dagger Hilt . (KAPT/KSP) Gradle Plugin @AndroidEntryPoint Hilt Base .
, Compiler . Hilt Dagger , Compiler . Factory Injector I/O . , . . -
Dagger Hilt , -impl . :data-impl :app :feature:search-impl :feature-common :feature:detail-impl
:data-api :feature:search-api :feature:detail-api runtimeOnly runtimeOnly -
Dagger Hilt , @Module . :data-impl :app :feature:search-impl :feature-common :feature:detail-impl
:data-api :feature:search-api :feature:detail-api runtimeOnly runtimeOnly @Module @Module @Module -
Dagger Hilt , . hilt_metadata :f:search-impl :f:detail-impl :data:impl @Metadata @Metadata
@Metadata @InstallIn @InstallIn @InstallIn @Generated("dagger.hilt") interface MyApp_HiltComponents { @Component(modules = [ FeatureSearchModule::class, FeatureDetailModule::class, ... ]) interface SingletonC } DataModule::class, -
Android ߂ Java ਊ ઓࢿ ੑ ۨਕ. ஹੌ ఋী ࣗझ٘
ࢤࢿ. Dependency Injection ಁఢ. https://github.com/google/dagger Dagger ӝ߈ Android ઓࢿ ੑ ۨਕ. ࠗ࠙ Dagger ࢚ਊҳ ઁѢ. Dependency Injection ಁఢ. https://github.com/google/dagger Dagger Hilt Dagger ઓࢿ ੑਸ ؊ औѱ ݅٘ח Kotlin ஹੌ۞ ۞Ӓੋ. Dependency Injection ಁఢ. https://github.com/square/anvil Anvil Kotlin ҃ ઓࢿ ੑ ۨਕ. ۠ఋী ઓࢿ Ӓې ҳࢿ. Service Locator ಁఢ. https://github.com/InsertKoinIO/koin Kotlin ਊ ઓࢿ ੑ ۄ࠳۞ܻ. ஹੌ ఋী ઓࢿ Ӓې ਬബࢿ Ѩࢎ. KSP, Kotlin Multiplatform ਗ. https://github.com/evant/kotlin-inject Koin kotlin-inject … -
Anvil Dagger Kotlin Anvil 2020 , Dagger KAPT . KAPT
Kotlin Java Stub javac Annotation Processor , . Anvil Kotlin Compiler Plugin . Dagger Factory Kotlin , KAPT Java Stub . Dagger @Component / (IR) . @ContributesTo, @ContributesBinding , . (Aggregation) KAPT , -
@Scope @Documented @Retention(RUNTIME) public @interface Singleton {} @Singleton @DefineComponent public
interface SingletonComponent {} → (Hilt) ܻ ػ Scope // -------------------------------------------------------------------------------- abstract class AppScope private constructor() → (Anvil) Scope ࣻز ࢤࢿ Anvil ਃೠ Scope݅ ೠ. -
@Module @InstallIn(SingletonComponent::class) object BarModule { @Provides fun provideBar(): Bar =
Bar() } // -------------------------------------------------------------------------------- @Module @ContributesTo(AppScope::class) object BarModule { @Provides fun provideBar(): Bar = Bar() } Providesܳ ਤೠ Module ח ࠺तೞ. -
@Module @InstallIn(SingletonComponent::class) interface FooModule { @Binds fun bindsFoo(impl: FooImpl): Foo
} class FooImpl @Inject constructor() : Foo { ... } // -------------------------------------------------------------------------------- @ContributesBinding(AppScope::class) class FooImpl @Inject constructor() : Foo { ... } Anvil Bindingਸ ਤೠ Module ੌ о ࠛਃೞ. -
@AndroidEntryPoint class HomeActivity : ComponentActivity() { @Inject lateinit var bar:
Bar } → Hilt_HomeActivity.java ࢤࢿ → HomeActivity_GeneratedInjector.java ࢤࢿ → HomeActivity_MembersInjector.java ࢤࢿ // -------------------------------------------------------------------------------- class HomeActivity : ComponentActivity() { @Inject lateinit var bar: Bar override fun onCreate(savedInstanceState: Bundle?) { appComponent.inject(this) super.onCreate(savedInstanceState) } } → HomeActivity_MembersInjector.java ࢤࢿ Anvil Hilt ࠺ ࢤࢿغח ੌ ࣻо ѱ যٚ. -
@AndroidEntryPoint class HomeActivity : ComponentActivity() { @Inject lateinit var bar:
Bar } → Hilt_HomeActivity.java ࢤࢿ → HomeActivity_GeneratedInjector.java ࢤࢿ → HomeActivity_MembersInjector.java ࢤࢿ // -------------------------------------------------------------------------------- class HomeActivity : ComponentActivity() { @Inject lateinit var bar: Bar override fun onCreate(savedInstanceState: Bundle?) { appComponent.inject(this) super.onCreate(savedInstanceState) } } → HomeActivity_MembersInjector.java ࢤࢿ Anvil Hiltۢ Base ېझܳ ߄Բח ߄٘ ߸ജ হ. -
SingletonC ȍȇȇ ServiceC └── ActivityRetainedC └── ActivityC ȍȇȇ ViewModelC ȍȇȇ
ViewC ȍȇȇ ComposableC └── FragmentC └── ViewWithFragmentC → (Hilt) 8ѐ ஹನք ز ࢤࢿ // -------------------------------------------------------------------------------- @MergeComponent(AppScope::class) interface AppComponent → (Anvil) ஹನք ࣻز ࢤࢿ Anvil ਃೠ ஹನքܳ ೞৈ, ࢤࢿغח ٘о যٚ. -
@HiltAndroidApp class ExampleApplication : Application() { ... } → (Hilt)
ઓࢿ ஶపց ز ࢤࢿ // -------------------------------------------------------------------------------- class ExampleApplication : Application() { val component by lazy { DaggerAppComponent.factory().create(this) } ... } → (Anvil) ઓࢿ ஶపց ࣻز ࢤࢿ Anvil Hiltۢ Base ېझܳ ߄Բח ߄٘ ߸ജ হ. -
Dagger Hilt Dagger Hilt KAPT/KSP . Gradle Plugin . :data-impl
:app :feature:search-impl :feature-common :feature:detail-impl :data-api :feature:search-api :feature:detail-api Hilt @Module (KAPT/KSP) Hilt @Module (KAPT/KSP) (KAPT/KSP) Hilt @Module Hilt (KAPT/KSP) -
Anvil Anvil KCP Dagger Module Factory, Hint . Hint @MergeComponent
Dagger @Component . Dagger . (KAPT) :data-impl :app :feature:search-impl :feature-common :feature:detail-impl :data-api :feature:search-api :feature:detail-api Anvil @Module (KCP) Anvil @Module (KCP) (KCP) Anvil @Module Anvil @MergeComponent (KCP) + Dagger (KAPT) -
Anvil Anvil . class ExampleApplication : Application() { @Inject lateinit
var foo: Foo } @ContributesBinding(AppScope::class) class FooImpl @Inject constructor() : Foo { ... } -
Anvil (1) . // :core:di module abstract class AppScope private
constructor() // :feature:foo-impl module @ContributesBinding(AppScope::class) class FooImpl @Inject constructor() : Foo { ... } // :app module @Singleton @MergeComponent(AppScope::class) interface AppComponent { ... } -
// Hint ݫఋؘఠ public val io_github_fornewid_feature_foo_impl_FooImpl_reference: KClass<FooImpl> = FooImpl::class public
val io_github_fornewid_feature_foo_impl_FooImpl_scope0: KClass<AppScope> = AppScope::class // Factory ېझ public object FooImpl_Factory : Factory<FooImpl> { override fun `get`(): FooImpl = newInstance() @JvmStatic public fun create(): FooImpl_Factory = this @JvmStatic public fun newInstance(): FooImpl = FooImpl() } Hint ੌҗ Factoryܳ ࢤࢿೠ. -
// о࢚ ߄ੋ٬ ݽٕ ࢤࢿ @Module @ContributesTo(AppScope::class) public abstract class
AppComponentAnvilModule { @Binds public abstract fun bindFoo(fooImpl: FooImpl): Foo } // ߄٘ܳ ߸ઑೞৈ, @MergeComponentо ࣽࣻ Dagger @Component۽ ജ @Singleton() @MergeComponent(scope = AppScope.class) @Component(modules = {AppComponentAnvilModule.class}) @kotlin.Metadata(...) public abstract interface AppComponent { ... } IRਸ ઑೞৈ ࠙ػ ٘ܳ ೞա۽ . -
Anvil (2) . // :app module @Singleton @MergeComponent(AppScope::class) interface AppComponent
{ fun inject(application: ExampleApplication) @Component.Factory interface Factory { fun create(@BindsInstance application: Application): AppComponent } } -
@Singleton() @MergeComponent(scope = AppScope.class) @Component(modules = {AppComponentAnvilModule.class}) @kotlin.Metadata(...) public abstract
interface AppComponent { public abstract void inject(@NotNull() ExampleApplication application); @dagger.Component.Factory() @kotlin.Metadata(...) public static abstract interface Factory { @NotNull() public abstract AppComponent create( @BindsInstance() @NotNull() Application application ); } } Anvil Hintܳ ӝ߈ਵ۽ Dagger @Componentܳ ҳࢿೠ. -
@DaggerGenerated @Generated(...) public final class DaggerAppComponent { public static AppComponent.Factory
factory() { return new Factory(); } private static final class Factory implements AppComponent.Factory { @Override public AppComponent create(Application application) { Preconditions.checkNotNull(application); return new AppComponentImpl(application); } } private static final class AppComponentImpl implements AppComponent { private final AppComponentImpl appComponentImpl = this; private AppComponentImpl(Application applicationParam) {} @Override public void inject(ExampleApplication application) {} } } Daggerо ୭ઙ ஶపցܳ ࢤࢿೠ. -
Anvil (3) . // :app module class ExampleApplication : Application()
{ @Inject lateinit var foo: Foo val appComponent by lazy { DaggerAppComponent.factory().create(this) } override fun onCreate() { super.onCreate() appComponent.inject(this) } } -
// Generated by Anvil. public class ExampleApplication_MembersInjector( private val foo:
Provider<Foo>, ) : MembersInjector<ExampleApplication> { override fun injectMembers(instance: ExampleApplication) { ExampleApplication_MembersInjector.injectFoo(instance, foo.get()) } public companion object { @JvmStatic public fun create(foo: Provider<Foo>): MembersInjector<ExampleApplication> = ExampleApplication_MembersInjector(foo) @JvmStatic @InjectedFieldSignature("io.github.fornewid.dagger.hilt.example.ExampleApplication.foo") public fun injectFoo(instance: ExampleApplication, foo: Foo) { instance.foo = foo } } } Anvil Injectorܳ ࢤࢿೠ. -
@DaggerGenerated @Generated(...) public final class DaggerAppComponent { ... private static
final class AppComponentImpl implements AppComponent { private final AppComponentImpl appComponentImpl = this; private AppComponentImpl(Application applicationParam) {} @Override public void inject(ExampleApplication application) { injectExampleApplication(application); } private ExampleApplication injectExampleApplication(ExampleApplication instance) { ExampleApplication_MembersInjector.injectFoo(instance, new FooImpl()); return instance; } } } Daggerо ୭ઙ ஶపցী Injectorо ನೣػ. -
Anvil vs Hilt Anvil KCP , KAPT . @ContributesTo ,
@MergeComponent Dagger @Component . Dagger . (KAPT) Dagger Hilt KAPT, KSP . @AndroidEntryPoint, @InstallIn , Dagger @Component . Dagger . (KAPT, KSP) -
Anvil K2 Kotlin Compiler Plugin API . K1 K2 .
KAPT Factory, Hint IR , KAPT/KSP . app KAPT . (Dagger) Hint I/O , anvil.hint Hint . app Hint . -
Android ߂ Java ਊ ઓࢿ ੑ ۨਕ. ஹੌ ఋী ࣗझ٘
ࢤࢿ. Dependency Injection ಁఢ. https://github.com/google/dagger Dagger ӝ߈ Android ઓࢿ ੑ ۨਕ. ࠗ࠙ Dagger ࢚ਊҳ ઁѢ. Dependency Injection ಁఢ. https://github.com/google/dagger Dagger Hilt Dagger ઓࢿ ੑਸ ؊ औѱ ݅٘ח Kotlin ஹੌ۞ ۞Ӓੋ. Dependency Injection ಁఢ. https://github.com/square/anvil Anvil Kotlin ҃ ઓࢿ ੑ ۨਕ. ۠ఋী ઓࢿ Ӓې ҳࢿ. Service Locator ಁఢ. https://github.com/InsertKoinIO/koin Kotlin ਊ ઓࢿ ੑ ۄ࠳۞ܻ. ஹੌ ఋী ઓࢿ Ӓې ਬബࢿ Ѩࢎ. KSP, Kotlin Multiplatform ਗ. https://github.com/evant/kotlin-inject Koin kotlin-inject Metro Kotlin ஹੌ۞ ۞Ӓੋਸ ӝ߈ਵ۽ ೞח Kotlin ਊ ઓࢿ ੑ ۨਕ. KMP ਗ. ஹੌ ఋী ઓࢿ Ӓې ਬബࢿ Ѩࢎ. https://github.com/ZacSweers/metro -
Metro Dagger, Anvil, kotlin-inject Kotlin DI (KAPT/KSP) , Kotlin (FIR/IR
) . Kotlin , . Anvil (Aggregation) , . Dagger Anvil . KAPT/KSP , -
@Scope @Documented @Retention(RUNTIME) public @interface Singleton {} @Singleton @DefineComponent public
interface SingletonComponent {} → (Hilt) ܻ ػ Scope // -------------------------------------------------------------------------------- abstract class AppScope private constructor() → (Metro) Scope ࣻز ࢤࢿ Metroب ਃೠ Scopeਸ ೠ. -
@Module @InstallIn(SingletonComponent::class) object BarModule { @Provides fun provideBar(): Bar =
Bar() } // -------------------------------------------------------------------------------- @ContributesTo(AppScope::class) interface BarModule { @Provides fun provideBar(): Bar = Bar() } → (Metro) @Module য֢ప࣌ ઁѢ Providesܳ ਤೠ ח ࠺तೞ. -
@Module @InstallIn(SingletonComponent::class) interface FooModule { @Binds fun bindsFoo(impl: FooImpl): Foo
} class FooImpl @Inject constructor() : Foo { ... } // -------------------------------------------------------------------------------- @ContributesBinding(AppScope::class) @Inject class FooImpl : Foo { ... } Metroب Bindingਸ ਤೠ Module ੌ о ࠛਃೞ. -
SingletonC ȍȇȇ ServiceC └── ActivityRetainedC └── ActivityC ȍȇȇ ViewModelC ȍȇȇ
ViewC ȍȇȇ ComposableC └── FragmentC └── ViewWithFragmentC → (Hilt) 8ѐ ஹನք ز ࢤࢿ // -------------------------------------------------------------------------------- @DependencyGraph(AppScope::class) interface AppGraph { ... } → (Metro) ઓࢿ Ӓې ࣻز Metroח ઓࢿ Ӓېܳ ೧ঠ ೠ. -
@HiltAndroidApp class ExampleApplication : Application() { ... } → (Hilt)
ઓࢿ ஶపց ز ࢤࢿ // -------------------------------------------------------------------------------- class ExampleApplication : Application(), AppGraphProvider { override val appGraph: AppGraph by lazy { createGraphFactory<AppGraph.Factory>().create(this) } } → (Metro) ઓࢿ Ӓې ࣻز ࢤࢿ ӒܻҊ Applicationীࢲ ઓࢿ Ӓېܳ ࢤࢿ೧ঠ ೠ. -
@AndroidEntryPoint class HomeActivity : ComponentActivity() { @Inject lateinit var bar:
Bar } → Hilt_HomeActivity.java ࢤࢿ → HomeActivity_GeneratedInjector.java ࢤࢿ → HomeActivity_MembersInjector.java ࢤࢿ // -------------------------------------------------------------------------------- class HomeActivity : ComponentActivity() { private val appGraph by lazy { appGraph<AppGraph>() } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val bar: Bar = appGraph.bar } } inline fun <reified T> Context.appGraph(): T { return (applicationContext as ExampleApplication).appGraph as T } Metroח ٘ ੑ হҊ, ઓࢿ Ӓېী Ӕ೧ঠ ೠ. -
Metro Metro KCP FIR/IR , . Hilt Anvil . :data-impl
:app :feature:search-impl :feature-common :feature:detail-impl :data-api :feature:search-api :feature:detail-api Metro .class (KCP) Metro .class (KCP) (KCP) Metro .class Metro .class (KCP) -
Metro Build Pipeline Metro . kotlinc binary files (.class) compileKotlin
source files (.kt) Metro -
Metro Build Pipeline Metro Kotlin FIR, IR . binary files
(.class) source files (.kt) Parse/PSI FIR Frontend Lowering IR Backend fir2ir Declaration ࢤࢿ Supertype ୶о Status ߸ജ Checker Factory ࢤࢿ Graph ҳഅ createGraph ജ -
Metro Metro . class ExampleApplication : Application() { override fun
onCreate() { super.onCreate() val foo: Foo = appGraph.foo } } @ContributesBinding(AppScope::class) @Inject class FooImpl : Foo { ... } -
Metro abstract class AppScope private constructor() @ContributesBinding(AppScope::class) @Inject class FooImpl
: Foo { ... } @DependencyGraph(AppScope::class) interface AppGraph { val foo: Foo } class ExampleApplication : Application() { override val appGraph: AppGraph by lazy { createGraph<AppGraph>() } } -
FIR: Declaration // Contribution interfaces ࢤࢿ // FooImpl$MetroContributionToAppScope.class public interface
FooImpl$MetroContributionToAppScope { Foo bindsAsFoo(FooImpl contributed); // FooImpl → Foo ߄ੋ٬ ࠁ } // Hint ࢤࢿ // metro/hints/IoGithubFornewidFeatureFooImplFooImplAppScopeKt.class public final class metro.hints.IoGithubFornewidFeatureFooImplFooImplAppScopeKt { public static final void AppScope(FooImpl contributed) { throw new IllegalStateException("Never called"); } // ࠄޙ হ. ೣࣻ दӒפ৬ Kotlin Metadata݅ ࢎਊؽ. // app ݽٕ ஹੌ द, ஹੌ۞о ݫݽܻী ۽٘ೠ ࠁܳ // FirSessionীࢲ ௪ܻೞৈ "FooImpl AppScopeী ӝৈೠ"ܳ ঈೣ. } -
FIR: Supertype // খীࢲ ࢤࢿೠ ੋఠಕझܳ AppGraphী ੑ // AppGraph.class
public interface AppGraph extends FooImpl$MetroContributionToAppScope { Foo getFoo(); } -
FIR: Status // Declaration visibility ١ Statusܳ ઑೠ. // ܳ
ٜয, @Provides privateਵ۽ ࢶغয যب, AppGraph$Implীࢲ Ӕೡ ࣻ ب۾ оदࢿਸ ઑೠ. @ContributesTo(AppScope::class) interface BarModule { @Provides private fun providesBar(): Bar = BarImpl() // private → internal۽ ઑ } // Kotlin ஹੌ۞ীࢲ ݽٚ ࢶ(ېझ, ೣࣻ, ۽ಌ౭) Statusܳ ыҊ : FirDeclarationStatus { visibility: Visibility — PUBLIC, PRIVATE, INTERNAL, PROTECTED modality: Modality — FINAL, OPEN, ABSTRACT, SEALED isExpect: Boolean — expect ࢶੋ isActual: Boolean — actual ࢶੋ isOverride: Boolean — overrideੋ isInline: Boolean — inline funੋ isSuspend: Boolean — suspend funੋ isConst: Boolean — const valੋ isLateInit: Boolean — lateinit varੋ ... -
FIR: Checker // য֢ప࣌ ਬബࢿਸ Ѩࢎೠ. ਃ Checker: DependencyGraphChecker —
@DependencyGraphо interfaceੋ, ࢤࢿ ۄఠ হח InjectConstructorChecker — @Inject ېझо abstractо ইצ, ࠂ @Inject হח BindingContainerCallableChecker — @Provides ೣࣻ ߈ജ ఋੑ ਬബೠ CreateGraphChecker — createGraph() ఋੑ ੋী @DependencyGraphо ח AggregationChecker — @ContributesBinding ېझо ৢ߄ܲ ഋకੋ AssistedInjectChecker — @AssistedFactory ۄఠо ݒடغח MembersInjectChecker — ݯߡ ੑ regular classীࢲ݅ ࢎਊغח MultibindsChecker — @IntoMap, @IntoSet ١ ৢ߄ܰѱ ࢎਊغח ... ৻ 8ѐ → ਤ߈ द IDEী द ࡈр द (࠽٘ प೯ ী ഛੋ оמ) → KSPח ࠽٘ܳ ج۰ঠ য়ܨܳ ঌ ࣻ ݅, Metroח ٘ ࢿ द ೖ٘ߔ -
IR: Factory // FooImpl$MetroFactory.class ࢤࢿ public final class FooImpl$MetroFactory implements
Factory<FooImpl> { public static final FooImpl$MetroFactory INSTANCE; // यӖఢ public final FooImpl newInstance() { return new FooImpl(); // ࢤࢿ ഐ } } -
IR: // AppGraph$Impl.class ࢤࢿ public final class AppGraph$Impl implements AppGraph
{ // unscoped → ݒߣ new۽ ࢤࢿ public Foo getFoo() { return new FooImpl(); } } -
IR: // ѐߊо ࢿೠ ٘ val appGraph: AppGraph by lazy
{ createGraph<AppGraph>() } // Metro ղࠗ ٘ public inline fun <reified T : Any> createGraph(): T { throw UnsupportedOperationException("Implemented by the compiler") } // IR ജ റ private static final AppGraph appGraph_delegate$lambda$0() { return new AppGraph$Impl(); // createGraphо ࢤࢿ ഐ۽ ജؽ } -
Metro . class ExampleApplication : Application() { override val appGraph:
AppGraph by lazy { createGraph<AppGraph>() } override fun onCreate() { super.onCreate() val foo: Foo = appGraph.foo } } -
Hilt: [kotlinc] [KSP:Hilt] [KSP:Dagger] [javac] [ ] 5 Anvil: [kotlinc
+ Anvil KCP] [KAPT:Dagger] [javac] 3 Metro: [kotlinc + Metro KCP] 1 Metro AppGraph$Impl.class ExampleApplication Foo -
Anvil Metro KSP/KAPT , 100% Compiler Plugin . Hint ,
I/O . .class , . @Module @ContributesBinding , . KSP , Metro FIR Checker . (IDE ) Kotlin Multiplatform . -
Metro Kotlin Version Coupling JetBrains Kotlin API(FIR, IR) , Kotlin
. Metro Kotlin . Kotlin 2.0 (K2 ) . 0.x ( 0.13.2) API . , . Kotlin , . . -
Migration Metro Dagger, Anvil, kotlin-inject . . , Dagger Hilt
Hilt Metro . ( ...) Dagger Hilt Anvil Metro Dagger @Deprecated -
Dagger Hilt , . Hilt . Hilt Anvil KSP ,
Anvil Metro KSP . . .