Giter Club home page Giter Club logo

fyber_mobile_offers's Introduction

Fyber Mobile Offers Application CircleCI Build Status

This repository holds the source code of the Fyber Mobile Offers Application, a simple Android client for the Fyber.com. This application was created by Mohsen Mirhoseini Argi, as part of the technical assessment by the Fyber team.


What is this repository for?

  • Fyber Mobile Offers Application
  •   Version:  1.0
    
  • Last Update: Sat Oct 1, 2016

Screenshot Screenshot


Development Tools

  • Android Studio v2.2
  • gradle-plugin v2.2.0
  • Android SDK Build Tools v24.0.2
  • MinSdkVersion 9
  • CompileSDKVersion 24

Dependencies

  • Android Support Tools (recyclerView, cardView, vector, palette,... ) v24.2.1
  • Retrofit v2.1.0
  • Okhttp v3.4.1
  • Dagger v2.4
  • RxJava v1.1.9
  • RxAndroid v1.2.1
  • Butterknife v8.0.1
  • Timber v4.1.2
  • AndroidUtils v1.0.1
  • AppSettings v1.0.2
  • jUnit v4.12
  • Android Support Test v0.5
  • Mockito v1.10.19
  • Robolectric v3.1-rc1
  • Espresso v2.2.2

Important Notes

The application has two Activity, Login and Main Activities. The Main Activity is responsible for presenting Offers List and will use Login Activity to load API key and other values.

All activity lifecycle and network behaviours are implemented, and according to device size and network situation user get a good UI and UX. In case having update cache data, app do not call Network. If no internet connection or network error, a dialog pops up and ask user to turn on network connection or retry.

Application network cache on Disk cause it work smooth and result a good UX.

Some simple Test Cases was designed to test application UI functionality and core classes using jUnit and AndroidUnitTest.

Application Structure

The Application implemented and structured bases on the MVP pattern best practice, contributed by Antonio Leiva.

Whole application functionality is implemented in "Core-Lib" module using pure Java. The "App" module contain all codes required for application to load on Android, which in this case can be replace by any other interface (like console app,...)

The view (MainActivity), contain a fragment. Offers fragment contain its own presenter and implement View interfaces and the only thing that the view will do is calling a method from the presenter every time there is an interface action.

The presenters (Offers, Main and Login Presenters), are responsible to act as the middle man between views and models. They retrieves data from the model and returns it formatted to the view. It also decides what happens when user interact with the view.

The models (Offers Interactor), would only be the gateway to the service domain layer or business logic. In this case it provide the data needed to be displayed in the view from Network, Google Play Services (AdsId) or cached data (SharedPreferences).

The networking and API call are managed by Retrofit and OkHttp as its httpclient, contributed by Square. It also shows decent logs while application is running in Debug mode. The whole caching and offline interceptors are also implemented using these libraries.

Layers communications are managed by RxJava & RxAndroid contributed by ReactiveX.

Dependency Injections are being managed by Dagger created by Square and now maintained by Google.

Diagram

Some minor Android common functions are managed using AndroidUtils library, and disk caching is also being managed using AppSettings library, both developed and published on jCenter by myself.

Whole projects Dependencies are placed in "libraries.gradle" to avoid version conflicts and redundant in different modules.

Used new DataBinding library contributed by Google in Adapters for faster development, and added CustomBindingAdapter to handle downloading and caching images using Picasso library, which also use google Palette support library as a helper class to extract prominent colors from image and making a related background for different CardViews.

The endless list is being handled using EndlessRecyclerViewScrollListener which wait for the end of the list and trigger the next page api call if there is more pages announce by previous api call.

The Android Log system is replaced with Timber contributed by Jake Wharton, which avoid logging in release version.

A general HashGenerator class generates the hash key required for calling API using all params and API key.

Google Ads ID and Limitation required for API received using GoogleAds class and kept in memory and also cached on disk to avoid complexity of calling Google Play Services methods for every network call.

Used new SupportVector library in some icons cases for a better UI.

Sample test cases are implemented by mockito, espresso, robolectric and mocking dagger.

Used circleci as Continues Integration service which binded with Github repo.

fyber_mobile_offers's People

Contributors

mohsenoid avatar

Stargazers

Mojtaba Shirkhani avatar Nic Reich avatar Dzmitry Lakisau avatar Austin Hamilton avatar  avatar Prathamesh avatar Muhammad Iqbal avatar Lin Yuan avatar Bayu avatar Vimal avatar Theo Ioakeimidis avatar Joel Acedo avatar  avatar Anmol Arora avatar Michał Bocian avatar Hamza Mehri avatar Thien An TRAN avatar Sucipto avatar Roger Silva avatar  avatar Mahdi Pishguy avatar

Watchers

abbas avatar

fyber_mobile_offers's Issues

مستندات آموزشی برای dagger

سلام دوست عزیز. برای این dagger و rxjava
اگه به فارسی بتونید آموزش یا توضیحات مفیدی بدید ممنون میشم. پیاده سازی اجرا و لزوم استفاده از اون
منظورم هستش. به انگلیسی خیلی مطالعه کردم ولی فک میکنم درست مفهومش رو نگرفتم

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.