# Cordova AppVersion Plugin

This Cordova/PhoneGap plugin reads the version of your app from the target build settings.

* Repository: <https://github.com/whiteoctober/cordova-plugin-app-version>
* Plugin ID/package name: `cordova-plugin-app-version`
* Tested version: 0.1.11

{% hint style="info" %}
To check the third party Cordova plugins, you need to create a custom build debugger ([Android version](https://en.docs.monaca.io/products_guide/debugger/installation/debugger_android#build-and-install-a-custom-monaca-debugger) or [iOS version](https://en.docs.monaca.io/products_guide/debugger/installation/debugger_ios#building-a-custom-monaca-debugger)).
{% endhint %}

## Demo

[<img src="https://docs.monaca.io/images/common/import_img.png" alt="" data-size="line">Import AppVersion plugin demo to your Monaca account](https://monaca.mobi/ja/directimport?pid=64b7790be78885e97fd49611)

![](https://docs.monaca.io/images/samples/app_version.png)

## Enable the plugin in the Monaca IDE

1. From the IDE menu, go to **Config → Manage Cordova Plugins** .
2. Click the **Import Cordova Plugin** button. Then, choose to import the plugin using a ZIP file or a URL/package name.

## API references

This section describes some of the main functions used in our [demo](https://monaca.mobi/directimport?pid=5b29c488e78885f330dba6cf). For complete API references, please refer to the [repository](https://github.com/whiteoctober/cordova-plugin-app-version).

### getAppName()

Get the name of the app.

```javascript
cordova.getAppVersion.getAppName()
```

**Return Value**

* `Promise`

**Example**

```javascript
cordova.getAppVersion.getAppName(function (appName) {
    alert( appName );
});
```

### getPackageName()

Get the package name of the app.

```javascript
cordova.getAppVersion.getPackageName()
```

**Return Value**

* `Promise`

**Example**

```javascript
cordova.getAppVersion.getPackageName(function (packName) {
    alert( packageName );
});
```

### getVersionCode()

Get the build identifier of the app.

```javascript
cordova.getAppVersion.getVersionCode()
```

**Return Value**

* `Promise`

**Example**

```javascript
cordova.getAppVersion.getVersionCode(function (verCode) {
    alert( versionCode );
});
```

### alertVersionNum()

Get the version number of the app.

```javascript
cordova.getAppVersion.alertVersionNum()
```

**Return Value**

* `Promise`

**Example**

```javascript
cordova.getAppVersion.getVersionNumber(function (versionNum) {
    alert( versionNum );
});
```