Skip to content

kumparan/react-native-android-inapp-updates

Repository files navigation

react-native-android-inapp-updates

npm PRs Welcome

React Native implementation of the Android In-App Update API. For more information on InApp Updates you can check the official documentation.

Build with ReasonML.

You will need to test the app via Internal App Sharing

Use internal app sharing to test in-app updates by performing the following steps:

  1. Make sure your test device has a version of your app installed that supports in-app updates and was installed using an internal app sharing URL.
  2. Follow the Play Console instructions to share your app internally. Upload a version of your app that uses a version code that is higher than the one you already have installed on the test device.
  3. On the test device, click the internal app sharing link for the updated version of your app but do not install the app from the Play Store page that appears after you click the link.
  4. Open the app from the device's app drawer or home screen. The update should now be available to your app, and you can test your implementation of in-app updates.

Project Milestone

  • startUpdateFlow Basic implementation.
  • Implement event emitter for flexible in-app updates download progress and downloaded status.
  • Implement clientVersionStalenessDays check for startUpdateFlow.

Requirements

  • In-app updates works only with devices running Android 5.0 (API level 21) or higher.
  • In-app updates can only work when signed with the same signing key as your app on the play store.

Getting started

$ npm install @gurukumparan/react-native-android-inapp-updates --save

or

$ yarn add @gurukumparan/react-native-android-inapp-updates

For react-native@0.60.0 or above

As react-native@0.60.0 or above supports autolinking, so there is no need to run linking process. Read more about autolinking here.

Mostly automatic installation

$ react-native link @gurukumparan/react-native-android-inapp-updates

Usage

import {startUpdateFlow, UpdateFlow} from '@gurukumparan/react-native-android-inapp-updates';

try {
    const result = await startUpdateFlow(UpdateFlow.FLEXIBLE);
} catch (e) {
    console.log('error:', e);
}

Reference

Methods

startUpdateFlow()

promise string startUpdateFlow(appUpdateType,clientVersionStalenessDays)
Input
Input Description Type Default Value
appUpdateType Android In-app updates type enum(flexible or immediate) immediate
clientVersionStalenessDays If an update is available In-app modal will only triger after x number of days since the Google Play Store app on the user's device has learnt about an available update. int 0
Promise Resolve
Value Description
Canceled In-app modal canceled by user
Successful User press the update button
Promise Reject
Value Description
checkAppUpdate failure: appUpdateInfoTask failed getting result. This can mean numerous reason check the log for more explanation.
No update available There is no update available with the appUpdateType type.
startUpdateFlow failure: Failed starting the Google Play In-app updates modal.

checkUpdateAvailability()

promise string checkUpdateAvailability()
Promise Resolve
Value Description
Update available Application update is available
Promise Reject
Value Description
checkAppUpdate failure: appUpdateInfoTask failed getting result. This can mean numerous reason check the log for more explanation.
No update available There is no update available

onCompleteUpdate()

promise string onCompleteUpdate()
Promise Resolve
Value Description
success Application update succeed
Promise Reject
Value Description
Download is not completed Application update process fail

❤️ From Indonesia