⚙️ Prerequisites for Integration – Cordova

Before integrating the REL-ID API SDK into your Cordova project, make sure your development environment and configurations meet the following requirements.

🧱 Project Environment

📱 Android Requirements

• Minimum SDK Version: 23
• Target SDK Version: 35
• Cordova Android Plugin Version:
  JSON

  "cordova-android": "^9.0.0"

• Jetpack Support: Required

🔌 Proxy Configuration (if needed)

If you're working behind a proxy:

• Set proxy in Android Studio via:
  File > Settings > System Settings > HTTP Proxy
• If proxy settings aren't working, manually set them in:

  ~/.gradle/gradle.properties

• Also configure proxy settings for:
  • npm
  • git

🍏 iOS Requirements

• Deployment Target: iOS 12.0 or higher
• Cordova iOS Plugin Version:
  JSON

  "cordova-ios": "^6.1.0"

🔐 SDK Artifacts & Info Required (From REL-ID Admin)

✅ Summary

Before starting integration:

• Ensure proper SDK versions for Android and iOS
• Confirm plugin versions are compatible
• Collect required files (Agent_info.txt, plugin folder) from Uniken
• Confirm access to REL-ID Gateway (IP/Hostname + Port)

⚙️ REL-ID SDK Installation Guide for Cordova

This guide walks through the installation of the REL-ID SDK in a Cordova project based on the official SDK integration documentation.

📁 1. Node Module Structure

You’ll find the following structure:

• api-sdk/ – iOS RELID.xcframework
• libs/ – Android .aar file
• src/ – Plugin source code for Android and iOS
• www/ – Contains RdnaClient.js (JavaScript bridge)
• plugin.xml, package.json, build-extras.gradle – Cordova config files

📦 2. Prerequisites

• Cordova version: 9.0.0 or higher
• cordova-android: ^9.0.0
• cordova-ios: ^6.1.0
• Android Studio (latest)
• Xcode 14.3+ (for iOS builds)
• Android SDK Version: 23+
• iOS Deployment Target: 13.0+

📥 3. Install the REL-ID Plugin

The Uniken team will provide RdnaClient.zip. Follow these steps:

Android

cordova platform add android

iOS

cordova platform add ios

Install the Plugin

cordova plugin add ./RdnaClient

🤖 4. Android Configuration

In android/app/build.gradle, within the defaultConfig block, add:

defaultConfig {
  ...
  packagingOptions {
    exclude '/lib/mips64/**'
    exclude '/lib/arm64-v8a/**'
    exclude '/lib/x86_64/**'
    exclude '/lib/x86/**'
    pickFirst '**/arm64-v8a/libc++_shared.so'
    pickFirst '**/armeabi-v7a/libc++_shared.so'
    pickFirst '**/x86/libc++_shared.so'
    pickFirst '**/x86_64/libc++_shared.so'
  }

  ndk {
    abiFilters 'x86', 'armeabi', 'armeabi-v7a', 'mips', 'x86_64', 'arm64-v8a'
  }
}

🍏 5. iOS Configuration

1. Unzip and add RELID.xcframework to your Xcode project.
2. In Xcode, go to File → Add Files to "YourProject".
3. Select RELID.xcframework, ensure "Copy items if needed" and "Create groups" are selected.
4. In General tab, set framework to "Embed & Sign".
5. In Build Phases, ensure the framework is listed under “Link Binary with Libraries”.

#import <RELID/RDNAStruct.h>
#import <RELID/RDNA.h>

Link required iOS frameworks:

• CoreTelephony
• LocalAuthentication

✅ You are now ready to build and run REL-ID SDK in your Cordova application!