RxMagneto
A fast, light-weight and powerful Play Store information fetcher for Android.
Specs
This library allows you to fetch various live information from Play Store of your app or any other app of your choice. With just a few lines of code, you can get access to a lot of useful app data fetched fresh from the Play Store.
It has been named after the famous anti-villain from X-Men. This library has been completely written using RxJava giving you powerful controls to make the most use of it.
Download
This library is available in jCenter which is the default Maven repository used in Android Studio.
Gradle
dependencies {
// other dependencies here
compile 'com.andrognito.rxmagneto:rxmagneto:2.0.0'
}
Maven
<dependency>
<groupId>com.andrognito.rxmagneto</groupId>
<artifactId>rxmagneto</artifactId>
<version>2.0.0</version>
<type>pom</type> </dependency>
Migrating to Version 2
RxMagneto 2 brings some breaking changes from version 1. The entire library is re-written using RxJava 2. All the Observables are now changed into Singles, so there will be some re-work for you. You also do NOT need to perform these operations in the background thread as it is automatically done for you.
The core functionality of the library remains the same. Every feature in the new version of this library works in the same way and returns the same result as the previous version.
Spread Some ❤?
Use Cases
There are several use cases of this library. Here are some common examples for you to get started, but you can always be creative and make the most use of it.
App Updates
This is a common problem for many developers wanting to check if their users are using the latest version of the app available on Play Store or not. With RxMagneto, you can get it done with just a single line of code and zero hassle.
Recent Changelog
You might want to show your users the latest changelog when they update the app. RxMagneto can help you fetch the most recent changelog directly from Play Store with just one line of code.
User Ratings
Many developers prompt their users to rate the app after a certain period of time. You can also show your current rating and ratings count directly from Play Store to encourage these users to rate your app even more.
Setup
Once you have downloaded the library in your project, setting up RxMagneto is super-easy.
RxMagneto rxMagneto = RxMagneto.getInstance();
rxMagneto.initialize(this);
The initialize method takes a Context
object. It can either be an Application
context or Activity
context.
Quick Example
Here is a quick example for you to get started right away in less than a minute.
RxMagneto rxMagneto = RxMagneto.getInstance();
rxMagneto.initialize(this);
Single<String> version = rxMagneto.grabVersion(packageName);
version.observeOn(AndroidSchedulers.mainThread())
.subscribe(s -> {
Log.d("RxMagneto", "Version: " + s);
}
, throwable -> {
Log.d("RxMagneto", "Error");
}
);
All Features
Here is a list of all the featues offered by RxMagneto. I will be actively taking more feature requests and expand the library over time.
Get Play Store URL
Gets the Play Store URL of the specified package. You can make this call in the main thread of the application.
Single<String> urlSingle = rxMagneto.grabUrl(packageName);
Get Verified Play Store URL
Gets the verified Play Store URL of the specified package. It automatically performs the operation in a background thread, so that you do NOT need to explicitly do it.
Single<String> urlSingle = rxMagneto.grabVerifiedUrl(packageName);
Get Version
Gets the latest version of the specified package from Play Store. It automatically performs the operation in a background thread, so that you do NOT need to explicitly do it.
Single<String> versionSingle = rxMagneto.grabVersion(packageName);
Check If Update Is Available
Check if an update is available for the specified package from Play Store. It automatically performs the operation in a background thread, so that you do NOT need to explicitly do it.
Single<Boolean> updateAvailableSingle = rxMagneto.isUpgradeAvailable(packageName);
Get Downloads
Gets the no. of downloads of the specified package from Play Store. It automatically performs the operation in a background thread, so that you do NOT need to explicitly do it.
Single<String> downloadsSingle = rxMagneto.grabDownloads(packageName);
Get Last Published Date
Gets the last published date of the specified package from Play Store. It automatically performs the operation in a background thread, so that you do NOT need to explicitly do it.
Single<String> publishedDateSingle = rxMagneto.grabPublishedDate(packageName);
Get OS Requirements
Gets the OS requirements of the specified package from Play Store. It automatically performs the operation in a background thread, so that you do NOT need to explicitly do it.
Single<String> osRequirementsSingle = rxMagneto.grabOsRequirements(packageName);
Get Content Rating
Gets the content rating of the specified package from Play Store. It automatically performs the operation in a background thread, so that you do NOT need to explicitly do it.
Single<String> contentRatingSingle = rxMagneto.grabContentRating(packageName);
Get App Rating
Gets the app rating of the specified package from Play Store. It automatically performs the operation in a background thread, so that you do NOT need to explicitly do it.
Single<String> appRatingSingle = rxMagneto.grabAppRating(packageName);
Get App Ratings Count
Gets the no. of app ratings of the specified package from Play Store. It automatically performs the operation in a background thread, so that you do NOT need to explicitly do it.
Single<String> appRatingsCountSingle = rxMagneto.grabAppRatingsCount(packageName);
Get Recent Changelog (as Array)
Gets the recent changelog (as array) of the specified package from Play Store. It automatically performs the operation in a background thread, so that you do NOT need to explicitly do it.
Single<ArrayList<String>> changelogSingle = rxMagneto.grabPlayStoreRecentChangelogArray(packageName);
Get Recent Changelog (as String)
Gets the recent changelog (as string) of the specified package from Play Store. It automatically performs the operation in a background thread, so that you do NOT need to explicitly do it.
Single<String> changelogSingle = rxMagneto.grabPlayStoreRecentChangelog(packageName);
Contribution
This library is quite powerful and offers a lot of features. But I will love to have more feature requests from you to expand it further. If you find a bug or would like to improve any aspect of it, feel free to contribute with pull requests.
About The Author
Aritra Roy
Android & Backend Developer. Blogger. Designer. Fitness Enthusiast.
License
Copyright 2017 aritraroy 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.