Bitlet Synchronizer
Bitlet Synchronizer is a project to improve handling of data in iOS and Android applications. The goal is to provide a simple way to fetch and cache data from one or multiple sources without having to program these manually. Later on, it will also able modify and push the data back, as long as there is an API supporting it.
The library has been designed to be generic, and not depend on any existing library. The examples will show how to use it together with AlamoFire (iOS) or Retrofit (Android).
Features
- Provides a Bitlet protocol (iOS) or interface (Android) to integrate the library with your domain layer (data models)
- A synchronizer singleton to easily start the bitlet loading process
- Supports data caching in memory with cache expire times that can be specified per bitlet
- Easily check the state of the cache, for example, if the item is loading
- When loading the same resource multiple times, the synchronizer will combine them and makes only 1 actual load call
- Combine loading bitlets in operations, with a single callback to handle the result
iOS integration guide
The library is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "BitletSynchronizer", '~> 0.3.9'The above version is for Swift 5.0. For older Swift versions use the following:
- Swift 4.2: BitletSynchronizer 0.3.6
- Swift 4.1: BitletSynchronizer 0.2.0
Android integration guide
When using gradle, the library can easily be imported into the build.gradle file of your project. Add the following dependency:
compile 'com.crescentflare.bitletsynchronizer:BitletSynchronizerLib:0.3.6'
Make sure that jcenter is added as a repository.
Example
The provided example will show how to integrate the library with a popular networking library and a domain layer featuring models. It will demonstrate fetching, serializing and caching data (including error handling).
Status
The library is new, but should provide already a number of useful features. New features may be added in the future.