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    

Custom Plugins

Adding a custom Cordova plugin.

Introduction

Appery.io enables you to import Cordova plugins for use in apps without the need for configuring additional source files.

Custom Cordova plugins are supported in the following app library versions:

  • jQuery Mobile library version 4.1 or higher.
  • Ionic/Bootstrap/AngularJS version 1.1 or higher.

App Version

Before you update to a new library version it's important ​that you create an app version so you can go back to it in case something doesn't work.

Importing Cordova Plugins from GitHub

Before the plugin can be used in your app, you need to import it to Appery.io. You can choose one of the two ways to do it:

Latest Plugin Version

We strongly recommend downloading the latest plugin version.

Important notice

Be informed that when creating an app with Cordova plugins it is important that the needed plugin be imported before you proceed with the app UI or create it from a backup.

Facebook Plugin Example

Please check how to import a custom Cordova plugin on the example of the Facebook Cordova plugin.

1. Importing from ZIP bundle

  • Go to the plugin GitHub page, for example, the official Facebook plugin in Apache Cordova/PhoneGap.
  • Here, click the Clone or download green button and select the Download ZIP option. ZIP archive with the plugin source files will be downloaded to your drive:
  • From the Appery.io dashboard, navigate to Resources > Cordova plugins and click the Import Cordova plugin button.
  • Under the ZIP bundle tab, click Choose file.
  • Select the ZIP archive you have just downloaded and click Import Plugin:

From now on, when you open your projects you’ll see this plug-in among the imported plug-ins:

2. Importing with Git URL

  • Go to the plugin GitHub page, for example, the official Facebook plugin in Apache Cordova/PhoneGap.
  • Click the green Clone or download button.
  • Click the button next to the text field to copy the plugin URL to clipboard:
  • From the Appery.io dashboard, navigate to Resources > Cordova plugins and click the Import Cordova plugin button.
  • Go to the From Git tab.
  • Paste the copied URL into the Repository URL field and enter master as the Repository branch name, as shown on the screenshot below:
  • Click Import plugin. Now, you should see the plugin on the Cordova plugins list.

Custom Plugin Permissions

A custom Cordova plugin permission can be managed by selecting the Permissions tab when viewing plugin details.

More Examples of Using Custom Plugins in Appery.io

Below are some examples of how custom plugins can be used in Appery.io projects.

  • Ionic 4 Document Scanner plugin
    The tutorial that shows how to build an Ionic 4 app, where you can use the Cordova Document Scanner plugin.

  • Ionic 4 Social Sharing plugin Tutorial
    This tutorial demonstrates how to build an Ionic 4 app, where you can use Cordova Social Sharing plugin to share links, images, and text messages out of the app on social platforms or by email.

  • Toast Plugin Example
    Check here for instructions on how to import and configure the Toast Cordova plugin in an Appery.io app.

  • Pollfish Plugin Example
    The blog post on how to add a Polish survey into your app: Appery.io + Pollfish: How to Integrate a Pollfish Survey into Your App.

  • BitPay App Example
    The sample app demonstrating how to add secure Bitcoin payments to your Appery.io mobile app with the BitPay Cordova SDK can be found here.

Testing Apps with Custom Plugin

To test the app, you must build the binary and launch the app on your device. Testing using the Appery.io Tester app won't work as the plugin is not available inside the Tester app.

Passing Parameters to Plugins

Some Cordova plugins require initialization parameters to work properly. The phonegap-facebook-plug-in, for example, requires APP_ID and APP_NAME variables to be specified.

Go to App settings > Cordova plugins and click the Options button next to the plugin. A modal window opens, where the necessary options can be added and specified. Click Save options.

Custom Cordova plugin parameters.

Custom Cordova plugin parameters.

Option Button Color

The Options buttons will change to dark blue when at least one parameter is set.

Stuff You Should Know

When working with plugin parameters:

  • You can add any number of key/value pairs to any Cordova plugin (core or custom).
  • Key/values options can be changed/deleted at any time.
  • Options for unselected plugins can be managed as well.
  • Keys should be unique to one plug-in (subject to validation).
  • For parameter names, the following symbols are allowed: all digits, letters, and an underscore or minus sign (subject to validation).
  • Empty keys/values are not allowed.
  • Parameter names are validated for duplication.

Quirks

There are several important issues when using Cordova plugins:

  • Uploading files larger than 40 Mb is not allowed.
  • Before uploading plugin .zip archive make sure it contains only plugin code (without any other files).
  • Plug-ins do not work for the Appery.io Tester.
  • Cordova and Cordova plug-ins can’t be updated with the Autoupdate feature.
  • When creating an app from the backup, re-adding custom plug-ins to the backup application is required as they are lost while building a backup.
  • Cordova plugins are not included under the Source tab in Project view.

More Help Resources

Here is a great resource to help you learn Cordova basics:

Help with Custom Plugins

Our support team is not able to provide help or debug assistance with 3rd party custom Cordova plugins. There are many reasons why a custom plugin might not work:

  • Incorrect configuration.
  • Incorrect version support.
  • Bugs in the plugin.

Our support team is just not familiar with all of the plugins out there.

Our Advisory Pack and Flex Pack support services do include help with custom Cordova plugins. Please consider purchasing one of the packs if you need help with a custom Cordova plugin.

Updated 3 days ago

Custom Plugins


Adding a custom Cordova plugin.

Suggested Edits are limited on API Reference Pages

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