├── app
├── .gitignore
├── src
│ └── main
│ │ ├── res
│ │ ├── mipmap-hdpi
│ │ │ ├── ic_launcher.png
│ │ │ └── ic_launcher_round.png
│ │ ├── mipmap-mdpi
│ │ │ ├── ic_launcher.png
│ │ │ └── ic_launcher_round.png
│ │ ├── mipmap-xhdpi
│ │ │ ├── ic_launcher.png
│ │ │ └── ic_launcher_round.png
│ │ ├── mipmap-xxhdpi
│ │ │ ├── ic_launcher.png
│ │ │ └── ic_launcher_round.png
│ │ ├── mipmap-xxxhdpi
│ │ │ ├── ic_launcher.png
│ │ │ └── ic_launcher_round.png
│ │ ├── values
│ │ │ ├── strings.xml
│ │ │ ├── colors.xml
│ │ │ └── styles.xml
│ │ ├── mipmap-anydpi-v26
│ │ │ ├── ic_launcher.xml
│ │ │ └── ic_launcher_round.xml
│ │ ├── layout
│ │ │ ├── activity_main.xml
│ │ │ └── item_layout.xml
│ │ ├── drawable-v24
│ │ │ └── ic_launcher_foreground.xml
│ │ └── drawable
│ │ │ └── ic_launcher_background.xml
│ │ ├── java
│ │ └── com
│ │ │ └── mindorks
│ │ │ └── framework
│ │ │ └── mvi
│ │ │ ├── ui
│ │ │ └── main
│ │ │ │ ├── intent
│ │ │ │ └── MainIntent.kt
│ │ │ │ ├── viewstate
│ │ │ │ └── MainState.kt
│ │ │ │ ├── adapter
│ │ │ │ └── MainAdapter.kt
│ │ │ │ ├── viewmodel
│ │ │ │ └── MainViewModel.kt
│ │ │ │ └── view
│ │ │ │ └── MainActivity.kt
│ │ │ ├── data
│ │ │ ├── api
│ │ │ │ ├── ApiHelper.kt
│ │ │ │ ├── ApiService.kt
│ │ │ │ ├── ApiHelperImpl.kt
│ │ │ │ └── RetrofitBuilder.kt
│ │ │ ├── repository
│ │ │ │ └── MainRepository.kt
│ │ │ └── model
│ │ │ │ └── User.kt
│ │ │ └── util
│ │ │ └── ViewModelFactory.kt
│ │ └── AndroidManifest.xml
├── proguard-rules.pro
└── build.gradle
├── settings.gradle
├── art
└── banner-mvi-arch-beginners.png
├── gradle
└── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── .gitignore
├── gradle.properties
├── gradlew.bat
├── README.md
└── gradlew
/app/.gitignore:
--------------------------------------------------------------------------------
1 | /build
2 |
--------------------------------------------------------------------------------
/settings.gradle:
--------------------------------------------------------------------------------
1 | rootProject.name='MVI-Architecture-Android-Beginners'
2 | include ':app'
3 |
--------------------------------------------------------------------------------
/art/banner-mvi-arch-beginners.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MindorksOpenSource/MVI-Architecture-Android-Beginners/HEAD/art/banner-mvi-arch-beginners.png
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MindorksOpenSource/MVI-Architecture-Android-Beginners/HEAD/gradle/wrapper/gradle-wrapper.jar
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-hdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MindorksOpenSource/MVI-Architecture-Android-Beginners/HEAD/app/src/main/res/mipmap-hdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-mdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MindorksOpenSource/MVI-Architecture-Android-Beginners/HEAD/app/src/main/res/mipmap-mdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MindorksOpenSource/MVI-Architecture-Android-Beginners/HEAD/app/src/main/res/mipmap-xhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MindorksOpenSource/MVI-Architecture-Android-Beginners/HEAD/app/src/main/res/mipmap-xxhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MindorksOpenSource/MVI-Architecture-Android-Beginners/HEAD/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-hdpi/ic_launcher_round.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MindorksOpenSource/MVI-Architecture-Android-Beginners/HEAD/app/src/main/res/mipmap-hdpi/ic_launcher_round.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-mdpi/ic_launcher_round.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MindorksOpenSource/MVI-Architecture-Android-Beginners/HEAD/app/src/main/res/mipmap-mdpi/ic_launcher_round.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xhdpi/ic_launcher_round.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MindorksOpenSource/MVI-Architecture-Android-Beginners/HEAD/app/src/main/res/mipmap-xhdpi/ic_launcher_round.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MindorksOpenSource/MVI-Architecture-Android-Beginners/HEAD/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MindorksOpenSource/MVI-Architecture-Android-Beginners/HEAD/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png
--------------------------------------------------------------------------------
/app/src/main/res/values/strings.xml:
--------------------------------------------------------------------------------
1 |
2 | MVI-Architecture-Android-Beginners
3 | Fetch User
4 |
5 |
--------------------------------------------------------------------------------
/app/src/main/java/com/mindorks/framework/mvi/ui/main/intent/MainIntent.kt:
--------------------------------------------------------------------------------
1 | package com.mindorks.framework.mvi.ui.main.intent
2 |
3 | sealed class MainIntent {
4 |
5 | object FetchUser : MainIntent()
6 |
7 | }
--------------------------------------------------------------------------------
/app/src/main/java/com/mindorks/framework/mvi/data/api/ApiHelper.kt:
--------------------------------------------------------------------------------
1 | package com.mindorks.framework.mvi.data.api
2 |
3 | import com.mindorks.framework.mvi.data.model.User
4 |
5 | interface ApiHelper {
6 |
7 | suspend fun getUsers(): List
8 |
9 | }
--------------------------------------------------------------------------------
/app/src/main/res/values/colors.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 | #6200EE
4 | #3700B3
5 | #03DAC5
6 |
7 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | *.iml
2 | .gradle
3 | /local.properties
4 | /.idea/caches
5 | /.idea/libraries
6 | /.idea/modules.xml
7 | /.idea/workspace.xml
8 | /.idea/navEditor.xml
9 | /.idea/assetWizardSettings.xml
10 | .DS_Store
11 | /build
12 | /captures
13 | .externalNativeBuild
14 | .cxx
15 | .idea
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.properties:
--------------------------------------------------------------------------------
1 | #Tue Jun 16 07:51:05 IST 2020
2 | distributionBase=GRADLE_USER_HOME
3 | distributionPath=wrapper/dists
4 | zipStoreBase=GRADLE_USER_HOME
5 | zipStorePath=wrapper/dists
6 | distributionUrl=https\://services.gradle.org/distributions/gradle-6.1.1-all.zip
7 |
--------------------------------------------------------------------------------
/app/src/main/java/com/mindorks/framework/mvi/data/api/ApiService.kt:
--------------------------------------------------------------------------------
1 | package com.mindorks.framework.mvi.data.api
2 |
3 | import com.mindorks.framework.mvi.data.model.User
4 | import retrofit2.http.GET
5 |
6 | interface ApiService {
7 |
8 | @GET("users")
9 | suspend fun getUsers(): List
10 | }
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
--------------------------------------------------------------------------------
/app/src/main/java/com/mindorks/framework/mvi/data/repository/MainRepository.kt:
--------------------------------------------------------------------------------
1 | package com.mindorks.framework.mvi.data.repository
2 |
3 | import com.mindorks.framework.mvi.data.api.ApiHelper
4 |
5 |
6 | class MainRepository(private val apiHelper: ApiHelper) {
7 |
8 | suspend fun getUsers() = apiHelper.getUsers()
9 |
10 | }
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
--------------------------------------------------------------------------------
/app/src/main/java/com/mindorks/framework/mvi/data/api/ApiHelperImpl.kt:
--------------------------------------------------------------------------------
1 | package com.mindorks.framework.mvi.data.api
2 |
3 | import com.mindorks.framework.mvi.data.model.User
4 |
5 | class ApiHelperImpl(private val apiService: ApiService) : ApiHelper {
6 |
7 | override suspend fun getUsers(): List {
8 | return apiService.getUsers()
9 | }
10 | }
--------------------------------------------------------------------------------
/app/src/main/java/com/mindorks/framework/mvi/data/model/User.kt:
--------------------------------------------------------------------------------
1 | package com.mindorks.framework.mvi.data.model
2 |
3 | import com.squareup.moshi.Json
4 |
5 | data class User(
6 | @Json(name = "id")
7 | val id: Int = 0,
8 | @Json(name = "name")
9 | val name: String = "",
10 | @Json(name = "email")
11 | val email: String = "",
12 | @Json(name = "avatar")
13 | val avatar: String = ""
14 | )
--------------------------------------------------------------------------------
/app/src/main/java/com/mindorks/framework/mvi/ui/main/viewstate/MainState.kt:
--------------------------------------------------------------------------------
1 | package com.mindorks.framework.mvi.ui.main.viewstate
2 |
3 | import com.mindorks.framework.mvi.data.model.User
4 |
5 | sealed class MainState {
6 |
7 | object Idle : MainState()
8 | object Loading : MainState()
9 | data class Users(val user: List) : MainState()
10 | data class Error(val error: String?) : MainState()
11 |
12 | }
--------------------------------------------------------------------------------
/app/src/main/res/values/styles.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
10 |
11 |
12 |
--------------------------------------------------------------------------------
/app/src/main/java/com/mindorks/framework/mvi/data/api/RetrofitBuilder.kt:
--------------------------------------------------------------------------------
1 | package com.mindorks.framework.mvi.data.api
2 |
3 | import retrofit2.Retrofit
4 | import retrofit2.converter.moshi.MoshiConverterFactory
5 |
6 | object RetrofitBuilder {
7 |
8 | private const val BASE_URL = "https://5e510330f2c0d300147c034c.mockapi.io/"
9 |
10 | private fun getRetrofit() = Retrofit.Builder()
11 | .baseUrl(BASE_URL)
12 | .addConverterFactory(MoshiConverterFactory.create())
13 | .build()
14 |
15 |
16 | val apiService: ApiService = getRetrofit().create(ApiService::class.java)
17 |
18 | }
--------------------------------------------------------------------------------
/app/src/main/java/com/mindorks/framework/mvi/util/ViewModelFactory.kt:
--------------------------------------------------------------------------------
1 | package com.mindorks.framework.mvi.util
2 |
3 | import androidx.lifecycle.ViewModel
4 | import androidx.lifecycle.ViewModelProvider
5 | import com.mindorks.framework.mvi.data.api.ApiHelper
6 | import com.mindorks.framework.mvi.data.repository.MainRepository
7 | import com.mindorks.framework.mvi.ui.main.viewmodel.MainViewModel
8 |
9 | class ViewModelFactory(private val apiHelper: ApiHelper) : ViewModelProvider.Factory {
10 |
11 | override fun create(modelClass: Class): T {
12 | if (modelClass.isAssignableFrom(MainViewModel::class.java)) {
13 | return MainViewModel(MainRepository(apiHelper)) as T
14 | }
15 | throw IllegalArgumentException("Unknown class name")
16 | }
17 |
18 | }
--------------------------------------------------------------------------------
/app/proguard-rules.pro:
--------------------------------------------------------------------------------
1 | # Add project specific ProGuard rules here.
2 | # You can control the set of applied configuration files using the
3 | # proguardFiles setting in build.gradle.
4 | #
5 | # For more details, see
6 | # http://developer.android.com/guide/developing/tools/proguard.html
7 |
8 | # If your project uses WebView with JS, uncomment the following
9 | # and specify the fully qualified class name to the JavaScript interface
10 | # class:
11 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
12 | # public *;
13 | #}
14 |
15 | # Uncomment this to preserve the line number information for
16 | # debugging stack traces.
17 | #-keepattributes SourceFile,LineNumberTable
18 |
19 | # If you keep the line number information, uncomment this to
20 | # hide the original source file name.
21 | #-renamesourcefileattribute SourceFile
22 |
--------------------------------------------------------------------------------
/app/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
2 |
4 |
5 |
6 |
7 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
--------------------------------------------------------------------------------
/gradle.properties:
--------------------------------------------------------------------------------
1 | # Project-wide Gradle settings.
2 | # IDE (e.g. Android Studio) users:
3 | # Gradle settings configured through the IDE *will override*
4 | # any settings specified in this file.
5 | # For more details on how to configure your build environment visit
6 | # http://www.gradle.org/docs/current/userguide/build_environment.html
7 | # Specifies the JVM arguments used for the daemon process.
8 | # The setting is particularly useful for tweaking memory settings.
9 | org.gradle.jvmargs=-Xmx1536m
10 | # When configured, Gradle will run in incubating parallel mode.
11 | # This option should only be used with decoupled projects. More details, visit
12 | # http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
13 | # org.gradle.parallel=true
14 | # AndroidX package structure to make it clearer which packages are bundled with the
15 | # Android operating system, and which are packaged with your app's APK
16 | # https://developer.android.com/topic/libraries/support-library/androidx-rn
17 | android.useAndroidX=true
18 | # Automatically convert third-party libraries to use AndroidX
19 | android.enableJetifier=true
20 | # Kotlin code style for this project: "official" or "obsolete":
21 | kotlin.code.style=official
22 |
--------------------------------------------------------------------------------
/app/src/main/java/com/mindorks/framework/mvi/ui/main/adapter/MainAdapter.kt:
--------------------------------------------------------------------------------
1 | package com.mindorks.framework.mvi.ui.main.adapter
2 |
3 | import android.view.LayoutInflater
4 | import android.view.View
5 | import android.view.ViewGroup
6 | import androidx.recyclerview.widget.RecyclerView
7 | import com.bumptech.glide.Glide
8 | import com.mindorks.framework.mvi.R
9 | import com.mindorks.framework.mvi.data.model.User
10 | import kotlinx.android.synthetic.main.item_layout.view.*
11 |
12 | class MainAdapter(
13 | private val users: ArrayList
14 | ) : RecyclerView.Adapter() {
15 |
16 | class DataViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
17 | fun bind(user: User) {
18 | itemView.textViewUserName.text = user.name
19 | itemView.textViewUserEmail.text = user.email
20 | Glide.with(itemView.imageViewAvatar.context)
21 | .load(user.avatar)
22 | .into(itemView.imageViewAvatar)
23 | }
24 | }
25 |
26 | override fun onCreateViewHolder(parent: ViewGroup, viewType: Int) =
27 | DataViewHolder(
28 | LayoutInflater.from(parent.context).inflate(
29 | R.layout.item_layout, parent,
30 | false
31 | )
32 | )
33 |
34 | override fun getItemCount(): Int = users.size
35 |
36 | override fun onBindViewHolder(holder: DataViewHolder, position: Int) =
37 | holder.bind(users[position])
38 |
39 | fun addData(list: List) {
40 | users.addAll(list)
41 | }
42 |
43 | }
--------------------------------------------------------------------------------
/app/src/main/res/layout/activity_main.xml:
--------------------------------------------------------------------------------
1 |
2 |
8 |
9 |
14 |
15 |
24 |
25 |
34 |
35 |
--------------------------------------------------------------------------------
/app/src/main/java/com/mindorks/framework/mvi/ui/main/viewmodel/MainViewModel.kt:
--------------------------------------------------------------------------------
1 | package com.mindorks.framework.mvi.ui.main.viewmodel
2 |
3 | import androidx.lifecycle.ViewModel
4 | import androidx.lifecycle.viewModelScope
5 | import com.mindorks.framework.mvi.data.repository.MainRepository
6 | import com.mindorks.framework.mvi.ui.main.intent.MainIntent
7 | import com.mindorks.framework.mvi.ui.main.viewstate.MainState
8 | import kotlinx.coroutines.ExperimentalCoroutinesApi
9 | import kotlinx.coroutines.channels.Channel
10 | import kotlinx.coroutines.flow.MutableStateFlow
11 | import kotlinx.coroutines.flow.StateFlow
12 | import kotlinx.coroutines.flow.collect
13 | import kotlinx.coroutines.flow.consumeAsFlow
14 | import kotlinx.coroutines.launch
15 |
16 | @ExperimentalCoroutinesApi
17 | class MainViewModel(
18 | private val repository: MainRepository
19 | ) : ViewModel() {
20 |
21 | val userIntent = Channel(Channel.UNLIMITED)
22 | private val _state = MutableStateFlow(MainState.Idle)
23 | val state: StateFlow
24 | get() = _state
25 |
26 | init {
27 | handleIntent()
28 | }
29 |
30 | private fun handleIntent() {
31 | viewModelScope.launch {
32 | userIntent.consumeAsFlow().collect {
33 | when (it) {
34 | is MainIntent.FetchUser -> fetchUser()
35 | }
36 | }
37 | }
38 | }
39 |
40 | private fun fetchUser() {
41 | viewModelScope.launch {
42 | _state.value = MainState.Loading
43 | _state.value = try {
44 | MainState.Users(repository.getUsers())
45 | } catch (e: Exception) {
46 | MainState.Error(e.localizedMessage)
47 | }
48 | }
49 | }
50 | }
--------------------------------------------------------------------------------
/app/src/main/res/layout/item_layout.xml:
--------------------------------------------------------------------------------
1 |
2 |
8 |
9 |
17 |
18 |
29 |
30 |
38 |
39 |
--------------------------------------------------------------------------------
/app/src/main/res/drawable-v24/ic_launcher_foreground.xml:
--------------------------------------------------------------------------------
1 |
7 |
8 |
9 |
15 |
18 |
21 |
22 |
23 |
24 |
30 |
--------------------------------------------------------------------------------
/app/build.gradle:
--------------------------------------------------------------------------------
1 | apply plugin: 'com.android.application'
2 | apply plugin: 'kotlin-android'
3 | apply plugin: 'kotlin-android-extensions'
4 |
5 | android {
6 | compileSdkVersion 29
7 | buildToolsVersion "29.0.3"
8 | compileOptions {
9 | targetCompatibility = "8"
10 | sourceCompatibility = "8"
11 | }
12 | defaultConfig {
13 | applicationId "com.mindorks.framework.mvi"
14 | minSdkVersion 21
15 | targetSdkVersion 29
16 | versionCode 1
17 | versionName "1.0"
18 |
19 | testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
20 | }
21 |
22 | buildTypes {
23 | release {
24 | minifyEnabled false
25 | proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
26 | }
27 | }
28 | compileOptions {
29 | sourceCompatibility JavaVersion.VERSION_1_8
30 | targetCompatibility JavaVersion.VERSION_1_8
31 | }
32 |
33 | }
34 |
35 | dependencies {
36 | implementation fileTree(dir: 'libs', include: ['*.jar'])
37 | implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
38 | implementation 'androidx.appcompat:appcompat:1.1.0'
39 | implementation 'androidx.core:core-ktx:1.2.0'
40 | implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
41 | testImplementation 'junit:junit:4.12'
42 | androidTestImplementation 'androidx.test.ext:junit:1.1.1'
43 | androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
44 |
45 | // Added Dependencies
46 | implementation "androidx.recyclerview:recyclerview:1.1.0"
47 | implementation 'android.arch.lifecycle:extensions:1.1.1'
48 | implementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.2.0'
49 | implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.2.0'
50 | implementation 'com.github.bumptech.glide:glide:4.11.0'
51 |
52 | //retrofit
53 | implementation 'com.squareup.retrofit2:retrofit:2.8.1'
54 | implementation "com.squareup.retrofit2:converter-moshi:2.6.2"
55 |
56 | //Coroutine
57 | implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.3.6"
58 | implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.3.6"
59 | }
60 |
--------------------------------------------------------------------------------
/gradlew.bat:
--------------------------------------------------------------------------------
1 | @if "%DEBUG%" == "" @echo off
2 | @rem ##########################################################################
3 | @rem
4 | @rem Gradle startup script for Windows
5 | @rem
6 | @rem ##########################################################################
7 |
8 | @rem Set local scope for the variables with windows NT shell
9 | if "%OS%"=="Windows_NT" setlocal
10 |
11 | set DIRNAME=%~dp0
12 | if "%DIRNAME%" == "" set DIRNAME=.
13 | set APP_BASE_NAME=%~n0
14 | set APP_HOME=%DIRNAME%
15 |
16 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
17 | set DEFAULT_JVM_OPTS=
18 |
19 | @rem Find java.exe
20 | if defined JAVA_HOME goto findJavaFromJavaHome
21 |
22 | set JAVA_EXE=java.exe
23 | %JAVA_EXE% -version >NUL 2>&1
24 | if "%ERRORLEVEL%" == "0" goto init
25 |
26 | echo.
27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
28 | echo.
29 | echo Please set the JAVA_HOME variable in your environment to match the
30 | echo location of your Java installation.
31 |
32 | goto fail
33 |
34 | :findJavaFromJavaHome
35 | set JAVA_HOME=%JAVA_HOME:"=%
36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe
37 |
38 | if exist "%JAVA_EXE%" goto init
39 |
40 | echo.
41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
42 | echo.
43 | echo Please set the JAVA_HOME variable in your environment to match the
44 | echo location of your Java installation.
45 |
46 | goto fail
47 |
48 | :init
49 | @rem Get command-line arguments, handling Windows variants
50 |
51 | if not "%OS%" == "Windows_NT" goto win9xME_args
52 |
53 | :win9xME_args
54 | @rem Slurp the command line arguments.
55 | set CMD_LINE_ARGS=
56 | set _SKIP=2
57 |
58 | :win9xME_args_slurp
59 | if "x%~1" == "x" goto execute
60 |
61 | set CMD_LINE_ARGS=%*
62 |
63 | :execute
64 | @rem Setup the command line
65 |
66 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
67 |
68 | @rem Execute Gradle
69 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
70 |
71 | :end
72 | @rem End local scope for the variables with windows NT shell
73 | if "%ERRORLEVEL%"=="0" goto mainEnd
74 |
75 | :fail
76 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
77 | rem the _cmd.exe /c_ return code!
78 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
79 | exit /b 1
80 |
81 | :mainEnd
82 | if "%OS%"=="Windows_NT" endlocal
83 |
84 | :omega
85 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # MVI Architecture Android Beginners: Sample App
2 | [](https://mindorks.com/open-source-projects)
3 | [](https://mindorks.com/join-community)
4 |
5 | This repository contains a sample app that implements MVI architecture using Kotlin, ViewModel, LiveData, and etc.
6 |
7 |
8 |
9 |
10 |
11 | ### Concept reference resources - [MVI Architecture - Android Tutorial for Beginners - Step by Step Guide](https://blog.mindorks.com/mvi-architecture-android-tutorial-for-beginners-step-by-step-guide)
12 |
13 | #### The app has following packages:
14 | 1. **data**: It contains all the data accessing and manipulating components.
15 | 3. **ui**: View classes along with their corresponding ViewModel.
16 | 4. **utils**: Utility classes.
17 |
18 |
19 | ### Library reference resources:
20 | 1. Kotlin-Coroutines: https://github.com/MindorksOpenSource/Kotlin-Coroutines-Android-Examples
21 |
22 | ## If this project helps you in anyway, show your love :heart: by putting a :star: on this project :v:
23 |
24 | ## Explore Android Online Tutorials and Courses To Learn More by MindOrks
25 | * [Ride-Sharing Uber Lyft Android App](https://github.com/MindorksOpenSource/ridesharing-uber-lyft-app) - Learn to build a ride-sharing Android Taxi Clone App like Uber, Lyft - Open-Source Project By MindOrks
26 | * [Android Tutorial](https://mindorks.com/android-tutorial) - All Free Android Tutorials by MindOrks
27 | * [Android Online Course for Professionals](https://mindorks.com/android-app-development-online-course-for-professionals) - In this online course, you’ll learn the Dagger, Kotlin, RxJava, MVVM Architecture, Architecture Components, Jetpack, LiveData, ViewModel, Room Database, Database Design, Multithreading, Memory Management, Networking, Caching, How Glide works, Unit Testing, and the best practices for Android Development. By the end of this online course, you will have all the skills you need to become a professional Android Developer.
28 | * [Android Online Course for Beginners](https://mindorks.com/android-app-development-online-course-for-beginners) - This course is for beginners for those who want to get started with Android Development. In this course, you will build two apps: TodoNotes and Ride-Sharing Uber Android App.
29 |
30 | [Check out MindOrks awesome open source projects here](https://mindorks.com/open-source-projects)
31 |
32 | ### License
33 | ```
34 | Copyright (C) 2020 MINDORKS NEXTGEN PRIVATE LIMITED
35 |
36 | Licensed under the Apache License, Version 2.0 (the "License");
37 | you may not use this file except in compliance with the License.
38 | You may obtain a copy of the License at
39 |
40 | http://www.apache.org/licenses/LICENSE-2.0
41 |
42 | Unless required by applicable law or agreed to in writing, software
43 | distributed under the License is distributed on an "AS IS" BASIS,
44 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
45 | See the License for the specific language governing permissions and
46 | limitations under the License.
47 | ```
48 |
49 | ### Contributing to Android MVI Architecture
50 | Just make pull request. You are in!
51 |
--------------------------------------------------------------------------------
/app/src/main/java/com/mindorks/framework/mvi/ui/main/view/MainActivity.kt:
--------------------------------------------------------------------------------
1 | package com.mindorks.framework.mvi.ui.main.view
2 |
3 | import android.os.Bundle
4 | import android.view.View
5 | import android.widget.Toast
6 | import androidx.appcompat.app.AppCompatActivity
7 | import androidx.lifecycle.ViewModelProviders
8 | import androidx.lifecycle.lifecycleScope
9 | import androidx.recyclerview.widget.DividerItemDecoration
10 | import androidx.recyclerview.widget.LinearLayoutManager
11 | import com.mindorks.framework.mvi.R
12 | import com.mindorks.framework.mvi.data.api.ApiHelperImpl
13 | import com.mindorks.framework.mvi.data.api.RetrofitBuilder
14 | import com.mindorks.framework.mvi.data.model.User
15 | import com.mindorks.framework.mvi.util.ViewModelFactory
16 | import com.mindorks.framework.mvi.ui.main.adapter.MainAdapter
17 | import com.mindorks.framework.mvi.ui.main.intent.MainIntent
18 | import com.mindorks.framework.mvi.ui.main.viewmodel.MainViewModel
19 | import com.mindorks.framework.mvi.ui.main.viewstate.MainState
20 | import kotlinx.android.synthetic.main.activity_main.*
21 | import kotlinx.coroutines.ExperimentalCoroutinesApi
22 | import kotlinx.coroutines.flow.collect
23 | import kotlinx.coroutines.launch
24 |
25 | @ExperimentalCoroutinesApi
26 | class MainActivity : AppCompatActivity() {
27 |
28 | private lateinit var mainViewModel: MainViewModel
29 | private var adapter = MainAdapter(arrayListOf())
30 |
31 | override fun onCreate(savedInstanceState: Bundle?) {
32 | super.onCreate(savedInstanceState)
33 | setContentView(R.layout.activity_main)
34 | setupUI()
35 | setupViewModel()
36 | observeViewModel()
37 | setupClicks()
38 | }
39 |
40 | private fun setupClicks() {
41 | buttonFetchUser.setOnClickListener {
42 | lifecycleScope.launch {
43 | mainViewModel.userIntent.send(MainIntent.FetchUser)
44 | }
45 | }
46 | }
47 |
48 |
49 | private fun setupUI() {
50 | recyclerView.layoutManager = LinearLayoutManager(this)
51 | recyclerView.run {
52 | addItemDecoration(
53 | DividerItemDecoration(
54 | recyclerView.context,
55 | (recyclerView.layoutManager as LinearLayoutManager).orientation
56 | )
57 | )
58 | }
59 | recyclerView.adapter = adapter
60 | }
61 |
62 |
63 | private fun setupViewModel() {
64 | mainViewModel = ViewModelProviders.of(
65 | this,
66 | ViewModelFactory(
67 | ApiHelperImpl(
68 | RetrofitBuilder.apiService
69 | )
70 | )
71 | ).get(MainViewModel::class.java)
72 | }
73 |
74 | private fun observeViewModel() {
75 | lifecycleScope.launch {
76 | mainViewModel.state.collect {
77 | when (it) {
78 | is MainState.Idle -> {
79 |
80 | }
81 | is MainState.Loading -> {
82 | buttonFetchUser.visibility = View.GONE
83 | progressBar.visibility = View.VISIBLE
84 | }
85 |
86 | is MainState.Users -> {
87 | progressBar.visibility = View.GONE
88 | buttonFetchUser.visibility = View.GONE
89 | renderList(it.user)
90 | }
91 | is MainState.Error -> {
92 | progressBar.visibility = View.GONE
93 | buttonFetchUser.visibility = View.VISIBLE
94 | Toast.makeText(this@MainActivity, it.error, Toast.LENGTH_LONG).show()
95 | }
96 | }
97 | }
98 | }
99 | }
100 |
101 | private fun renderList(users: List) {
102 | recyclerView.visibility = View.VISIBLE
103 | users.let { listOfUsers -> listOfUsers.let { adapter.addData(it) } }
104 | adapter.notifyDataSetChanged()
105 | }
106 | }
107 |
--------------------------------------------------------------------------------
/gradlew:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env sh
2 |
3 | ##############################################################################
4 | ##
5 | ## Gradle start up script for UN*X
6 | ##
7 | ##############################################################################
8 |
9 | # Attempt to set APP_HOME
10 | # Resolve links: $0 may be a link
11 | PRG="$0"
12 | # Need this for relative symlinks.
13 | while [ -h "$PRG" ] ; do
14 | ls=`ls -ld "$PRG"`
15 | link=`expr "$ls" : '.*-> \(.*\)$'`
16 | if expr "$link" : '/.*' > /dev/null; then
17 | PRG="$link"
18 | else
19 | PRG=`dirname "$PRG"`"/$link"
20 | fi
21 | done
22 | SAVED="`pwd`"
23 | cd "`dirname \"$PRG\"`/" >/dev/null
24 | APP_HOME="`pwd -P`"
25 | cd "$SAVED" >/dev/null
26 |
27 | APP_NAME="Gradle"
28 | APP_BASE_NAME=`basename "$0"`
29 |
30 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
31 | DEFAULT_JVM_OPTS=""
32 |
33 | # Use the maximum available, or set MAX_FD != -1 to use that value.
34 | MAX_FD="maximum"
35 |
36 | warn () {
37 | echo "$*"
38 | }
39 |
40 | die () {
41 | echo
42 | echo "$*"
43 | echo
44 | exit 1
45 | }
46 |
47 | # OS specific support (must be 'true' or 'false').
48 | cygwin=false
49 | msys=false
50 | darwin=false
51 | nonstop=false
52 | case "`uname`" in
53 | CYGWIN* )
54 | cygwin=true
55 | ;;
56 | Darwin* )
57 | darwin=true
58 | ;;
59 | MINGW* )
60 | msys=true
61 | ;;
62 | NONSTOP* )
63 | nonstop=true
64 | ;;
65 | esac
66 |
67 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
68 |
69 | # Determine the Java command to use to start the JVM.
70 | if [ -n "$JAVA_HOME" ] ; then
71 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
72 | # IBM's JDK on AIX uses strange locations for the executables
73 | JAVACMD="$JAVA_HOME/jre/sh/java"
74 | else
75 | JAVACMD="$JAVA_HOME/bin/java"
76 | fi
77 | if [ ! -x "$JAVACMD" ] ; then
78 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
79 |
80 | Please set the JAVA_HOME variable in your environment to match the
81 | location of your Java installation."
82 | fi
83 | else
84 | JAVACMD="java"
85 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
86 |
87 | Please set the JAVA_HOME variable in your environment to match the
88 | location of your Java installation."
89 | fi
90 |
91 | # Increase the maximum file descriptors if we can.
92 | if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
93 | MAX_FD_LIMIT=`ulimit -H -n`
94 | if [ $? -eq 0 ] ; then
95 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
96 | MAX_FD="$MAX_FD_LIMIT"
97 | fi
98 | ulimit -n $MAX_FD
99 | if [ $? -ne 0 ] ; then
100 | warn "Could not set maximum file descriptor limit: $MAX_FD"
101 | fi
102 | else
103 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
104 | fi
105 | fi
106 |
107 | # For Darwin, add options to specify how the application appears in the dock
108 | if $darwin; then
109 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
110 | fi
111 |
112 | # For Cygwin, switch paths to Windows format before running java
113 | if $cygwin ; then
114 | APP_HOME=`cygpath --path --mixed "$APP_HOME"`
115 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
116 | JAVACMD=`cygpath --unix "$JAVACMD"`
117 |
118 | # We build the pattern for arguments to be converted via cygpath
119 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
120 | SEP=""
121 | for dir in $ROOTDIRSRAW ; do
122 | ROOTDIRS="$ROOTDIRS$SEP$dir"
123 | SEP="|"
124 | done
125 | OURCYGPATTERN="(^($ROOTDIRS))"
126 | # Add a user-defined pattern to the cygpath arguments
127 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then
128 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
129 | fi
130 | # Now convert the arguments - kludge to limit ourselves to /bin/sh
131 | i=0
132 | for arg in "$@" ; do
133 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
134 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
135 |
136 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
137 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
138 | else
139 | eval `echo args$i`="\"$arg\""
140 | fi
141 | i=$((i+1))
142 | done
143 | case $i in
144 | (0) set -- ;;
145 | (1) set -- "$args0" ;;
146 | (2) set -- "$args0" "$args1" ;;
147 | (3) set -- "$args0" "$args1" "$args2" ;;
148 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
149 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
150 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
151 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
152 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
153 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
154 | esac
155 | fi
156 |
157 | # Escape application args
158 | save () {
159 | for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
160 | echo " "
161 | }
162 | APP_ARGS=$(save "$@")
163 |
164 | # Collect all arguments for the java command, following the shell quoting and substitution rules
165 | eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
166 |
167 | # by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong
168 | if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then
169 | cd "$(dirname "$0")"
170 | fi
171 |
172 | exec "$JAVACMD" "$@"
173 |
--------------------------------------------------------------------------------
/app/src/main/res/drawable/ic_launcher_background.xml:
--------------------------------------------------------------------------------
1 |
2 |
7 |
10 |
15 |
20 |
25 |
30 |
35 |
40 |
45 |
50 |
55 |
60 |
65 |
70 |
75 |
80 |
85 |
90 |
95 |
100 |
105 |
110 |
115 |
120 |
125 |
130 |
135 |
140 |
145 |
150 |
155 |
160 |
165 |
170 |
171 |
--------------------------------------------------------------------------------