MobbSign Cordova: Getting started

Introduction

Mobbsign can be integrated easily with any Cordova project and Ionic projects using Cordova as native framework.

Requirementes

License

A license key bounded to your application is needed to start using the SDK. Please, contact us to obtain one.

Cordova

  • Cordova >= 7

Ionic

Cordova should be the native framework of your Ionic project, Capacitor is not supported at the moment. The plugin works with Angular and React project types.

Node

  • Node 10.*
  • npm > 6.9.0
  • An NPM auth token is needed to access our repositories. If you do not have one, please contact us. Please be aware that this token is not related to the MobbSing license required to be used with the SDK.

NOTE: Several versions of Node can be installed in the same machine using nvm. Once it is installed you can install Node 10 by executing the following:

$ nvm install 10
$ nvm use 10

Warning!: If you are using Cordova >= 10, you need these versions: Node 16.* npm > 7

Tooling

  • wget
  • unzip

Operating System

Currently Windows is not supported, however a Windows Subsystem for Linux could be installed in Windows 10.

Installation

  1. Add the following line in your .npmrc file in the root of your project (if it does not exist, just create it empty):

    //registry.npmjs.org/:_authToken=the-provided-token

  2. Add the following line to the project config.xml file:

    <plugin name="com.mobbeel.mobbsign" spec="npm:@mobbeel/mobbsign-cordova-plugin@^1.1.1"/>

Or, if you are using Cordova >= 10 add the following line instead:

<plugin name="com.mobbeel.mobbsign" spec="@mobbeel/mobbsign-cordova-plugin@^1.1.1"/>

  1. Type the following in the root of your Cordova project:

    WARNING: This step will take several minutes, because it downloads the Android and iOS SDKs. If you have any problem, you can view the Troubleshooting.

$ npx cordova prepare
$ npx ionic cordova prepare
  1. To confirm your installation, type the following in your Cordova project:
$ npx cordova plugin list
$ npx ionic cordova plugin list

The Mobbsign plugin should appear like this (version can vary):

com.mobbeel.mobbsign 1.1.1 "MobbSign"
Capacitor integration →