Android app for the 4th Android Developer conference- Droidcon Kenya to be held in Nairobi on 8th - 10th November.
This project is the Android app for the conference. The app supports devices running Android 5.0+, and is optimized for phones and tablets of all shapes and sizes.
To ensure the project runs on your local environment ensure you have Java 17 on your PC or if you don't have you can install it from here.
If you have multiple installations of Java make sure to set Java 17 as your preferred version to run the project.
With the new Android Gradle Plugin version 8.0.0, you need Java 17 to run the project and any terminal commands. A workaround for this is to add this in your global gradle.properties file:
org.gradle.java.home=/Applications/Android Studio.app/Contents/jbr/Contents/HomeThis simply sets the Gradle Java home to the one set in Android Studio. Android Studio Flamingo comes bundled with Java 17. You only need to ensure the project uses Java 17. To do so, go to File -> Project Structure -> SDK Location -> Gradle Settings and set the Java Version to 17 from the list that appears.
- Jetpack Compose
- Coroutines - For Concurrency and Asynchronous tasks
- Ktor - For network requests
- Hilt - For Dependency Injection
- Crashlytics
- Coil - For Image Loading and Caching
- Lint Checks - Ktlint
The proposed architecture is as follows;
This layer will include;
- Network Calls
- Caching
- Storing and fetching Preferences.
- The repository implementation
- The relevant data models
- Relevant Mappers
This layer will contain;
- The repository
- The relevant domain models.
- View
- ViewModels
- Relevant Mappers
- Relevant Models.
The app will have the following features:
- Sessions
- Feed
- About
- Home
- Speakers
- Sponsors
- Authentication
- Feedback
This is the link to the app designs:
[Light Theme] (https://xd.adobe.com/view/dd5d0245-b92b-4678-9d4a-48b3a6f48191-880e/)
[Dark Theme] (https://xd.adobe.com/view/5ec235b6-c3c6-49a9-b783-1f1303deb1a8-0b91/)
The app uses a design system: Chai
The project uses Versions Catalog to set up and share dependencies across the modules. The main reasons for choosing to adopt Versions Catalog are:
- Central place to define dependencies.
- Easy syntax.
- Does not compromise on build speeds as changes do not need the module to be compiled.
To add a dependency, navigate to gradle/libs.versions.toml* file, which has all the dependencies for the whole project. This file has the following sections:
[versions] is used to declare the version numbers that will be referenced later by plugins and
libraries.
[libraries] Define the libraries that will be later accessed in our Gradle files.
[bundles] Are used to define a set of dependencies. For this, we have compose, room, lifecycle
and ktor as examples.
[plugins] Used to define plugins.
You need to add your dependency version in [versions]. This is unnecessary if you are not sharing the version across different dependencies. After defining the version, add your library in the [libraries] section as:
compose-activity = "androidx.activity:activity-compose:1.5.0"Moreover, if you have already defined the version in [versions], you define it as:
androidx-splashscreen = { module = "androidx.core:core-splashscreen", version.ref = "splash" }Note:
- You can use separators such as -, _v, . that will be normalized by Gradle to . in the Catalog and allow you to create subsections.
- Define variables using CamelCase.\
- Check if the library can be added to any existing bundles.
Previews are limited when using ViewModel within a composable.
If you want to preview a composable that uses a ViewModel, you should create another composable with the parameters from ViewModel passed as arguments of the composable. This way, you don't need to preview the composable that uses the ViewModel.
More on Previews and ViewModels can be found here.
This project uses coreLibraryDesugaring to support newer Java 8 APIs that are not available on API
levels 25 and below. Specifically the Kotlin kotlinx.datetime API which depends on
Java's java.time.
This allows use of kotlinx.datetime.LocalDate without having to wrap it
in @RequiresAPI(Build.VERSION_CODES.O) and also backports the fix to API level 21.
More on Desugaring using Android Gradle Plugin can be
found here.
Instructions on how to set up and add coreLibraryDesugaring to your project can be
found here.
Contributions are always welcome!
See CONTRIBUTING.md for ways to get started.
We would endlessly like to thank the following contributors
