MagdyEl-Sayed/OfflineSampleApp

Sample Offline-First MVVM app that uses Android Priority Job Queue, Room, Retrofit2, LiveData, LifecycleObserver, RxJava2, Dagger Android

Offline Sample App

Medium post covering this app: Building Offline-First App using MVVM, RxJava, Room and Priority Job Queue

What is an Offline App?

Offline App (or Offline-First App) enables user to seamlessly interact with it by using local device storage and then synchronizing the data with some remote storage (cloud database, etc) later via a background process.

With offline apps

1. users no longer get error messages due to network connection problems.
2. users benefit from faster loading times and conserving battery life.
3. users do not see any loading bar since their actions are performed against fast local storage.

App Overview

This app is a working sample that showcases one way of implementing offline commenting capability on Android platform. Users' comments are stored in local Room database first. Then a background job is spawned to synchronize local data with remote database if and when Internet connection is available.

This background job is designed to be persistent--it is guaranteed to execute even after app or device restarts while waiting for the network connection.

Libraries Used

• Patterns and frameworks
  • MVVM (Model-View-ViewModel) using Google's new Architecture components ViewModel, LiveData, LifecycleObserver, etc.
  • Clean Architecture with ViewModel interacting with UseCases and the latter interacting with local database. Making each layer highly testable.
• Database
  • Room Persistence Library, part of Google's new Architecture components.
• Background Job processing
  • Android Priority JobQueue which uses Job Scheduler for API level Lollipop and above and GcmNetworkManager for API level below Lollipop.
• Remote Call APIs
  • Retrofit 2 to perform HTTP requests.
  • Fake remote database using simple JSONPlaceholder REST API.
• Dependency Injection
  • Dagger Android 2.11 to manage App and Activity-scoped dependencies.
• Communication between app layers
  • RxJava2 and RxAndroid for interacting between ViewModel and local database.
  • RxRelay for publishing requests from the background job so that lifecycle observer components can update local database.
• Other
  • ButterKnife to simplify View and Listener bindings.
  • Travis CI is used for automating continuous integration.
  • The following quality checks are configured: checkstyle, pmd, findbugs, lint and RxLint. You can perform all of them at once by executing ./gradlew check

Branches

• master - comment sync response is observed and local database is updated by LifecycleObserver. For this to work, the app has to be in foreground.
• sync-in-background - comment sync response is observed and local database is updated by the background thread whenever connection is available. For this to work, the app does not need to be in foreground.

License

Copyright 2017 James Shvarts

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.