# Cordova SDK

## Installation

### **NPM**

You can use [NPM](https://www.npmjs.com/package/@purchasely/cordova-plugin-purchasely) to install **Purchasely** by running this command in your project:

```bash
cordova plugin add @purchasely/cordova-plugin-purchasely
```

Don't forget to change the minimum OS versions to match Purchasely requirements (iOS 11 / Android 21)

### iOS Integration

You must have an iOS platform for your project. If it is not the case, you can simply add it with a cordova command :

```markup
cordova platform add ios
```

### Android Integration

#### Enable AndroidX

AndroidX is mandatory to display our paywalls, it is [deactivated by default](https://cordova.apache.org/announcements/2020/06/29/cordova-android-9.0.0.html). You can enable it easily by editing your config.xml file.

```markup
<platform name="android">
    <allow-intent href="market:*" />
    <preference name="AndroidXEnabled" value="true" />
</platform>
```

#### Add Android platform

You must have an Android platform for your project. If it is not the case, you can simply add it with a cordova command :

```markup
cordova platform add android
```

#### Add Stores dependencies

Our Cordova SDK does not contains a store to avoid unnecessary integrations. You have to specifically declare which stores you want. To add Android dependencies to your project, you need to create a file `platforms/android/app/build-extras.gradle`

Then you add the stores dependencies you wish to use.

{% tabs %}
{% tab title="build-extras.gradle" %}

```bash
dependencies {
    //Google Play Store
    implementation 'io.purchasely:google-play:2.8.0'
    
    //Amazon App Store
    implementation 'io.purchasely:amazon:2.8.0'
    
    //Huawei Mobile Services
    implementation 'io.purchasely:huawei-services:2.8.0'
}
```

{% endtab %}
{% endtabs %}

#### Huawei Integration

Huawei needs a little more configuration to work properly, to integrate Huawei Mobile Services, please refer to our Android documentation : <https://docs.purchasely.com/quick-start/sdk-installation/quick-start#huawei-mobile-services>