- Prerequisites
- Installation
- Usage
- Running Tests
- Sample App
- Additional Cordova Plugins
- Contributing
- Licensing
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
To start using the Analytics plugin for Cordova, navigate to the directory of your Cordova app and install the plugin:
cordova plugin add cordova-acpanalytics-fork
Check out the documentation for help with APIs
ACPAnalytics.extensionVersion(function(version){
console.log(version);
}, function(error){
console.log(error);
});
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 Core.
#import "ACPAnalytics.h"
[ACPAnalytics registerExtension];
import com.adobe.marketing.mobile.Analytics;
Analytics.registerExtension();
ACPAnalytics.getTrackingIdentifier(function(trackingId) {
console.log(trackingId);
}, function(error){
console.log(error);
});
ACPAnalytics.sendQueuedHits(function(response){
console.log("Success in sendQueuedHits");
}, function(error){
console.log(error);
});
ACPAnalytics.getQueueSize(function(size) {
console.log(size);
}, function(error){
console.log(error);
});
ACPAnalytics.clearQueue(function(response){
console.log("Success in clearing queue");
}, function(error){
console.log(error);
});
ACPAnalytics.setVisitorIdentifier(customVisitorId, function(response) {
console.log("Success in setting visitor Id with " + customVisitorId);
}, function(error){
console.log(error);
});
ACPAnalytics.getVisitorIdentifier(function(visitorId) {
console.log(visitorId);
}, function(error){
console.log(error);
});
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
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.
Below is a list of additional Cordova plugins from the AEP SDK suite:
Extension | GitHub | npm |
---|---|---|
Core SDK | https://github.com/adobe/cordova-acpcore | |
Places | https://github.com/adobe/cordova-acpplaces | |
Project Griffon (Beta) | https://github.com/adobe/cordova-acpgriffon |
Looking to contribute to this project? Please review our Contributing guidelines prior to opening a pull request.
We look forward to working with you!
This project is licensed under the Apache V2 License. See LICENSE for more information.