/TheMovieDB-Android

Android MovieDB application using TMDB api. Developed for Grameenphone Codemasters Hackathon that placed first in the competition.

Primary LanguageKotlin

Codemasters Submission

Implementation Details

  • uses AndroidX
  • uses Kotlin
  • uses databinding
  • uses android jetpack navigation and architecture components
  • architectural pattern MVVM as recommended by Google
  • deals with security issues by keeping secrets like api_key isolated from source code
  • uses Glide for fetching remote images
  • uses Retrofit and RxAndroid to make API calls
  • uses Chucker for testing and logging API calls
  • uses Room ORM for local db
  • uses Lotte for animations
  • uses two types of caching mechanism.
    • Glide Image Loader cache implementation. My implementation caches remote images upto 50mb which allows app to render high res images faster.
    • API caching. Caches network calls made by retrofit and loads data accordingly. These allows the user to have offline mode usage (when no internet is available).
  • uses separate build flavors for grameenphone and telenor. (Different icons and different app name)
  • uses Chucker, junit, espresso and roboelectric for testing

Features

Home Page

  1. The Home Screen fetches 3 lists of data from the given API and populates 3 recycler views with it. The first two recycler views scroll horizontally and the last one scrolls vertically as specified.

  2. A loader animation (lotte) is shown every time the app waits for an api call.

  3. Theres a wishlist icon in this page, that shows if any of the movie/tv show in this page was wishlisted by the user.

Detail Page

  1. This page renders a full screen detail of a movie/tv show.

  2. Theres a add to wishlist feature in this page. Pressing the heart shaped button toggles a item between being wishlisted and not.

  3. The wishlisted items are stored in a local SQLite database (powered by ROOM ORM)

Wishlist Page

  1. This page shows the items currently in the user's wishlist.

  2. A user can remove an item from the wishlist by pressing the delete icon on the right.

The following video demonstrates the app's features:

Project Structure

  • /app/src/grameenphone directory contains specific resources for Grameenphone app's flavor

  • /app/src/telenor directory contains specific resources for Grameenphone app's flavor

  • /app/src/main/java/com/gphackathon directory contains the user interfaces, view models, models, database etc. It has four sub-directories:

    • data directory contains the local model classes, constants & the remote response models
    • views directory contains all the ui related codes, fragments, activities, dialogs etc
    • utils directory contains the utility classes for the project
      • api directory contains the apiclient and apiservices for retrofit and rxjava2
    • app contains the base mulidexapplication for this app

  • app/src/main/res contains the xml resources for this project i.e xml ui layouts, drawables, themes, colors and strings.

Installation Guidelines

  • Clone/Download the repo
  • The project was build using the latest(v4.1) Android Studio. Opening it with android studio version 4.0 or up should be fine.
  • Wait until the gradle dependencies are resolved
  • The project uses gradle version (6.5). In case of any issues, check your gradle version.
  • Select your desired build variant from the build variant tab. The options should be: grameenphoneDebug, grameenphoneRelease, telenorDebug, telenorRelease.
  • Run the project