Cordova DeviceInfo Plugin

This plugin contains various methods for retrieving miscellaneous device/app info.

Installation

Using the Cordova CLI

cordova plugins add org.cloudsky.cordovaplugins.deviceinfo

Usage

Get App ID

cloudSky.deviceInfo.getAppId(
    function (appId) {
        // Success callback.
        // `appId` is the package name on Android, bundle identifier on iOS,
        // `ProductId` on Windows.
    },
    function (err) {
        // Failure callback.
        // `err` is an error message.
    }
)

Get App Version Name

cloudSky.deviceInfo.getVersionName(
    function (versionName) {
        // Success callback.
        // `versionName` is the version name on Android (from the
        // AndroidManifest's <manifest> element, `android:versionName` attribute).
        // On iOS, this is the `CFBundleShortVersionString` value from the main
        // NSBundle.
        // On Windows, this is the version number built from components
        // <major>.<minor>.<build>.<revision> of the WinJS PackageId class
        // (https://msdn.microsoft.com/en-us/library/windows/apps/windows.applicationmodel.packageid.aspx#properties)
    },
    function (err) {
        // Failure callback.
        // `err` is an error message.
    }
)

Get Device Jailbreak/Root Status

Performs a simplistic check on whether the device is rooted or jailbroken.

cloudSky.deviceInfo.isHackedDevice(
    function (isHacked) {
        // Success callback.
        // `isHacked` is _truthy_ if the device is rooted/jailbroken, _falsy_
        // otherwise (meaning it can be true, false, 1, 0, ...).
        // NOTE: `isHacked` is always false on Windows - no checking is
        // performed on this platform...
    },
    function (err) {
        // Failure callback.
        // `err` is an error message.
    }
)

Get Devcie Jailbreak/Root detection details

Get details about jailbreak / root detection, i.e. which tests considered the device to be jailbroken / rooted, which tests did not detect anything.

cloudSky.deviceInfo.getHackDetectionDetails(
    function (details) {
        // NOTE: Android and iOS  have different sets of tests.
        for(var testName in details) {
            if(details[testName]) {
                console.log(testName + " was positive.")
            }
        }
    },
    function (err) {
        // Failure callback.
        // `err` is an error message.
    }
)

Troubleshooting

Android support library build error

If you get the following error when building on Android:

* What went wrong:
Execution failed for task ':processArmv7ReleaseManifest'.
> Manifest merger failed : Attribute meta-data#android.support.VERSION@value value=(26.0.0-alpha1) from [com.android.support:support-v4:26.0.0-alpha1] AndroidManifest.xml:27:9-38
  	is also present at [com.android.support:appcompat-v7:25.3.0] AndroidManifest.xml:27:9-31 value=(25.3.0).
  	Suggestion: add 'tools:replace="android:value"' to <meta-data> element at AndroidManifest.xml:25:5-27:41 to override.

Try adding this to your cordova/platforms/android/build.gradle file, replacing the useVersion with the ones you need:

dependencies {
    configurations.all {
        resolutionStrategy.eachDependency { DependencyResolveDetails details ->
            def requested = details.requested
            if (requested.group == 'com.android.support') {
                if (requested.name == 'appcompat-v7') {
                    details.useVersion '23.+'
                } else if (requested.name == 'support-v4') {
                    details.useVersion '26.+'
                } else if (requested.name == 'support-compat') {
                    details.useVersion '25.0.1'
                }
            }
        }
    }
}