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

1. 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>

2. 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

3. Add Google dependency

Google is not provided by default as you have a choice on Android To add Google as a store, you can use our Cordova plugin

cordova plugin add @purchasely/cordova-plugin-puchasely-google

This dependency version must always match @purchasely/cordova-plugin-purchasely version Be very careful to always update both at the same time

Huawei Mobile Services

Other Stores dependencies

Our Cordova SDK does not contains other stores 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 {
    //Amazon App Store
    implementation 'io.purchasely:amazon:4.2.0'
    
    //Huawei Mobile Services
    implementation 'io.purchasely:huawei-services:4.2.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