Reads the version of your app from the target build settings.

If you are using cordova-cli, install with:

cordova plugin add cordova-plugin-app-version

With a plain plugman, you should be able to install with something like:

plugman --platform <ios|android> --project <directory> --plugin https://github.com/whiteoctober/cordova-plugin-app-version.git

If you are using jQuery, AngularJS, WinJS or any Promise/A library (Bluebird), promise style is supported. Use something like:

cordova.getAppVersion.getVersionNumber().then(function (version) {
    $('.version').text(version);
});

If not, pass a callback function:

cordova.getAppVersion.getVersionNumber(function (version) {
    alert(version);
});

In addition to the version number you can also retrieve other details about your application:

Returns the name of the app. E.g. "My Awesome App"

Returns the package name of the app - the reversed domain name app identifier like com.example.myawesomeapp

Returns the build identifier of the app

Returns the version number of the app

Returns a custom property from app settings. This could be

• a "meta-data" element from an Android manifest file
• a custom element from an iOS Info.plist file
• a preference value from a Windows config.xml file

Can be used in combination with cordova-custom-config plugin. Example config.xml:

...
    <platform name="android">
        <config-file target="AndroidManifest.xml" parent="./application">
           <meta-data android:name="ENVIRONMENT" android:value="DEVELOPMENT" />
        </config-file>
    </platform>
    <platform name="ios">
        <config-file platform="ios" target="*-Info.plist" parent="ENVIRONMENT"><string>DEVELOPMENT</string></config-file>
    </platform>
    <platform name="windows">
        <preference name="ENVIRONMENT" value="DEVELOPMENT" />
    </platform>
    
    <platform name="browser">
        <meta-data ENVIRONMENT="DEVELOPMENT"/>
    </platform>
...

## Credits

Written by Robert (Jamie) Munro at White October

Various others have contributed fixes and new features. See the CHANGELOG.md for details.

Original code based on the following Stack Overflow posts:

• iOS
• Android

Kevin Iuretig merged two pull requests (browser platform support + getMetaData() feature)