Native Android
⚙️ Prerequisites for Integration – Native Android
Before integrating the REL-ID API SDK into your Native Android application, ensure the following requirements are met.
🧱 Project Environment
Component | Requirement |
---|---|
Android Studio | Latest version recommended |
AGP Version | Supported: 7.1.x to 7.2.x |
Gradle Version | Compatible with AGP requirements |
📱 Android SDK Requirements
- Minimum SDK Version:
23
- Target SDK Version:
35
📂 Required Artifacts & Info from REL-ID Admin
Item | Description |
---|---|
Agent_info.txt | Binary file containing the application ID required for initialization |
REL-ID Gateway Info | Hostname/IP and Port number of the REL-ID Gateway |
REL-ID SDK | REL-ID_SDK.aar Android library provided by Uniken |
🤖 REL-ID SDK Installation Guide for Native Android
This guide outlines how to integrate the REL-ID SDK into a native Android project as per the REL-ID API SDK Integration v25.04.01 documentation.
📦 Prerequisites
- Android Studio (latest)
- Minimum SDK version: 23
- Target SDK version: 35
- Android Gradle Plugin (AGP) Version: 7.1.x to 7.2.x
- REL-ID SDK
.aar
file provided by Uniken
📥 Step-by-Step Installation
1. Add REL-ID_SDK.aar
REL-ID_SDK.aar
- Copy the
REL-ID_SDK.aar
file to the following location:
project-root/app/libs/REL-ID_SDK.aar
- In Android Studio:
- Go to
File > Project Structure > Dependencies
- Select your app module
- Click
+
and chooseJAR/AAR Dependency
- Browse to and select:
libs/REL-ID_SDK.aar
- Set configuration as:
implementation
- Click OK and Apply
- Go to
2. Add Repositories in settings.gradle
settings.gradle
For Android Studio Bumblebee and above, add this inside settings.gradle
:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
google()
mavenCentral()
jcenter() // (Deprecated soon)
// UNIKEN SDK Maven Repository
maven {
url "https://pkgs.dev.azure.com/managevm/REL-ID-Thirdparty-Repo/_packaging/library/maven/v1"
}
}
}
If you're using credential-based auth or proxy configuration, follow your org’s standards for Maven credentials.
3. Add Module-Level Dependencies
In app/build.gradle
, add the Uniken SDK dependency:
dependencies {
implementation("com.uniken.relid:engine:7.3.3") {
transitive = true
}
}
4. Add Packaging Options
To avoid .so
file conflicts, include the following in app/build.gradle
:
android {
...
packagingOptions {
pickFirst '**/arm64-v8a/libc++_shared.so'
pickFirst '**/armeabi-v7a/libc++_shared.so'
pickFirst '**/x86/libc++_shared.so'
pickFirst '**/x86_64/libc++_shared.so'
}
}
5. Add Permissions
The REL-ID API SDK and Mobile Threat Detection (MTD) modules require a predefined set of Android permissions to operate securely and effectively.
📂 Agent Info
Place the Agent_info.txt
file (provided by Uniken) into your assets/
folder or load it as needed. This file contains application-specific identity data required during initialization.
✅ You’re now ready to initialize and integrate the REL-ID SDK in your native Android application!
Updated 2 months ago