Wondering what’s next for npm?Check out our public roadmap! »

    skwas-cordova-plugin-appinfo

    2.0.0 • Public • Published

    npm version

    skwas-cordova-plugin-appinfo

    Cordova Plugin to retrieve application information, like the App name, version, compile date and identifier. Additionally returns some device capabilities (which perhaps should be move to the device plugin).

    Installation

    cordova plugin add skwas-cordova-plugin-appinfo

    or for latest

    cordova plugin add https://github.com/skwasjer/skwas-cordova-plugin-appinfo.git

    Supported platforms

    Android 4.1 and higher
    iOS 8 and higher (tested with Xcode 7.2.3 and Xcode 8)
    Browser proxy (provided only for compatibility)

    Tested with Cordova 7 and higher.

    Usage

    This plugin defines a global appInfo object, which provides application properties. Although the object is in the global scope, it is not available until after the deviceready event.

    document.addEventListener("deviceready", onDeviceReady, false);
    function onDeviceReady() {
        console.log(appInfo.name);
    }

    Properties

    appInfo.name

    Type: String

    Gets the application name.

    Supported platforms

    • Android (manifest/application@android:label)
    • iOS (CFBundleName)

    appInfo.identifier

    Type: String

    Gets the application identifier.

    Supported platforms

    • Android (manifest/package)
    • iOS (CFBundleIdentifier)

    appInfo.version

    Type: String

    Gets the application version.

    Supported platforms

    • Android (manifest@android:versionName)
    • iOS (CFBundleShortVersionString)

    appInfo.build

    Type: String

    Gets the application build.

    Supported platforms

    • Android (manifest@android:versionCode)
    • iOS (CFBundleVersion)

    appInfo.compileDate

    Type: String

    Gets the datetime when the application was compiled.

    Supported platforms

    • Android
    • iOS

    Android quirks

    When compiling for debug, the compile date returns January 1, 1970. This is on purpose to avoid changes to BuildConfig triggering full rebuilds (and allowing faster Instant Run).

    appInfo.isHardwareAccelerated

    Type: Boolean

    Gets whether the application is using hardware acceleration.

    Supported platforms

    • Android, Honeycomb upwards
    • iOS will always return true

    appInfo.isDebuggable

    Type: Boolean

    Gets whether the application can be remotely debugged.

    Supported platforms

    • Android
    • iOS

    Changelog

    2.0.0

    • Android: since Gradle 2.2, files in APK's no longer have timestamps, thus breaking the compileDate property. Fixed by adding a property to BuildConfig at build time.

    1.0.1

    • Android: fix compile error when cordova-plugin-device is not installed

    1.0.0

    • Marking v1 since it is fairly stable and not changing much.
    • Android/iOS: added build and identifier.

    0.4.0

    • added Cordova 5.x support

    0.3.5

    • run plugin in background as per Cordova manual

    0.3.4

    • added iOS support

    0.3.2

    • Android support
    • first public release

    Install

    npm i skwas-cordova-plugin-appinfo

    DownloadsWeekly Downloads

    3

    Version

    2.0.0

    License

    MIT

    Unpacked Size

    22.2 kB

    Total Files

    11

    Last publish

    Collaborators

    • avatar