sammymutahigicheru / dvt-weather-app

Writing DTV Weather App using Android Architecture Components, in 100% Kotlin, using Android Jetpack Components 🚀

Pre-Requisities

• A valid Google Maps Api Key
• A valid Open Weather API Key

Setup

• Add MAP_KEY to your local.properties file
• Paste your open weather API key to API_KEY on Constants Class Object

Unit Tests

Run script .\gradlew connectedCheck to generate Unit test Jacoco Reports Run script .\gradlew connectedDebugAndroidTest to generate Instrumented test Jacoco Reports

Spek

This allows us to easily define specifications in a clear, understandable, human-readable way. This framework allows you to describe tests and expected behaviors in a more readable way.

To run tests in Android Studio you need to install Spek Framework plugin (search for Spek Framework).

The UI test run normally, either on a device or an emulator, without any special plugin or dependency.

A few hiccups

When mocking webserver response MockWebserver times out for some reason i.e socket timeout exception

How it's built

• Technologies used

  • Kotlin
  • Coroutines
  • Flow
  • KOIN
  • Retrofit
  • Jetpack
    • Room
    • Lifecycle
    • ViewModel
  • Timber

• Architecture

  • MVVM - Model View View Model

• Tests

  • JUnit5
  • Spek
  • MockK
  • Truth

• Gradle

  • Plugins
    • jacoco
    • Detekt

• CI/CD

  • Github Actions

Screenshots

I added some screenshots in the screenshots folder, in the root directory of the project.

Current Weather	Favourites	Maps