Native iOS

⚙️ Prerequisites for Integration – Native iOS

Before integrating the REL-ID API SDK into your Native iOS application, ensure your development environment meets the following requirements.


🧱 Project Environment

ComponentRequirement
XcodeVersion 14.3 or higher
iOS Deployment TargetMinimum 12.0
Architectures Supportedarm64, x86_64 (No Bitcode)

📂 Required Artifacts & Info from REL-ID Admin

ItemDescription
Agent_info.txtContains the application ID in binary format for SDK initialization
REL-ID Gateway InfoHostname/IP and Port number of the REL-ID Gateway server
REL-ID SDKRELID.xcframework provided by Uniken for integration

⚠️ Additional Configuration

  • Make sure the Objective-C bridging header is set up correctly if you are using Swift.
  • Required system frameworks (automatically linked by REL-ID SDK when used):
    • CoreTelephony
    • CoreLocation
    • LocalAuthentication
  • Add -ObjC and -lresolv to your Other Linker Flags under Build Settings.

✅ Summary

  • Use the correct RELID.xcframework provided by Uniken.
  • Add necessary iOS permissions in your Info.plist file.
  • Ensure compatibility with iOS 12.0+ and supported architectures.

🍏 REL-ID SDK Installation Guide for Native iOS

This guide outlines the integration of the REL-ID SDK in a native iOS application as per the v25.04.01 integration manual.


📦 Prerequisites

  • Xcode: 14.3 or higher
  • Deployment target: iOS 13.0+
  • Architectures supported: arm64, x86_64
  • SDK: RELID.xcframework
  • No Bitcode support

🔧 Setup Steps

1. Obtain SDK

Obtain RELID.xcframework.zip from the Uniken team and unzip it.

2. Add Framework to Xcode

  • Drag and drop RELID.xcframework into your Xcode project (preferably into the “Frameworks” group).
  • Ensure you check:
    • ✅ “Copy items if needed”
    • ✅ “Create groups”

3. Embed & Link the Framework

  • In your project settingstargetGeneral tab:
    • Under Frameworks, Libraries, and Embedded Content, select Embed & Sign for RELID.xcframework.
  • In Build Phases tab:
    • Confirm RELID.xcframework is listed under “Link Binary with Libraries”. If not, click ➕ and add it.

🛠 Required iOS Frameworks

Ensure the following system frameworks are linked:

  • CoreTelephony.framework
  • LocalAuthentication.framework

These may auto-link once REL-ID APIs are referenced.


🧷 Linker Flags Configuration

Go to Build SettingsLinking → Other Linker Flags, and add:

-ObjC
-lresolv

🔁 Importing in Code

For Objective-C:

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

🧠 Swift Integration

To use REL-ID in a Swift project, configure a bridging header.

a. Create a Bridging Header

Create: YourProjectName-Bridging-Header.h and add:

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

b. Reference It in Build Settings

  • Navigate to Build Settings → Swift Compiler – General
  • Set Objective-C Bridging Header to the path of your header file (e.g., MyApp/MyApp-Bridging-Header.h)

📋 Info.plist Permissions

To enable the full functionality of the REL-ID SDK—including identity verification, biometric authentication, geolocation-based risk analysis, and local network verification—your iOS app must declare specific permissions in the Info.plist file.


📂 Agent Info

You will also need to integrate the Agent_info.txt binary configuration provided by Uniken. This file contains your application’s identity and must be embedded in your project.


✅ You are now ready to initialize and use REL-ID in your native iOS project.


What’s Next