@adobe/cordova-acpgriffon

Adobe Experience Platform - Project Griffon plugin for Cordova apps.

Usage no npm install needed!

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

README

Adobe Experience Platform - Griffon 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-acpgriffon.git

Check out the documentation for help with APIs

Usage

Griffon

Getting the SDK version:
ACPGriffon.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 "ACPGriffon.h"  
[ACPGriffon registerExtension];
Android:
import com.adobe.marketing.mobile.Griffon;
Griffon.registerExtension();
Starting the Griffon session:
ACPGriffon.startSession(url, function(response) {  
  console.log("Success in starting Griffon 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.