Android MVP Architecture: Sample App

This repository contains a detailed sample app that implements MVP architecture using Dagger2, GreenDao, RxJava, FastAndroidNetworking, PlaceHolderView and AndroidDebugDatabase

Architecture Blueprint

Project Structure

Read the below listed articles. They describe the MVP concepts and the Project structure.

1. MVP: Part 1
2. MVP: Part 2
3. MVP: Part 3
4. Extension with Interactors and Repositories

The app has following packages:

1. data: It contains all the data accessing and manipulating components.
2. di: Dependency providing classes using Dagger2.
3. ui: View classes along with their corresponding Presenters.
4. service: Services for the application.
5. utils: Utility classes.

Classes have been designed in such a way that it could be inherited and maximize the code reuse.

Library reference resources:

1. RxJava2: https://github.com/amitshekhariitbhu/RxJava2-Android-Samples
2. Dagger2: https://github.com/MindorksOpenSource/android-dagger2-example
3. FastAndroidNetworking: https://github.com/amitshekhariitbhu/Fast-Android-Networking
4. PlaceHolderView: https://github.com/janishar/PlaceHolderView
5. AndroidDebugDatabase: https://github.com/amitshekhariitbhu/Android-Debug-Database
6. Calligraphy: https://github.com/chrisjenx/Calligraphy
7. GreenDao: http://greenrobot.org/greendao/
8. ButterKnife: http://jakewharton.github.io/butterknife/

Concept reference resources:

1. Introduction to Dagger 2: Part 1
2. Introduction to Dagger 2: Part 2
3. Android Dagger2: Critical things to know before you implement
4. The Best Android Networking Library for Fast and Easy Networking
5. RxJava + Fast Android Networking
6. Migrating from RxJava 1.0 to RxJava 2.0 and Learn RxJava by Examples
7. Android Tinder Swipe View Example
8. Debugging Android Databases And Shared Preferences In The Easiest Way
9. RxJava Anatomy: What is RxJava, how RxJava is designed, and how RxJava works.
10. Powerful Android ORM: greenDAO 3 Tutorial

Playstore App of Mindorks build on this MVP architecture

Correctify: An English Editing and Learning app

Looking for MVVM Architecture - Check here

Looking for Kotlin MVP Architecture - Check here

Mindorks open source projects

Check out Mindorks awesome open source projects here

How do I use this project?

This is a boilerplate project aimed to help bootstrap new Android MVP Applications. Feel free to fork this application or use AndroidStarters to create new app using this boilerplate.

MVP template

When we follow any architecture pattern like MVP, MVVM, MVP clean, we always come across a small but repetitive task to create basic files like Android Activity, Presenter, View, Api models and then writing boiler plate code. This usually takes 1-2 hours for each single screen. To ease out work and save time We have created an automated template which will do above work in less than 20 seconds.

How to Install

Find the template/MVPActivity folder under root directory of android-mvp-architecture app. Paste the MVPActivity folder at below location.

1. Windows - C:\Program Files\Android\Android Studio\plugins\android\lib\templates\activities
2. Mac - /Applications/Android/Studio.app/Contents/plugins/android/lib/templates/activities

Restart the Android Studio.

How to use

Select the folder under which you want to create a new MVP folder. This MVP folder will contain Activity, Presenter, MVpPresenter and View class. For example, to create a new MVP folder under “view” folder, do as shown below.

License

   Copyright (C) 2017 MINDORKS NEXTGEN PRIVATE LIMITED

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

Contributing to Android MVP Architecture

All pull requests are welcome, make sure to follow the contribution guidelines when you submit pull request.