Cordova SDK

Guide for integrating Purchasely SDK inside your Cordova app

Installation

NPM

You can use NPM to install Purchasely by running this command in your project:

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 :

cordova platform add ios

Android Integration

Enable AndroidX

AndroidX is mandatory to display our paywalls, it is deactivated by default. You can enable it easily by editing your config.xml file.

<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 :

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.

build-extras.gradle

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'
}

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