Home

Awesome

⚠️ Deprecated repository

This project has been moved to the following monorepo: capawesome-team/capacitor-plugins.


<p align="center"><br><img src="https://avatars.githubusercontent.com/u/105555861" width="128" height="128" /></p> <h3 align="center">App Update</h3> <p align="center"><strong><code>@capawesome/capacitor-app-update</code></strong></p> <p align="center"> Capacitor plugin that assists with app updates. </p> <p align="center"> <img src="https://img.shields.io/maintenance/yes/2023?style=flat-square" /> <a href="https://github.com/capawesome-team/capacitor-app-update/actions?query=workflow%3A%22CI%22"><img src="https://img.shields.io/github/actions/workflow/status/capawesome-team/capacitor-app-update/ci.yml?branch=main&style=flat-square" /></a> <a href="https://www.npmjs.com/package/@capawesome/capacitor-app-update"><img src="https://img.shields.io/npm/l/@capawesome/capacitor-app-update?style=flat-square" /></a> <br> <a href="https://www.npmjs.com/package/@capawesome/capacitor-app-update"><img src="https://img.shields.io/npm/dw/@capawesome/capacitor-app-update?style=flat-square" /></a> <a href="https://www.npmjs.com/package/@capawesome/capacitor-app-update"><img src="https://img.shields.io/npm/v/@capawesome/capacitor-app-update?style=flat-square" /></a> <a href="https://github.com/capawesome-team"><img src="https://img.shields.io/badge/part%20of-capawesome-%234f46e5?style=flat-square" /></a> </p>

This plugin supports retrieving app update information on Android and iOS.
Additionally, this plugin supports in-app updates on Android.

Maintainers

MaintainerGitHubSocial
Robin Genzrobingenz@robin_genz

Sponsors

This is an MIT-licensed open source project. It can grow thanks to the support by these awesome people. If you'd like to join them, please read more here.

<!-- sponsors --><!-- sponsors -->

Installation

npm install @capawesome/capacitor-app-update
npx cap sync

Android Variables

This plugin will use the following project variables (defined in your app’s variables.gradle file):

Configuration

No configuration required for this plugin.

Demo

A working example can be found here: robingenz/capacitor-plugin-demo

Usage

import { AppUpdate } from '@capawesome/capacitor-app-update';

const getCurrentAppVersion = async () => {
  const result = await AppUpdate.getAppUpdateInfo();
  return result.currentVersion;
};

const getAvailableAppVersion = async () => {
  const result = await AppUpdate.getAppUpdateInfo();
  return result.availableVersion;
};

const openAppStore = async () => {
  await AppUpdate.openAppStore();
};

const performImmediateUpdate = async () => {
  const result = await AppUpdate.getAppUpdateInfo();
  if (result.updateAvailability !== AppUpdateAvailability.UPDATE_AVAILABLE) {
    return;
  }
  if (result.immediateUpdateAllowed) {
    await AppUpdate.performImmediateUpdate();
  }
};

const startFlexibleUpdate = async () => {
  const result = await AppUpdate.getAppUpdateInfo();
  if (result.updateAvailability !== AppUpdateAvailability.UPDATE_AVAILABLE) {
    return;
  }
  if (result.flexibleUpdateAllowed) {
    await AppUpdate.startFlexibleUpdate();
  }
};

const completeFlexibleUpdate = async () => {
  await AppUpdate.completeFlexibleUpdate();
};

API

<docgen-index> </docgen-index> <docgen-api> <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->

getAppUpdateInfo(...)

getAppUpdateInfo(options?: GetAppUpdateInfoOptions | undefined) => Promise<AppUpdateInfo>

Returns app update informations.

Only available for Android and iOS.

ParamType
options<code><a href="#getappupdateinfooptions">GetAppUpdateInfoOptions</a></code>

Returns: <code>Promise<<a href="#appupdateinfo">AppUpdateInfo</a>></code>


openAppStore(...)

openAppStore(options?: OpenAppStoreOptions | undefined) => Promise<void>

Opens the app store entry of the app in the Play Store (Android) or App Store (iOS).

Only available for Android and iOS.

ParamType
options<code><a href="#openappstoreoptions">OpenAppStoreOptions</a></code>

performImmediateUpdate()

performImmediateUpdate() => Promise<AppUpdateResult>

Performs an immediate in-app update.

Only available for Android.

Returns: <code>Promise<<a href="#appupdateresult">AppUpdateResult</a>></code>


startFlexibleUpdate()

startFlexibleUpdate() => Promise<AppUpdateResult>

Starts a flexible in-app update.

Only available for Android.

Returns: <code>Promise<<a href="#appupdateresult">AppUpdateResult</a>></code>


completeFlexibleUpdate()

completeFlexibleUpdate() => Promise<void>

Completes a flexible in-app update by restarting the app.

Only available for Android.


addListener('onFlexibleUpdateStateChange', ...)

addListener(eventName: 'onFlexibleUpdateStateChange', listenerFunc: (state: FlexibleUpdateState) => void) => PluginListenerHandle

Adds a flexbile in-app update state change listener.

Only available for Android.

ParamType
eventName<code>'onFlexibleUpdateStateChange'</code>
listenerFunc<code>(state: <a href="#flexibleupdatestate">FlexibleUpdateState</a>) => void</code>

Returns: <code><a href="#pluginlistenerhandle">PluginListenerHandle</a></code>


removeAllListeners()

removeAllListeners() => Promise<void>

Remove all listeners for this plugin.


Interfaces

AppUpdateInfo

PropTypeDescription
currentVersion<code>string</code>Version code (Android) or CFBundleShortVersionString (iOS) of the currently installed app version. Only available for Android and iOS.
availableVersion<code>string</code>Version code (Android) or CFBundleShortVersionString (iOS) of the update. Only available for Android and iOS.
availableVersionReleaseDate<code>string</code>Release date of the update in ISO 8601 (UTC) format. Only available for iOS.
updateAvailability<code><a href="#appupdateavailability">AppUpdateAvailability</a></code>The app update availability. Only available for Android and iOS.
updatePriority<code>number</code>In-app update priority for this update, as defined by the developer in the Google Play Developer API. Only available for Android.
immediateUpdateAllowed<code>boolean</code>true if an immediate update is allowed, otherwise false. Only available for Android.
flexibleUpdateAllowed<code>boolean</code>true if a flexible update is allowed, otherwise false. Only available for Android.
clientVersionStalenessDays<code>number</code>Number of days since the Google Play Store app on the user's device has learnt about an available update if an update is available or in progress. Only available for Android.
installStatus<code><a href="#flexibleupdateinstallstatus">FlexibleUpdateInstallStatus</a></code>Flexible in-app update install status. Only available for Android.
minimumOsVersion<code>string</code>The minimum version of the operating system required for the app to run in iOS. Only available for iOS.

GetAppUpdateInfoOptions

PropTypeDescription
country<code>string</code>The two-letter country code for the store you want to search. See http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for a list of ISO Country Codes. Only available for iOS.

OpenAppStoreOptions

PropTypeDescription
country<code>string</code>The two-letter country code for the store you want to search. See http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for a list of ISO Country Codes. Only available for iOS.

AppUpdateResult

PropType
code<code><a href="#appupdateresultcode">AppUpdateResultCode</a></code>

PluginListenerHandle

PropType
remove<code>() => Promise<void></code>

FlexibleUpdateState

PropTypeDescription
installStatus<code><a href="#flexibleupdateinstallstatus">FlexibleUpdateInstallStatus</a></code>Flexible in-app update install status.
bytesDownloaded<code>number</code>Returns the number of bytes downloaded so far. undefined if the install status is other than DOWNLOADING.
totalBytesToDownload<code>number</code>Returns the total number of bytes to be downloaded for this update. undefined if the install status is other than DOWNLOADING.

Enums

AppUpdateAvailability

MembersValue
UNKNOWN<code>0</code>
UPDATE_NOT_AVAILABLE<code>1</code>
UPDATE_AVAILABLE<code>2</code>
UPDATE_IN_PROGRESS<code>3</code>

FlexibleUpdateInstallStatus

MembersValue
UNKNOWN<code>0</code>
PENDING<code>1</code>
DOWNLOADING<code>2</code>
INSTALLING<code>3</code>
INSTALLED<code>4</code>
FAILED<code>5</code>
CANCELED<code>6</code>
DOWNLOADED<code>11</code>

AppUpdateResultCode

MembersValueDescription
OK<code>0</code>The user has accepted the update.
CANCELED<code>1</code>The user has denied or cancelled the update.
FAILED<code>2</code>Some other error prevented either the user from providing consent or the update to proceed.
NOT_AVAILABLE<code>3</code>No update available.
NOT_ALLOWED<code>4</code>Update type not allowed.
INFO_MISSING<code>5</code>App update info missing. You must call getAppUpdateInfo() before requesting an update.
</docgen-api>

Test with internal app-sharing

The Android Developers documentation describes how to test in-app updates using internal app sharing: https://developer.android.com/guide/playcore/in-app-updates/test

Changelog

See CHANGELOG.md.

License

See LICENSE.