| # Module kotlinx-coroutines-android |
| |
| Provides `Dispatchers.Main` context for Android applications. |
| |
| Read [Guide to UI programming with coroutines](https://github.com/Kotlin/kotlinx.coroutines/blob/master/ui/coroutines-guide-ui.md) |
| for tutorial on this module. |
| |
| # Optimization |
| |
| R8 and ProGuard rules are bundled into this module. |
| R8 is a replacement for ProGuard in Android ecosystem, it is enabled by default since Android gradle plugin 3.4.0 |
| (3.3.0-beta also had it enabled). |
| For best results it is recommended to use a recent version of R8, which produces a smaller binary. |
| |
| When optimizations are enabled with R8 version 1.6.0 or later |
| the following debugging features are permanently turned off to reduce the size of the resulting binary: |
| |
| * [Debugging mode](../../docs/debugging.md#debug-mode) |
| * [Stacktrace recovery](../../docs/debugging.md#stacktrace-recovery) |
| * The internal assertions in the library are also permanently removed. |
| |
| You can examine the corresponding rules in this |
| [`coroutines.pro`](resources/META-INF/com.android.tools/r8-from-1.6.0/coroutines.pro) file. |
| |
| # Package kotlinx.coroutines.android |
| |
| Provides `Dispatchers.Main` context for Android applications. |