Slide 1

Slide 1 text

Modularizing Android Applications Marvin Ramin @Mauin

Slide 2

Slide 2 text

Modularizing Android Applications Marvin Ramin @Mauin

Slide 3

Slide 3 text

Motivations to modularize an application

Slide 4

Slide 4 text

Disclaimer

Slide 5

Slide 5 text

. !"" app # !"" build.gradle # $"" src # $"" main # !"" AndroidManifest.xml # !"" kotlin # # $"" com.some.app # # !"" Application.kt # # !"" login # # # !"" LoginActivity.kt # # # !"" LoginPresenter.kt # # # !"" LoginRepository.kt # # !"" content # # # !"" ContentActivity.kt # # # !"" ContentFragment.kt # # # !"" ContentDatabase.kt # # # !"" ApiClient.kt # # !"" feature3 # # !"" feature4 # # !"" apiclient # # !"" ... # # !"" ... # $"" res # !"" drawable # $"" ... # !"" build.gradle !"" gradle $"" settings.gradle

Slide 6

Slide 6 text

. !"" app # !"" build.gradle # $"" src # $"" main # !"" AndroidManifest.xml # !"" kotlin # # $"" com.some.app # # !"" Application.kt # # !"" login # # # !"" LoginActivity.kt # # # !"" LoginPresenter.kt # # # !"" LoginRepository.kt # # !"" content # # # !"" ContentActivity.kt # # # !"" ContentFragment.kt # # # !"" ContentDatabase.kt # # # !"" ApiClient.kt # # !"" feature3 # # !"" feature4 # # !"" apiclient # # !"" ... # # !"" ... # $"" res # !"" drawable # $"" ... # !"" build.gradle !"" gradle $"" settings.gradle

Slide 7

Slide 7 text

. !"" app # !"" build.gradle # $"" src # $"" main # !"" AndroidManifest.xml # !"" kotlin # # $"" com.some.app # # !"" Application.kt # # !"" login # # # !"" LoginActivity.kt # # # !"" LoginPresenter.kt # # # !"" LoginRepository.kt # # !"" content # # # !"" ContentActivity.kt # # # !"" ContentFragment.kt # # # !"" ContentDatabase.kt # # # !"" ApiClient.kt # # !"" feature3 # # !"" feature4 # # !"" apiclient # # !"" ... # # !"" ... # $"" res # !"" drawable # $"" ... # !"" build.gradle !"" gradle $"" settings.gradle

Slide 8

Slide 8 text

. !"" app # !"" build.gradle # $"" src # $"" main # !"" AndroidManifest.xml # !"" kotlin # # $"" com.some.app # # !"" Application.kt # # !"" login # # # !"" LoginActivity.kt # # # !"" LoginPresenter.kt # # # !"" LoginRepository.kt # # !"" content # # # !"" ContentActivity.kt # # # !"" ContentFragment.kt # # # !"" ContentDatabase.kt # # # !"" ApiClient.kt # # !"" feature3 # # !"" feature4 # # !"" apiclient # # !"" ... # # !"" ... # $"" res # !"" drawable # $"" ... # !"" build.gradle !"" gradle $"" settings.gradle

Slide 9

Slide 9 text

:app

Slide 10

Slide 10 text

:app login content apiclient

Slide 11

Slide 11 text

:app login content apiclient apply plugin: ‘com.android.application’

Slide 12

Slide 12 text

Single Module Application

Slide 13

Slide 13 text

Single Project Build

Slide 14

Slide 14 text

Monolith

Slide 15

Slide 15 text

TODO: Add image of interconnected codebase

Slide 16

Slide 16 text

Microservices in an Android App

Slide 17

Slide 17 text

Everything is visible No separation of concerns No clear APIs/responsibilities

Slide 18

Slide 18 text

Moving towards a modularized codebase

Slide 19

Slide 19 text

Look at your app

Slide 20

Slide 20 text

No content

Slide 21

Slide 21 text

No content

Slide 22

Slide 22 text

Look at your codebase

Slide 23

Slide 23 text

“Libraries” don’t have to be external

Slide 24

Slide 24 text

Multi-Project Build

Slide 25

Slide 25 text

:app login content apiclient apply plugin: ‘com.android.application’

Slide 26

Slide 26 text

:app login content apiclient apply plugin: ‘com.android.application’ settings.gradle include ':app'

Slide 27

Slide 27 text

:app login content :apiclient apply plugin: ‘com.android.application’

Slide 28

Slide 28 text

:app login content :apiclient apply plugin: ‘com.android.library’ apply plugin: ‘com.android.application’

Slide 29

Slide 29 text

:app login content :apiclient apply plugin: ‘com.android.library’ apply plugin: ‘com.android.application’ implementation project(':apiclient')

Slide 30

Slide 30 text

. !"" app # !"" build.gradle # $"" src # $"" main # !"" AndroidManifest.xml # !"" kotlin # # $"" com.some.app # # !"" Application.kt # # !"" login # # # !"" LoginActivity.kt # # # !"" LoginPresenter.kt # # # !"" AccountRepository.kt # # !"" content # # !"" apiclient # $"" res # !"" drawable # $"" … !"" build.gradle !"" gradle $"" settings.gradle

Slide 31

Slide 31 text

. !"" app # !"" build.gradle # $"" src # $"" main # !"" AndroidManifest.xml # !"" kotlin # # $"" com.some.app # # !"" Application.kt # # !"" login # # # !"" LoginActivity.kt # # # !"" LoginPresenter.kt # # # !"" AccountRepository.kt # # !"" content # # !"" apiclient # $"" res # !"" drawable # $"" … !"" build.gradle !"" gradle $"" settings.gradle

Slide 32

Slide 32 text

. !"" app # !"" build.gradle # $"" src # $"" main # !"" AndroidManifest.xml # !"" kotlin # # $"" com.some.app # # !"" Application.kt # # !"" login # # # !"" LoginActivity.kt # # # !"" LoginPresenter.kt # # # !"" AccountRepository.kt # # !"" content # $"" res # !"" drawable # $"" … !"" apiclient # !"" build.gradle # $"" src !"" build.gradle !"" gradle $"" settings.gradle

Slide 33

Slide 33 text

. !"" app # !"" build.gradle # $"" src # $"" main # !"" AndroidManifest.xml # !"" kotlin # # $"" com.some.app # # !"" Application.kt # # !"" login # # # !"" LoginActivity.kt # # # !"" LoginPresenter.kt # # # !"" AccountRepository.kt # # !"" content # $"" res # !"" drawable # $"" … !"" apiclient # !"" build.gradle # $"" src !"" build.gradle !"" gradle $"" settings.gradle settings.gradle

Slide 34

Slide 34 text

. !"" app # !"" build.gradle # $"" src # $"" main # !"" AndroidManifest.xml # !"" kotlin # # $"" com.some.app # # !"" Application.kt # # !"" login # # # !"" LoginActivity.kt # # # !"" LoginPresenter.kt # # # !"" AccountRepository.kt # # !"" content # $"" res # !"" drawable # $"" … !"" apiclient # !"" build.gradle # $"" src !"" build.gradle !"" gradle $"" settings.gradle settings.gradle include ‘:app’, ‘:apiclient’

Slide 35

Slide 35 text

. !"" app # !"" build.gradle # $"" src # $"" main # !"" AndroidManifest.xml # !"" kotlin # # $"" com.some.app # # !"" Application.kt # # !"" login # # # !"" LoginActivity.kt # # # !"" LoginPresenter.kt # # # !"" AccountRepository.kt # # !"" content # $"" res # !"" drawable # $"" … !"" modules # $"" apiclient # !"" build.gradle # $"" src !"" build.gradle !"" gradle $"" settings.gradle settings.gradle include ‘:app’, ‘:modules:apiclient’

Slide 36

Slide 36 text

:app login content :apiclient apply plugin: ‘com.android.library’ apply plugin: ‘com.android.application’ implementation project(':apiclient')

Slide 37

Slide 37 text

:app login content :apiclient apply plugin: ‘java-library’ apply plugin: ‘com.android.application’ implementation project(':apiclient')

Slide 38

Slide 38 text

:app login content :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient')

Slide 39

Slide 39 text

Refactor —> Modularize

Slide 40

Slide 40 text

Refactor —> Modularize

Slide 41

Slide 41 text

:app login content :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient')

Slide 42

Slide 42 text

:app :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient') content login

Slide 43

Slide 43 text

:app :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient') :login apply plugin: ‘com.android.library’ content

Slide 44

Slide 44 text

:app :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient') :login apply plugin: ‘com.android.library’ implementation project(‘:login') content

Slide 45

Slide 45 text

:app :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient') :login apply plugin: ‘com.android.library’ implementation project(‘:login') implementation project(‘:apiclient’) content

Slide 46

Slide 46 text

:app :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient') :login apply plugin: ‘com.android.library’ implementation project(‘:login') implementation project(‘:apiclient’) content

Slide 47

Slide 47 text

:app :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient') :login apply plugin: ‘com.android.library’ implementation project(‘:login') implementation project(‘:apiclient’) content :user

Slide 48

Slide 48 text

:app :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient') :login apply plugin: ‘com.android.library’ implementation project(‘:login') implementation project(‘:apiclient’) content :user

Slide 49

Slide 49 text

:app :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient') :login apply plugin: ‘com.android.library’ implementation project(‘:login') implementation project(‘:apiclient’) content :user :utils

Slide 50

Slide 50 text

:app :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient') :login apply plugin: ‘com.android.library’ implementation project(‘:login') implementation project(‘:apiclient’) content :user :utils

Slide 51

Slide 51 text

:app :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient') :login apply plugin: ‘com.android.library’ implementation project(‘:login') implementation project(‘:apiclient’) content :user :utils :rabbithole

Slide 52

Slide 52 text

:app :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient') :login apply plugin: ‘com.android.library’ implementation project(‘:login') implementation project(‘:apiclient’) content :user :utils :rabbithole

Slide 53

Slide 53 text

:app :apiclient apply plugin: ‘kotlin’ apply plugin: ‘com.android.application’ implementation project(':apiclient') :login apply plugin: ‘com.android.library’ implementation project(‘:login') implementation project(‘:apiclient’) content :user :utils :rabbithole

Slide 54

Slide 54 text

:app login content apiclient apply plugin: ‘com.android.application’

Slide 55

Slide 55 text

:base content apiclient apply plugin: ‘com.android.library’ :app apply plugin: ‘com.android.application’ implementation project(‘:base') login

Slide 56

Slide 56 text

:base content apiclient apply plugin: ‘com.android.library’ :app apply plugin: ‘com.android.application’ :login implementation project(‘:base') apply plugin: ‘com.android.library’ implementation project(‘:base') implementation project(‘:login’)

Slide 57

Slide 57 text

:base content apply plugin: ‘com.android.library’ :app apply plugin: ‘com.android.application’ :login implementation project(‘:base') :apiclient apply plugin: ‘com.android.library’ apply plugin: ‘kotlin’ implementation project(‘:base') implementation project(‘:login’)

Slide 58

Slide 58 text

Different (sample) apps

Slide 59

Slide 59 text

:base apply plugin: ‘com.android.library’ :app :login apply plugin: ‘com.android.library’ :content apply plugin: ‘com.android.library’ apply plugin: ‘com.android.application’

Slide 60

Slide 60 text

:base apply plugin: ‘com.android.library’ :app :login apply plugin: ‘com.android.library’ :content apply plugin: ‘com.android.library’

Slide 61

Slide 61 text

:base apply plugin: ‘com.android.library’ :app :login apply plugin: ‘com.android.library’ :content apply plugin: ‘com.android.library’

Slide 62

Slide 62 text

:base apply plugin: ‘com.android.library’ :app :login apply plugin: ‘com.android.library’ :content apply plugin: ‘com.android.library’ :androidwear :instantapp :sample

Slide 63

Slide 63 text

Each module has a clear API

Slide 64

Slide 64 text

Each module has a clear API Clear responsibilities between teams

Slide 65

Slide 65 text

Each module has a clear API Clear responsibilities between teams Module maintenance goes up

Slide 66

Slide 66 text

Each module has a clear API Clear responsibilities between teams Module maintenance goes up Compile times go down

Slide 67

Slide 67 text

Why does it compile faster?

Slide 68

Slide 68 text

:app

Slide 69

Slide 69 text

:app Change

Slide 70

Slide 70 text

:app Change

Slide 71

Slide 71 text

:app :app Change

Slide 72

Slide 72 text

:app :app Change Change

Slide 73

Slide 73 text

:app :app Change Change

Slide 74

Slide 74 text

Declaring dependencies

Slide 75

Slide 75 text

compile someDependency

Slide 76

Slide 76 text

compile someDependency compile someDependency

Slide 77

Slide 77 text

compile someDependency api someDependency implementation someDependency compile someDependency

Slide 78

Slide 78 text

api implementation

Slide 79

Slide 79 text

api implementation :apiclient api ‘com.squareup:okhttp:3.9.0’ :apiclient implementation ‘com.squareup:okhttp:3.9.0’

Slide 80

Slide 80 text

api implementation :apiclient api ‘com.squareup:okhttp:3.9.0’ :apiclient implementation ‘com.squareup:okhttp:3.9.0’ :app :app

Slide 81

Slide 81 text

api implementation :apiclient api ‘com.squareup:okhttp:3.9.0’ :apiclient implementation ‘com.squareup:okhttp:3.9.0’ :app :app import com.squareup.OkHttpClient import com.squareup.OkHttpClient

Slide 82

Slide 82 text

api implementation :apiclient api ‘com.squareup:okhttp:3.9.0’ :apiclient implementation ‘com.squareup:okhttp:3.9.0’ :app :app import com.squareup.OkHttpClient import com.squareup.OkHttpClient

Slide 83

Slide 83 text

api implementation :apiclient api ‘com.squareup:okhttp:3.9.0’ :apiclient implementation ‘com.squareup:okhttp:3.9.0’ :app :app import com.squareup.OkHttpClient import com.squareup.OkHttpClient

Slide 84

Slide 84 text

Define your dependencies in one place

Slide 85

Slide 85 text

Define your dependencies in one place dependencies.gradle file

Slide 86

Slide 86 text

Define your dependencies in one place dependencies.gradle file Assure dependency versions are the same across all modules

Slide 87

Slide 87 text

Define your dependencies in one place dependencies.gradle file Assure dependency versions are the same across all modules Define core dependencies in a base module

Slide 88

Slide 88 text

// dependencies.gradle ext { androidBuildToolsVersion = '26.0.1' androidCompileSdkVersion = 26 androidMinSdkVersion = 23 androidTargetSdkVersion = 26 libraries = [ rxJava2 : "io.reactivex.rxjava2:rxjava:2.1.5", ... ] }

Slide 89

Slide 89 text

// dependencies.gradle ext { androidBuildToolsVersion = '26.0.1' androidCompileSdkVersion = 26 androidMinSdkVersion = 23 androidTargetSdkVersion = 26 libraries = [ rxJava2 : "io.reactivex.rxjava2:rxjava:2.1.5", ... ] } // build.gradle android { compileSdkVersion androidCompileSdkVersion buildToolsVersion androidBuildToolsVersion ... } dependencies { implementation libraries.rxJava2 }

Slide 90

Slide 90 text

apply plugin: “com.android.library” android { compileSdkVersion versions.compileSdk defaultConfig { minSdkVersion versions.minSdk targetSdkVersion versions.targetSdk versionCode 1 versionName "1.0" testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } }

Slide 91

Slide 91 text

apply plugin: “com.android.library” android { compileSdkVersion versions.compileSdk defaultConfig { minSdkVersion versions.minSdk targetSdkVersion versions.targetSdk versionCode 1 versionName "1.0" testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } } my-base-library.gradle:

Slide 92

Slide 92 text

// ./module/build.gradle apply from: “my-base-library.gradle” dependencies { … }

Slide 93

Slide 93 text

Centralize (some) resources

Slide 94

Slide 94 text

Centralize (some) resources colors, dimens, strings, …

Slide 95

Slide 95 text

Testing

Slide 96

Slide 96 text

Dependency Injection

Slide 97

Slide 97 text

@Component(modules = { ApplicationModule.class, ApiClientModule.class // <- comes from the :apiclient module }) public interface ApplicationComponent { }

Slide 98

Slide 98 text

Navigation

Slide 99

Slide 99 text

:base apply plugin: ‘com.android.library’ :app apply plugin: ‘com.android.application’ :login apply plugin: ‘com.android.library’ :content apply plugin: ‘com.android.library’

Slide 100

Slide 100 text

:base apply plugin: ‘com.android.library’ :app apply plugin: ‘com.android.application’ :login apply plugin: ‘com.android.library’ :content apply plugin: ‘com.android.library’ ?

Slide 101

Slide 101 text

Start writing new components in separate modules

Slide 102

Slide 102 text

Start writing new components in separate modules Identify core modules

Slide 103

Slide 103 text

Start writing new components in separate modules Identify core modules Make a plan and extract slowly

Slide 104

Slide 104 text

Start writing new components in separate modules Identify core modules Make a plan and extract slowly Enjoy the multi-module world

Slide 105

Slide 105 text

Thank you!

Slide 106

Slide 106 text

Thank you! github.com/Mauin twitter.com/@Mauin