⚙️ Prerequisites for Integration – Flutter

Ensure the following prerequisites are met before integrating the REL-ID API SDK into your Flutter project:

🧱 Project Environment

📱 Android Requirements

• Minimum SDK Version: 23 or higher
• Target SDK Version: 35
• AGP (Android Gradle Plugin) Version:
  • Current: 7.4
  • Supported Range: 7.3.0 to 7.4.2

🍏 iOS Requirements

• Xcode Version: 14.3 or higher
• Deployment Target: iOS 12.0 or above
• Architectures Supported: arm64 and x86_64 only
  (Bitcode is not supported)

🔐 Info Required from REL-ID Admin

• Connection Profile (Agent_info.txt):
  Contains the application ID in binary format — required during initialization.

• Gateway Server Details:

  • Hostname/IP
  • Port number where the REL-ID gateway is hosted

• REL-ID Flutter Plugin folder provided by Uniken

⚙️ REL-ID SDK Installation Guide for Flutter

This guide outlines how to install and configure the REL-ID Flutter plugin in your application project.

1. 📦 Prerequisites

• Flutter (latest stable version recommended)
• Dart tools and dev tools v3.0.* and v2.23.* (or newer stable versions)
• Android Studio (latest)
• Xcode (14.3+) for iOS builds
• Minimum Android SDK version: 23
• iOS Deployment Target: 13+

📁 2. Plugin Structure

Extract rdna_client.zip — this will include:

• libs/ – Dart APIs (rdna_client.dart, rdna_struct.dart)
• android/ – Android platform code
• ios/ – iOS platform code
• pubspec.yaml – Package metadata
• Rdna_client.iml – Module/project metadata

📥 3. Installing the REL-ID Flutter Plugin

The Uniken team will provide a zip file rdna_client.zip. Place the extracted folder in your project root:

3.1. Add Plugin to Flutter App

Move the rdna_client folder to your project root and reference it in pubspec.yaml:

dependencies:
  flutter:
    sdk: flutter
  rdna_client:
    path: rdna_client

Run:

flutter pub get

3.2. Add Plugin to Flutter App

Move the rdna_client folder to your project root and reference it in pubspec.yaml:

dependencies:
  flutter:
    sdk: flutter
  rdna_client:
    path: rdna_client

🤖 3 Android Configuration

To avoid compatibility issues, add the following to android/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'
  }
}

🍏 iOS Configuration

Ensure your iOS app has:

• Minimum Deployment Target: 13.0
• Required permissions set in Info.plist
• Product name set correctly in target Build Settings

Run CocoaPods install in the iOS directory:

cd ios 
pod install 
cd ..

📋 Android & iOS Permissions

Refer to the “Required permissions for Android and iOS” section in the SDK documentation to include the necessary permissions.

✅ You are now ready to initialize and use the REL-ID SDK in Flutter!