Jambo

A news application that shows articles based a user's current location as well as other categories for locations such as Kampala (Uganda), Kigali (Rwanda), Nairobi (Kenya), Lagos (Nigeria), and New York (USA).

Jambo on Google Play Store

Jambo on Amazon App Store

Screenshots

Getting Started and Installation

1. Open up the terminal and clone the repository under any directory using git clone https://github.com/wasswa-derick/Jambo.git.

2. In Android Studio, under the file menu select open, then select an existing project and navigate to the project you just cloned.

3. Build the project using ./gradlew build.

4. Run the application on a connected device or emulator.

Prerequisites

1. Set up Android Studio

2. Enable Kotlin in Android Studio

3. Run application on emulator

4. Run application on android device

Running the tests (Unit and Instrumentation tests)

1. Run tests using ./gradlew test or ./gradlew jacocoTestReport.

Unit tests can be run using one of the following:

./gradlew test

Jacoco Tests report (Run both instrumented and unit tests at once).

./gradlew jacocoTestReport

2. To run instrumentation tests, endeavor to have an emulator or an Android Device connected either via USB or WIFI.

Architecture

• Model View ViewModel (MVVM)

Consumed API Endpoints

    https://newsapi.org/v2/everything?q={query}&apiKey={key}

Dependencies

• Android - Operating System
• Retrofit - HTTP Requests
• Kotlin - Programing language
• Room - Local database
• Dagger 2 - Dependency Injection
• RxAndroid - Asynchronous and event-based functionality
• RxJava - Asynchronous and event-based functionality
• Picasso - Image processing
• Google Maps API - Maps
• Navigation Drawer - Navigation
• GPS Monitor - Device Location

Authors

Derick Wasswa

Credits

All props to NewsAPI.org for availing the service.