Automatic Updating

Overview of the App Builder Auto update feature.

Appery.io has an automatic app update feature, which means you can update apps that your end-users have already installed on the device and this can be done without going through an app store.
The automatic update is performed from the EXPORT menu, located in the App Builder Toolbar:

👍

The feature is optional for every project and is enabled by default.

🚧

Important Note!

  • Only web resources: HTML/JS/SCSS can be auto updated.
  • Cordova core (installed by default) and 3rd party Cordova plug-ins can’t be automatically updated. So, if you once decide to add (enable) any new plug-in to your app, you will need to republish it to make the automatic update feature work.

The following resources require that your app gets published through the app store:

  • Launch icons.
  • Splash screens.
  • Push notification configuration.
  • New app permissions (iOS keys or Android permissions).
  • Any other native code.

Automatic Updating Setup

For this feature to be available for an app, your initial build must include:

  1. Automatic update feature enabled under Project > App settings > Android binary/iOS binary:

🚧

Important Note!

Note that if the initial app build was created with the autoupdate feature enabled for only one type of binary (iOS or Android), only this binary will be receiving updates automatically.

To enable automatic updating for the other binary type, you will need to republish the app.

  1. Hot Code Push Plugin of version 1.6.8:
Automatic updates enabled for Android binaryAutomatic updates enabled for Android binary

Automatic updates enabled for Android binary

📘

Please note, that if you are using the latest Appery.io library, the Cordova Hot Code Push Plugin should be enabled (App settings > Cordova plugins > Core Cordova plugins) in order for your application to display the auto update download indicator.

  1. Also, your end-user(s) will need to install the app for the first time either from an app store or directly on the device.

Disabling Automatic Updates

To disable automatic updates, go to: Project > App settings > Android binary/iOS binary and uncheck the Enable autoupdate box:

Automatic updates disabled for iOS binaryAutomatic updates disabled for iOS binary

Automatic updates disabled for iOS binary

Using Automatic Update

When making the following changes to your app, you can then apply them to the published app using the automatic update feature:

  • Updating app pages with added or removed UI components
  • Adding new REST API services
  • Making changes to app navigation
  • Making changes to app logic (mapping, custom JavaScript).

Once you are done with the needed app updates, go to Export > Auto update.
Upon selecting Auto update, you will be provided with the option to confirm that you want to publish the app update:

At this point, the platform will start publishing the changes you've made. When ready, you will get notified:

Autoupdate successfulAutoupdate successful

Autoupdate successful

Now, the next time your end-user runs the app the changes made will be downloaded and the updates applied on the fly.

📘

Who Gets the Update?

Currently all the devices which have downloaded the app will get the update if an update is available and published. Currently, there is no option to push an update to a specific device.

Note that when the end-user launches your app and its update is available, it will be downloaded to the device automatically, so it’s important that the device has strong wireless or WiFi connection - with a weak connection, it will take longer to download the update.

🚧

Auto-updating of Projects with Deprecated Libraries Versions

To make sure the projects created under the deprecated libraries versions will continue getting automatic updates you should first make a backup of your working project, then upgrade to library 2.0 by enabling the Hot Code Push plug-in under the Settings tab. Now, you can export the binary .apk / [.aab](https://developer.android.com/guide/app-bundle) and/or .ipa file(s) for further publishing the updated project.

Please be aware that in some cases, a significant period of time is needed to push the updated code into the published app.

📘

All AngularJS apps support automatic updates.
If you’d like to add the automatic update feature to your old JQM project, you should switch your libraries version in App Settings > Resources.