@adobe/cordova-aepassurance

Adobe Experience Platform - AEP Assurance plugin for Cordova apps.

Usage no npm install needed!

<script type="module">
  import adobeCordovaAepassurance from 'https://cdn.skypack.dev/@adobe/cordova-aepassurance';
</script>

README

Adobe Experience Platform - Assurance plugin for Cordova apps

CI npm GitHub

Prerequisites

Cordova is distributed via Node Package Management (aka - npm).

In order to install and build Cordova applications you will need to have Node.js installed. Install Node.js.

Once Node.js is installed, you can install the Cordova framework from terminal:

sudo npm install -g cordova  

Installation

To start using the AEP SDK for Cordova, navigate to the directory of your Cordova app and install the plugin:

cordova plugin add https://github.com/adobe/cordova-aepassurance.git

Check out the documentation for help with APIs

Usage

Assurance

Getting the SDK version:
AEPAssurance.extensionVersion(function(version){  
  console.log(version);
}, function(error){  
  console.log(error);  
});
Registering the extension with ACPCore:

Note: It is required to initialize the SDK via native code inside your AppDelegate and MainApplication for iOS and Android respectively. For more information see how to initialize Griffon.

iOS
#import "AEPAssurance.h"  
[AEPAssurance registerExtension];
Android:
import com.adobe.marketing.mobile.Assurance;
Assurance.registerExtension();
Starting the Assurance session:
AEPAssurance.startSession(url, function(response) {  
  console.log("Success in starting AEPAssurance session");  
}, function(error){  
  console.log(error);  
});

Running Tests

Install cordova-paramedic https://github.com/apache/cordova-paramedic

npm install -g cordova-paramedic

Run the tests

cordova-paramedic --platform ios --plugin . --verbose
cordova-paramedic --platform android --plugin . --verbose

Sample App

A Cordova app for testing the Adobe SDK plugins is located at https://github.com/adobe/cordova-acpsample. The app is configured for both iOS and Android platforms.

Additional Cordova Plugins

Below is a list of additional Cordova plugins from the AEP SDK suite:

Extension GitHub npm
Core SDK https://github.com/adobe/cordova-acpcore npm
Adobe Analytics https://github.com/adobe/cordova-acpanalytics npm
Places https://github.com/adobe/cordova-acpplaces npm

Contributing

Looking to contribute to this project? Please review our Contributing guidelines prior to opening a pull request.

We look forward to working with you!

Licensing

This project is licensed under the Apache V2 License. See LICENSE for more information.