Install & setup

There are a lot of packages you need to install to get Cordova up and running. Rather than trying to recreate thorough instructions here that will be out of date as soon as I click save, I’ll give you a checklist and links to the relevant setup guides.

Further documentation

Installation checklist:



Open a command prompt or Terminal, and type

$ sudo npm cache clean -f
$ sudo npm install -g n
$ sudo n stable
$ sudo npm install -g cordova
$ cordova -v

Java SE Development Kit 8

Android Studio

Android SDK

After installing the Android SDK, you must also install the packages for whatever API level you wish to target. It is recommended that you install the highest SDK version that your version of cordova-android supports (see Requirements and Support).

Open the Android SDK Manager (run sdkmanager from the terminal) and make sure the following are installed:


I didn’t have to install this manually. I think it came with Android Studio.

Set environment variables

Cordova’s CLI tools require some environment variables to be set in order to function correctly. The CLI will attempt to set these variables for you, but in certain cases you may need to set them manually. The following variables should be updated:

Set the JAVA_HOME environment variable to the location of your JDK installation

Set the ANDROID_HOME environment variable to the location of your Android SDK installation

It is also recommended that you add the Android SDK’s tools, tools/bin, and platform-tools directories to your PATH

Modify the ~/.bash_profile file. To set an environment variable, add a line that uses export like so (substitute the path with your local installation):

$ export ANDROID_HOME=/Development/android-sdk/

To update your PATH, add a line resembling the following (substitute the paths with your local Android SDK installation’s location):

$ export PATH=${PATH}:/Development/android-sdk/platform-tools:/Development/android-sdk/tools

Reload your terminal to see this change reflected or run the following command:

$ source ~/.bash_profile

These steps may vary depending on your installed version of Windows. Close and reopen any command prompt windows after making changes to see them reflected. Click on the Start menu in the lower-left corner of the desktop In the search bar, search for Environment Variables and select Edit the system Environment Variables from the options that appear. In the window that appears, click the Environment Variables button. To create a new environment variable: Click New… and enter the variable name and value To set your PATH: Select the PATH variable and press Edit. Add entries for the relevant locations to the PATH. For example (substitute the paths with your local Android SDK installation’s location):

C:\Users\[your user]\AppData\Local\Android\Sdk\platform-tools
C:\Users\[your user]\AppData\Local\Android\Sdk\tools

Sample Android app

Create new project

Verify your Node and Cordova install:

$ node -v
$ cordova -v

Terminal commands:

$ mkdir ~/projects/cordova.nfc-demo
$ cordova create nfc-demo 
$ cd nfc-demo
$ cordova platform add android
$ cordova platform ls

Example output:

Installed platforms:
  android 6.2.3

Terminal commands:

$ cordova requirements

Example output:

Requirements check results for android:
Java JDK: installed 1.8.0
Android SDK: installed true
Android target: installed android-25,android-23
Gradle: installed /Applications/Android

Terminal commands:

$ cordova plugin add phonegap-nfc
$ cordova plugin ls

Example output:

cordova-plugin-whitelist 1.3.3 "Whitelist"
phonegap-nfc 1.0.3 "NFC"

Fix Gradle for Java 8

As of 01.10.2018, the phonegap-nfc plugin has a bug that attempts to use Java 8 code with a Java 6 configuration. To fix, you need to edit the file platforms/android/build.gradle.

android {
    defaultConfig {
        jackOptions {
            enabled true
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8


        Customize this policy to fit your own app's needs. For more guidance, see:
        Some notes:
            * gap: is required only on iOS (when using UIWebView) and is needed for JS->native communication
            * is required only on Android and is needed for TalkBack to function properly
            * Disables use of inline scripts in order to mitigate risk of XSS vulnerabilities. To change this:
                * Enable inline JS: add 'unsafe-inline' to default-src
        <meta http-equiv="Content-Security-Policy" content="default-src 'self' data: gap: 'unsafe-eval'; style-src 'self' 'unsafe-inline'; media-src *; img-src 'self' data: content:;">
        <meta name="format-detection" content="telephone=no">
        <meta name="msapplication-tap-highlight" content="no">
        <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width">
        <link rel="stylesheet" type="text/css" href="css/index.css">
        <title>Hello World</title>
        <div class="app">
        <script type="text/javascript" src="cordova.js"></script>
        <script type="text/javascript" src="js/index.js"></script>


function toHexString(byteArray) {
  return {
    return ('0' + (byte & 0xFF).toString(16)).slice(-2);

function message( msg ) {
    document.querySelector(".app").innerHTML += "<p>"+msg+"</p>\n";

function onTagPresented(e) {
    if (e.tag) {
        var tagid = toHexString(;
        console.log("[tag id] "+tagid);
    } else {
        console.log("Error reading tag");
        message("Error reading tag");

function main() {
    if (typeof nfc !== 'undefined') { // NFC is enabled on our device
        message("[listener added]");
            function(){message("NDEF successful");}, 
            function(){message("non-NDEF successful");}, 
            function(){message("NDEF mime tags with type text/pg successful");},
    } else {
        message("nfc not enabled on this device");

document.addEventListener('deviceready', main, false);


(I cleaned out most of the default stuff that the “empty project” puts in and just used this)

body {
    font-family:'HelveticaNeue-Light', 'HelveticaNeue', Helvetica, Arial, sans-serif;

Build and run

On your phone:

$ cordova build android
$ cordova run android