DaggerViewModel
An integration Module for injecting Google Architecture Components' ViewModel into Dagger2-injected Android activities and fragments.
This library was inspired by the official GithubBrowserSample example.
Installation
Add one of the following lines in the dependencies
section of your Android build.gradle
file:
implementation 'com.alexfacciorusso:daggerviewmodel:0.2.0'
Usage
Install the library, then bind your ViewModel
into an abstract @Module
class, annotating your binding method with @IntoMap
and @ViewModelKey
with your custom ViewModel
class as parameter.
For example:
@Module
abstract class ViewModelModule {
@Binds
@IntoMap
@ViewModelKey(MyViewModel::class)
abstract fun bindsMainViewModel(myViewModel: MyViewModel): ViewModel
// other binds...
}
Then add the DaggerViewModelModule
and the module containing your ViewModel
s (in our example, ViewModelModule
) to your Application component:
Kotlin
@Singleton
@Component(modules = arrayOf(AndroidSupportInjectionModule::class, DaggerViewModelInjectionModule::class,
your other modules...))
interface ApplicationComponent {
// your component definitions ...
}
Java
@Singleton
@Component(modules = {AndroidSupportInjectionModule.class, DaggerViewModelInjectionModule.class,
your other modules...})
public interface ApplicationComponent {
// your component definitions ...
}
And finally @Inject
a ViewModelProvider.Factory
into your Activity/Fragment and use it to create your ViewModel.
Kotlin
class MainActivity : AppCompatActivity() {
@Inject
lateinit var viewModelFactory: ViewModelProvider.Factory
private lateinit var viewModel: MyViewModel
override fun onCreate(savedInstanceState: Bundle?) {
AndroidInjection.inject(this)
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
viewModel = ViewModelProviders.of(this, viewModelFactory).get(MyViewModel::class.java)
// ...
}
// ...
}
Java
public class MainActivity extends AppCompatActivity {
@Inject
ViewModelProvider.Factory viewModelFactory;
private MyViewModel viewModel;
void onCreate(Bundle savedInstanceState) {
AndroidInjection.inject(this);
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
viewModel = ViewModelProviders.of(this, viewModelFactory).get(MyViewModel.class);
// ...
}
// ...
}
License
Copyright 2017-2019 Alex Facciorusso.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.