Search docs/

Ionic Native Setup

Contents

In order to use the Ionic Native plugins, there's just a few quick steps.

Create an App in the Ionic Hub

First, log into the Ionic Hub, then navigate to the Native Plugins Keys page.

Click Assign to App, then New App. Enter a name, then click Create App.

Hover over a Native Plugin Key, then click to copy it to your clipboard:

test

Next, open up a terminal on your computer.

Install Tooling

Ensure that you have the latest Ionic CLI installed:

npm install -g ionic@latest

Next, install the Ionic Enterprise Cordova CLI (even if you're using Capacitor). Ionic Native plugins use scoped packages, which the regular Cordova CLI does not support. All Cordova functionality will still work as expected.

npm uninstall -g cordova npm install -g @ionic-enterprise/cordova

The Ionic Enterprise Cordova CLI should be installed on each developer's machine. This is also true for any development build servers that you may use.

Setup the Ionic App Locally

Sign into your Ionic Account using the same login info as the Ionic Hub:

ionic login

Next, create a local Ionic app. Follow the prompts to name the app, pick your preferred JavaScript framework, then choose the "blank" template.

ionic start

Register Your Product Key

Change directory into the Ionic app project folder, then register the product key to this app. When prompted, paste in the Product Key value previously copied from the Ionic Hub:

cd myApp ionic enterprise register

This only needs to be run once per app. Within the app's directory, a .npmrc file is generated and ionic.config.json updated. Both of these changes should be committed to version control so that CI/CD systems as well as other team members can restore the plugins from a fresh clone of the app's repository.

Start Using Plugins

Now you are able to install any of the Ionic Native plugins that you have access to by following the instructions on each plugin's documentation page.

Cordova

ionic cordova plugin add @ionic-enterprise/plugin-name

Capacitor

npm install @ionic-enterprise/plugin-name npx cap sync

That's it! Time to add Ionic Native plugins to your app. There's lots to choose from, including authentication, biometric security, offline storage, or one of the common device features.

After you've added a plugin or two, continue building your app using Ionic Framework UI components.