Documentation | Appery.io

The Appery.io Developer Hub

Welcome to the Apperyio developer hub. You'll find comprehensive guides and documentation to help you start working with apperyio as quickly as possible, as well as support if you get stuck. Let's jump right in!

Guides    

Automatic Updating

Auto update.

Appery.io has an automatic app update feature, this means you can update apps that users already have installed on the device without going through an app store. The automatic update is performed from the Export menu. It is optional for every project and is enabled by default.

Automatic updating is available for the following app versions:

  • AngularJS Ionic: library version 1.3 and higher.
  • JQM: library version 4.1 and higher.

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.

📘

Automatic Updating Setup

For this feature to be available in an app, you need to have this feature enabled and your end-user will need to install the app for the first time either from an app store or directly on the device. Also, your initial build must include Hot Code Push Plugin 1.6.7.

Using Automatic Update

When making changes to your app, you can automatically update:
Update pages by adding or removing UI components

  • Add new REST API services
  • Make changes to navigation
  • Make changes to app logic (mapping, custom JavaScript)

Once you have completed the desired updates go to Export > Auto update. Upon clicking the auto update button, 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 make. When all the changes are published, you will get notified:

Autoupdate successful

Now, the next time your end user runs the app the changes will be downloaded and functioning.

When the end user launches an app and update is available, two things are going to happen:

  • The update is downloaded to the device - it’s important that the device has strong wireless or WiFi connection. With weak connection, it will take longer to download the update.

📘

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.

Please note, that if you are using the latest Appery.io library, the Cordova Hot Code Push Plugin should be enabled in order for your application to display the autoupdate download indicator.

🚧

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 plugin under the Settings tab. Now, you can export the binary .apk 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.

Disabling Automatic Updates

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

🚧

Restrictions

  • Only web resources: HTML/JS/CSS can be updated.
  • Cordova core (installed by default) and 3rd party Cordova (installed by the developer) plugins can’t be updated with this feature.

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.

Updated 2 months ago

Automatic Updating


Auto update.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.