Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/a7ul/react-native-appstore-version-checker
[Deprecated] A react native module to fetch the version of latest app from android playstore or apple app store
https://github.com/a7ul/react-native-appstore-version-checker
appstore check openlibrary playstore react-native version
Last synced: 3 days ago
JSON representation
[Deprecated] A react native module to fetch the version of latest app from android playstore or apple app store
- Host: GitHub
- URL: https://github.com/a7ul/react-native-appstore-version-checker
- Owner: a7ul
- Created: 2017-05-15T04:43:34.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-11-27T10:18:19.000Z (almost 5 years ago)
- Last Synced: 2024-10-14T14:47:23.341Z (about 1 month ago)
- Topics: appstore, check, openlibrary, playstore, react-native, version
- Language: JavaScript
- Homepage:
- Size: 226 KB
- Stars: 91
- Watchers: 2
- Forks: 37
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# react-native-appstore-version-checker [Deprecated] 
[](https://www.npmjs.com/package/react-native-appstore-version-checker)
A react native module to check an app's version on playstore or ios app store.
This module can be used to check if your app has a new version on playstore or apple app store.
or you can even check what is the latest version of another app on playstore.
# DEPRECATED
This package is now deprecated and will no longer be maintained. Please use https://github.com/kimxogus/react-native-version-check as an alternative.
## Getting started
`npm install react-native-appstore-version-checker --save`
or
`yarn add react-native-appstore-version-checker`
### Automatic installation
`react-native link react-native-appstore-version-checker`
### Manual installation
#### iOS
Nothing to be done here ( its pure JS for IOS ;) )
#### Android
1. Open up `android/app/src/main/java/[...]/MainActivity.java`
- Add `import com.masteratul.RNAppstoreVersionCheckerPackage;` to the imports at the top of the file
- Add `new RNAppstoreVersionCheckerPackage()` to the list returned by the `getPackages()` method
2. Append the following lines to `android/settings.gradle`:
```
include ':react-native-appstore-version-checker'
project(':react-native-appstore-version-checker').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-appstore-version-checker/android')
```
3. Insert the following lines inside the dependencies block in `android/app/build.gradle`:
```
compile project(':react-native-appstore-version-checker')
```
## Usage
```javascript
import { getAppstoreAppMetadata } from "react-native-appstore-version-checker";
or;
var getAppstoreAppMetadata = require("react-native-appstore-version-checker")
.getAppstoreAppMetadata;
//On Android u can do
getAppstoreAppMetadata("com.supercell.clashofclans") //put any apps packageId here
.then(metadata => {
console.log(
"clashofclans android app version on playstore",
metadata.version,
"published on",
metadata.currentVersionReleaseDate
);
})
.catch(err => {
console.log("error occurred", err);
});
//On IOS u can do
getAppstoreAppMetadata("529479190") //put any apps id here
.then(appVersion => {
console.log(
"clashofclans android app version on appstore",
metadata.version,
"published on",
metadata.currentVersionReleaseDate
);
})
.catch(err => {
console.log("error occurred", err);
});
```
### How To find an appid in IOS or packageId in Android
#### IOS
**Finding appid for an ios app**
Search for an app on itunes store. Lets take the example of `clash of clans`.
The area marked on red is the app's `appid`
#### ANDROID
**Finding packageId for an android app**
Search for an app on playstore. Lets take the example of `clash of clans`.
The area marked on red is the app's `packageId`
### Advanced Options
```javascript
getAppstoreAppMetadata(identifier, options);
```
**params:**
- `identifier` is the app package id like `com.example.app`
- `options` contains values which can affect the result obtained from the store
- `jquerySelectors` [Android] object with metadata property names to dom dom element identifiers (much like jquery selector) for playstore app page. Currently to get the appversion from the page we do load `https://play.google.com/store/apps/details?id=` and parse `$('body > [itemprop="softwareVersion"]')` but you can optionally pass in a custom selector if you want. This is useful if dom structure of the app store page changes in the future.
- `typeOfId` [iOS] (default is `id`) It can be either `id` or `bundleId`. If the `typeOfId` is `id` you need to pass `identifier` as appid and if `typeOfId` is `bundleId` you need to pass bundleIdentifier to `identifier`. It is basically, the query parameter for `https://itunes.apple.com/lookup?${typeOfId}=${identifier}`.
Currently to get the ios version number from app store we hit the url `https://itunes.apple.com/lookup?id=` by default.
or we can also hit
`https://itunes.apple.com/lookup?bundleId=` if we pass typeOfId as `bundleId`.
When we hit the above said urls we get json with all the info of the app.
- `country` [iOS] (default is `us`) The two-letter country code for the store you want to search. The search uses the default store front for the specified country.
```javascript
const storeSpecificId =
Platform.OS === "ios" ? "529479190" : "com.supercell.clashofclans";
getAppstoreAppMetadata(storeSpecificId, {
jquerySelectors: {
version: "[itemprop='softwareVersion']"
},
typeOfId: "id",
country: "de"
});
```
```javascript
getAppstoreAppVersion(identifier, options);
```
`getAppstoreAppVersion` has been maintained with previous versions for backwards compatibility. The only difference is that instead
of `jquerySelectors`, the `options` objet only takes one selector for the app version and it's called `jquerySelector`.
**Example**
```javascript
const storeSpecificId =
Platform.OS === "ios" ? "529479190" : "com.supercell.clashofclans";
getAppstoreAppVersion(storeSpecificId, {
jquerySelector: "[itemprop='softwareVersion']",
typeOfId: "id",
country: "de"
});
```
Quick note: it will get the public version from stores, that is, will not get alfa, beta or internal versions.
### Contributors
- [Atul R](https://github.com/master-atul)
- [Dmytro Gorelik](https://github.com/dhorelik)
- [Oleg Filimonov](https://github.com/olegfilimonov)
- [Carlos](https://github.com/carl0395)
- [EricH](https://github.com/jehartzog)
- [Regan Langford](https://github.com/ReganL)
- [Yuttana K](https://github.com/Thunderbird7)
- [Luís](https://github.com/luissmg)
- [Grover TB](https://github.com/grovertb)
- [David Saltares](https://github.com/dsaltares)
### License
MIT
© Atul R