iOS

1. Podfile update
If you're already using Cocoapods, goto ios folder from your project and specify the pod below on a single line inside your target block in a Podfile
``sh
pod 'react-native-axa-mobile-sdk', path: '../node_modules/react-native-axa-mobile-sdk'
`
Then, run the following command using the command prompt from the ios folder of your project
`sh
pod install
`
2. Download the xxx_camdo.plist file and add it to your project target









Android

Follow these steps to integrate the Gradle App Bundle Plugin with your Android Project.
1. Create /cadxapmsdk folder. This is the SDK root folder.
2. Download the CAAppBundle_SDK.zip file and extract the contents to the SDK root.
3. Download the .plist. Prefer it to be copied to the SDK root folder.
4. Import and add the 'ca-maa-android-sdk-release.aar' file as a dependency.
5. Update the build.gradle file(s).
- Project Level
- Add maven url 'https://packages.broadcom.com/apm-agents' under repositories and classpath 'com.ca.dxapm:sdk-gradle-plugin:' under dependencies of the project level build.gradle file.
- App Level
- Add apply plugin: com.ca.dxapm.sdk.gradle.plugin at the top of the app build.gradle file.
- Add cadxapmsdk configuration block, specifying the absolute path to the downloaded plist.
- Add dependency to SDK.
6. Update AndroidManifest.xml file. Add the following permissions, if not already present.
`sh




`
For more information, see https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/app-experience-analytics-saas/SaaS/configuring/collect-data-from-android-applications/Native-Android-Wrapping.html






1. In XCode, in the project navigator, right click Libraries ➜ Add Files to [your project's name]
2. Go to node_modules ➜ react-native-axa-mobile-sdk and add ReactNativeAxaMobileSdk.xcodeproj
3. In XCode, in the project navigator, select your project. Add libReactNativeAxaMobileSdk.a to your project's Build Phases ➜ Link Binary With Libraries
4. Run your project (Cmd+R)<

5. Podfile update

If you're already using Cocoapods, goto ios folder from your project and specify the below pod on a single line inside your target block in a Podfile

`
pod 'react-native-axa-mobile-sdk', path: '../node_modules/react-native-axa-mobile-sdk'
`

Then, run the following command using the command prompt from the ios folder of your project

`
pod install
`

6. Drag & Drop the downloaded xxx_camdo.plist file into the Supporting files


1. Open up android/app/src/main/java/[...]/MainActivity.java
- Add import com.reactlibrary.ReactNativeAxaMobileSdkPackage; to the imports at the top of the file
- Add new ReactNativeAxaMobileSdkPackage() to the list returned by the getPackages() method
2. Append the following lines to android/settings.gradle:
`
include ':react-native-axa-mobile-sdk'
project(':react-native-axa-mobile-sdk').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-axa-mobile-sdk/android')
`
3. Insert the following lines inside the dependencies block in android/app/build.gradle:
`
compile project(':react-native-test-sdk')
`





iOS




Objective C

1. Add the import header #import "CAMDOReporter.h" to your AppDelegate.m file
2. Initialize the CAMobileAppAnalytics sdk in didFinishLaunchingWithOptions: method
`sh
- (BOOL)application:(UIApplication )application didFinishLaunchingWithOptions:(NSDictionary )launchOptions
{
[CAMDOReporter initializeSDKWithOptions:SDKLogLevelVerbose completionHandler:nil];
return YES;
}
`
3. Save and re-build your project












Swift

1. Add a header file with the file name format as -Bridging-header.h.

2. Add the import header #import "CAMDOReporter.h" to your -Bridging-header.h file.

3. Add the -Bridging-header.h file to Swift Compiler - Code Generation section in the Build Settings.
/-Bridging-header.h

4. Initialize the CAMobileAppAnalytics sdk in didFinishLaunchingWithOptions method
`sh
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
//Initialize CA App Experience Analytics SDK
CAMDOReporter.initializeSDK(options: SDKOptions.SDKLogLevelVerbose) { (completed, error) in

}
return true
}
`
5. Save and re-build your project








`javascript
AXASDK.disableSDK();
`


`javascript
AXASDK.enableSDK();
`


`javascript
AXASDK.isSDKEnabled((isEnabled) => {
if (isEnabled) {
// enabled action
} else {
// non-enabled action
}
console.log(SDK is enabled: ${isEnabled});
})
`


`javascript
AXASDK.getDeviceId((deviceId) => {
if (deviceId) {
console.log(received device id: ${deviceId});
}
})
`


`javascript
AXASDK.getCustomerId((customerId) => {
if (customerId) {
console.log(received customer id: ${customerId});
}
})
`


`javascript
var customerId = "New Customer"

AXASDK.setCustomerId(customerId, (SDKError) => {
switch (SDKError) {
case ErrorNone:
console.log(CustomerId set successfully.);
break;
case ErrorNoTransactionName:
case ErrorTransactionInProgress:
case ErrorFailedToTakeScreenshot:
case ErrorInvalidValuesPassed:
default:
console.log(Error setting customer Id: ${SDKError});
}
})
`

#### SDKError Values
- ErrorNone
- ErrorNoTransactionName
- ErrorTransactionInProgress
- ErrorFailedToTakeScreenshot
- ErrorInvalidValuesPassed

To retrieve these constants include the following code prior to use:
`javascript
const AXASDK = NativeModules.ReactNativeAxaMobileSdk;

// Set constants for SDKError
const { ErrorNone } = AXASDK.getConstants();
const { ErrorNoTransactionName } = AXASDK.getConstants();
const { ErrorTransactionInProgress } = AXASDK.getConstants();
const { ErrorFailedToTakeScreenshot } = AXASDK.getConstants();
const { ErrorInvalidValuesPassed } = AXASDK.getConstants();
`

`javascript
var attributeName = "ClientDemo";
var attributeValue = "NewFeatures";

AXASDK.setSessionAttribute(attributeName, attributeValue, (SDKError) => {
switch (SDKError) {
case ErrorNone:
console.log(Session attribute ${attributeName}=${attributeValue} set successfully.);
break;
case ErrorNoTransactionName:
case ErrorTransactionInProgress:
case ErrorFailedToTakeScreenshot:
case ErrorInvalidValuesPassed:
default:
console.log(Error setting session attribute: SDKError:${SDKError});
}
})
`

#### SDKError Values
- ErrorNone
- ErrorNoTransactionName
- ErrorTransactionInProgress
- ErrorFailedToTakeScreenshot
- ErrorInvalidValuesPassed

To retrieve these constants include the following code prior to use:
`javascript
const AXASDK = NativeModules.ReactNativeAxaMobileSdk;

// Set constants for SDKError
const { ErrorNone } = AXASDK.getConstants();
const { ErrorNoTransactionName } = AXASDK.getConstants();
const { ErrorTransactionInProgress } = AXASDK.getConstants();
const { ErrorFailedToTakeScreenshot } = AXASDK.getConstants();
const { ErrorInvalidValuesPassed } = AXASDK.getConstants();
`

`javascript
AXASDK.enterPrivateZone();
`


`javascript
AXASDK.exitPrivateZone();
`


`javascript
AXASDK.isInPrivateZone((inPrivateZone) => {
if (inPrivateZone) {
// private zone action
} else {
// non-private zone action
}
console.log(SDK is in private zone: ${inPrivateZone});
})
`


`javascript
AXASDK.getAPMHeader((headers) => {
if (headers) {
console.log(received apm headers: ${headers});
// TOTO: show how to access values in this dictionary
// using values, keys, or entries
//
for (const [key, value] of Object.entries(headers)) {
console.log(${key}: ${value});
}

}
})
`


`javascript
var newAPMData = "PrivateKey=PrivateInfo";

AXASDK.addToAPMHeader(newAPMData);
`


`javascript
var pinningMode = CAMDOSSLPinningModeFingerPrintSHA1Signature;
var pinnedValues = [--array of SHA1 fingerprint values--];

AXASDK.setSSLPinningMode(pinningMode, pinnedValues);
`

####Supported pinning modes:
`javascript
- CAMDOSSLPinningModePublicKey OR CAMDOSSLPinningModeCertificate
- array of certificate data (NSData from SeccertificateRef)
- or, certificate files(.cer) to be present in the resource bundle
- CAMDOSSLPinningModeFingerPrintSHA1Signature
- array of SHA1 fingerprint values
- CAMDOSSLPinningModePublicKeyHash
- array of PublicKeyHashValues
`


`javascript
AXASDK.stopCurrentSession();
`


`javascript
AXASDK.startNewSession();
`


`javascript
AXASDK.stopCurrentAndStartNewSession();
`


`javascript
var transactionName = "subscription";
var serviceName = "MyApp"";
// serviceName may also be null

AXASDK.startApplicationTransaction(transactionName, serviceName, (completed, errorString) => {
if (completed) {
// everything is fine
console.log(*transaction ${transactionName} started (${completed}) ${errorString});
} else {
if (errorString) {
// process error message
console.log(*transaction error: ${errorString})
}
}
})
`


`javascript
var transactionName = "subscription";
var failureString = "Mismatched Arguments";
// failureString may also be null

AXASDK.stopApplicationTransaction(transactionName, failureString, (completed, errorString) => {
if (completed) {
// everything is fine
console.log(*transaction ${transactionName} stopped (${completed}) ${errorString});
} else {
if (errorString) {
// process error message
console.log(error stopping transaction: ${errorString})
}
}
})
`


`javascript
var feedback = "something interesting happened";
AXASDK.setCustomerFeedback(feedback);
`


`javascript
var postalCode = "95200";
var countryCode = "US";
AXASDK.setCustomerLocation(postalCode, countryCode);
`


`javascript
var screenName = "My custom Screen";
var imageQuality = CAMAA_SCREENSHOT_QUALITY_MEDIUM;

AXASDK.sendScreenShot(screenName, imageQuality, (completed, errorString) => {
if (completed) {
// everything is fine
console.log(*screen shot sent (${completed}) ${errorString});
} else {
if (errorString) {
// process error message
console.log(error sending screen shot: ${errorString})
}
}
})
`

#### imageQuality values
The following values for imageQuality are defined:
- CAMAA_SCREENSHOT_QUALITY_HIGH
- CAMAA_SCREENSHOT_QUALITY_MEDIUM
- CAMAA_SCREENSHOT_QUALITY_LOW
- CAMAA_SCREENSHOT_QUALITY_DEFAULT

To retrieve these constants include the following code prior to use:
`javascript
const AXASDK = NativeModules.ReactNativeAxaMobileSdk;

// Set constants for CAMAA_SCREENSHOT_QUALITY
const { CAMAA_SCREENSHOT_QUALITY_HIGH } = AXASDK.getConstants();
const { CAMAA_SCREENSHOT_QUALITY_MEDIUM } = AXASDK.getConstants();
const { CAMAA_SCREENSHOT_QUALITY_LOW } = AXASDK.getConstants();
const { CAMAA_SCREENSHOT_QUALITY_DEFAULT } = AXASDK.getConstants();
`


`javascript
var viewName = "my custom view";
var loadTime = 237;

AXASDK.viewLoaded(viewName, loadTime, (completed, errorString) => {
if (completed) {
// everything is fine
console.log(*view load recorded (${completed}) ${errorString});
} else {
if (errorString) {
// process error message
console.log(error recording view load: ${errorString})
}
}
})
`


`javascript
var viewName = "view1";

AXASDK.ignoreView(viewName);
`


`javascript
var viewNames = ["view1", "view2", ..., "viewN"];

AXASDK.ignoreViews(viewNames);
`


`javascript
AXASDK.isScreenshotPolicyEnabled((isEnabled) => {
if (isEnabled) {
// enabled action
} else {
// non-enabled action
}
console.log(Screenshots enabled by policy: ${isEnabled});
})
`


`javascript
var url = "https://myserver/specific_content/";"
var status = "OK";"
var responseTime = 234;
var inBytes = 864200;
var outBytes = 6236;

AXASDK.logNetworkEvent( url, status, responseTime, inBytes, outBytes, (completed, errorString) => {
if (completed) {
// everything is fine
console.log(*network event logged (${completed}) ${errorString});
} else {
if (errorString) {
// process error message
console.log(error logging network event: ${errorString})
}
}
})
`


`javascript
var textMetricName = "ImageName";
var textMetricValue = "Pretty Picture";
var attributes = null;

AXASDK.logTextMetric( textMetricName, textMetricValue, attributes, (completed, errorString) => {
if (completed) {
// everything is fine
console.log(*text metric logged (${completed}) ${errorString});
} else {
if (errorString) {
// process error message
console.log(error logging text metric: ${errorString})
}
}
})
`


`javascript
var numericMetricName = "ImageWidth";
var numericMetricValue = 1080;
// if numericMetricValue is a string, remember to use
// parseFloat(numericMetricValue) or Number(numericMetricValue)
var attributes = null;

AXASDK.logNumericMetric( numericMetricName, numericMetricValue, attributes, (completed, errorString) => {
if (completed) {
// everything is fine
console.log(*numeric metric logged(${completed}) ${errorString});
} else {
if (errorString) {
// process error message
console.log(error logging numeric metric: ${errorString})
}
}
})
`


errorString is empty if the API call is completed, otherwise is a localized error description
`javascript
AXASDK.uploadEvents((response, errorString) => {
if (errorString) {
// process error message
console.log(error: ${errorString})
} else {
var events=response.CAMDOTotalUploadedEvents;
var key=response.CAMDOResponseKey;
console.log(*uploaded ${events} events (key:${key}));
}
})
`


`javascript
import Platform from react;

if (Platform.OS == "ios") {
AXASDK.setNSURLSessionDelegate(delegate);
}
`


`javascript
import Platform from react;

if (Platform.OS == "ios") {
// use iOS specific location setting call
var latitude = 34.678;
var longitude = -122.456;
AXASDK.setLocation(latitude, longitude);
} else {
// use Android specific location setting call
}
`


`javascript
import Platform from react;

if (Platform.OS == "ios") {
AXASDK.enableScreenShots(true);
// or
AXASDK.enableScreenShots(false);
}
`


`javascript
import Platform from react;

if (Platform.OS == "ios") {
var viewName = "my custom view";"
var loadTime = 237;

AXASDK.viewLoadedWithoutScreenCapture(viewName, loadTime, (completed, errorString) => {
if (completed) {
// everything is fine
console.log(*view load recorded (${completed}) ${errorString});
} else {
if (errorString) {
// process error message
console.log(error recording view load: ${errorString})
}
}
})
}
`